Start Here

This is the shortest path to understanding the project.

What To Learn First

You only need five ideas to become productive:

1. A graph is made of nodes and edges.
2. AgentNode does work.
3. ToolNode, ContextNode, and PromptNode are attached to an agent through edges.
4. GraphExecutor runs the graph.
5. GraphApp is the easiest way to build your first graph.

Recommended Learning Path

1. Read the builder example in README.md
2. Follow Your First Graph
3. Pick a model setup in Choose a Backend
4. Learn debugging in Observability
5. Open the browser debugger in Visualizer Web UI

Stay Out Of Advanced Docs At First

Skip these until you already have a working graph:

• docs/advanced-configuration.md
• docs/batch-execution.md
• docs/long-running-workflows.md
• API_REFERENCE.md

Those docs are useful, but they are for production workflows and extension work, not first-run success.