Nexus is a workflow orchestration platform for multi-agent systems with shared memory, durable execution state, and production-friendly messaging contracts.
The project is intentionally scoped to one concrete workflow: an automated research pipeline where a planner, researcher, writer, and verifier collaborate over shared execution state.
- JSON Schema contracts for workflow graphs, workflow executions, and inter-agent messages.
- A Python validator that rejects invalid graphs before runtime.
- A workflow execution state machine with valid transitions.
- A Python workflow orchestrator that validates topology, creates executions, acquires Redis leases, and publishes task assignments to NATS JetStream.
- A Python agent worker that consumes task assignments, applies idempotency checks, runs tools through a sandbox, and publishes task results.
- OpenTelemetry helpers, a DLQ monitor, and local observability stack manifests for traces and alerting.
- ADRs covering the message broker choice, the orchestrator language selection, and the tool execution security model.
- Docker Compose infrastructure for PostgreSQL, Redis, NATS, Tempo, Prometheus, Grafana, and the OTel Collector.
- A Makefile with useful local commands.
- Start the infrastructure with
make up. - Run the validation suite with
make test. - Inspect the contracts in
schemas/and the design notes indocs/. - Open Grafana at
http://localhost:3000withadmin/adminif you start the observability stack.
The platform is not a generic agent framework. It is designed around a single product-shaped workflow so the contracts stay simple, debuggable, and useful in production.