> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dagraph.app/llms.txt
> Use this file to discover all available pages before exploring further.

# dagraph: Workflow-as-Code for AI agents

> dagraph runs YAML-defined DAGs of parallel LLM calls across 7 providers, with HITL gates and deterministic replay. Version workflows in git.

dagraph turns your AI workflows into plain YAML files that you version in git, review in PRs, and run from the CLI or trigger via webhook. Define a graph of agent calls, code execution steps, and human approval gates — dagraph runs parallel nodes automatically, retries on provider errors, and checkpoints every step so you can resume after a crash.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Run your first parallel agent workflow in under 5 minutes.
  </Card>

  <Card title="Node Types" icon="diagram-project" href="/concepts/node-types">
    Learn all 10 node types: agent, evaluator\_loop, map, planner, and more.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli/overview">
    Full reference for every `agentgraph` command.
  </Card>

  <Card title="Multi-Provider" icon="shuffle" href="/guides/multi-provider-fallback">
    Configure fallback chains so workflows survive provider outages.
  </Card>
</CardGroup>

## Why dagraph

Most AI workflow tools lock automations inside a UI. dagraph treats the YAML file as the source of truth — you own your workflows, can diff them in pull requests, and deploy them through your existing CI pipeline.

<CardGroup cols={3}>
  <Card title="Parallel by default" icon="bolt">
    Nodes with no dependencies run simultaneously. A 3-researcher + synthesizer DAG fires all three researchers at once.
  </Card>

  <Card title="Provider-agnostic" icon="cloud">
    Claude, OpenAI, Gemini, Bedrock, and Ollama all work. Set a fallback chain per node and survive any outage.
  </Card>

  <Card title="Crash-safe" icon="shield-check">
    Every node status change is checkpointed to SQLite. Resume a paused or interrupted run without re-running completed nodes.
  </Card>
</CardGroup>

## Get started

<Steps>
  <Step title="Install dagraph">
    ```bash theme={null}
    pip install dagraph
    ```
  </Step>

  <Step title="Write a workflow">
    Create a YAML file that defines your agents and their dependencies.
  </Step>

  <Step title="Run it">
    ```bash theme={null}
    agentgraph run my-workflow.yaml --input topic="quantum computing"
    ```
  </Step>

  <Step title="Inspect results">
    ```bash theme={null}
    agentgraph inspect <run_id>
    ```
  </Step>
</Steps>

<Note>
  The default backend uses the `claude` CLI and your Claude Code plan — no API key required to get started.
</Note>