Quick Start

Get DuraGraph running locally and execute your first workflow.

Prerequisites

• Docker and Docker Compose
• Git
• Task (optional, for convenience commands)

1. Start DuraGraph

Clone and start all services:

git clone https://github.com/Duragraph/duragraph.git
cd duragraph
task up

This starts:

• API Server (port 8081) — REST API and SSE streaming
• PostgreSQL — Event store and projections
• NATS JetStream — Event streaming
• Dashboard (port 3000) — Workflow monitoring UI

Verify services are running:

task health

2. Create Your First Workflow

Create an assistant:

curl -X POST http://localhost:8081/api/v1/assistants \
  -H "Content-Type: application/json" \
  -d '{"name": "hello-assistant", "graph_schema": {}}'

Create a thread:

curl -X POST http://localhost:8081/api/v1/threads \
  -H "Content-Type: application/json" \
  -d '{}'

Create a run (replace <thread_id> and <assistant_id> with values from above):

curl -X POST http://localhost:8081/api/v1/runs \
  -H "Content-Type: application/json" \
  -d '{
    "thread_id": "<thread_id>",
    "assistant_id": "<assistant_id>",
    "input": {"message": "Hello!"}
  }'

3. Monitor Your Workflow

Open the Dashboard at http://localhost:3000 to:

• View workflow execution logs
• Monitor run status in real-time
• Debug failed runs
• Explore workflow graphs

4. Stream Events

Subscribe to real-time updates for a run:

curl -N "http://localhost:8081/api/v1/stream?run_id=<run_id>"

Next Steps

• Self-Hosted Installation — Production deployment
• First Workflow Tutorial — Build a complete workflow
• LangGraph Migration — Migrate from LangGraph Cloud
• Architecture Overview — Understand the system design

Troubleshooting

Services won’t start?

# Check service status
docker compose ps

# View logs
docker compose logs api

Port already in use?

# Find what's using the port
lsof -i :8081

# Stop all services and restart
task down && task up

Need help? Join our community or report an issue.