AgentCanvas

This is the v2 developer site — a hand-built HTML reorganisation of the MkDocs site at docs-site/. v2 leans on HTML idioms (cards, collapsible "how" blocks, SVG diagrams, in-page navigation strips) to make the content more navigable than its markdown source. v1 stays at docs-site/ until v2 is feature-complete.

§1Developer Guide / Core

The project's load-bearing docs — what the platform is, how it's wired, the decisions behind it, and what's open. Start here if you're new.

Blueprint

What AgentCanvas is, the seven capabilities, design principles, core components, differentiation.

core/blueprint.html

Architecture

System diagram, data flow, execution engines, component system, tech stack.

core/architecture.html

Codebase Map

Per-package file walkthrough — where each piece of code lives and what it owns.

core/codebase-map.html

Glossary

Load-bearing terms, grouped by subsystem — searchable / filterable in v2.

core/glossary.html

Roadmap

Open work — maintenance TODO, features, env integrations, method ports.

core/roadmap.html

Decisions (ADRs)

Eight fields × ~5 ADRs each — load-bearing architectural decisions with context, alternatives, rationale.

core/decisions/

§2Developer Guide / Capabilities

The seven things AgentCanvas does, each with an implementation page covering the mechanism, key files, and current status. The conceptual claim is in blueprint; these pages show how each capability is actually implemented.

All 7 capabilities →

Graph-Expressible Agents · Customizable Node System · Isolated Runtime Environments · Nested Graph System · Graph Execution Engine · Real-Time Observability · Hook System.

capabilities/

Start at #1

Graph-Expressible Agents — DAG / loop / mixed on one canvas — is the foundational capability the others build on. Pages are linked prev/next so you can read straight through.

capabilities/<page>.html

§3Developer Guide / Design Docs

Deep-dive references for AgentCanvas developers — internal system specs, subsystem walkthroughs, and frank support-status inventories. Read on demand when you're building or debugging the relevant piece.

All 15 design docs →

Canvas / Graph / Wire Types / Graph Executor / State Containers / Loop Control / Server Mode / Env Panels / LLM Config / Execution Logs / Batch Eval / VLN·VLA·EQA Support Status / Coding-Agent Backend Surface.

design-docs/

Most-read entry points

Canvas System · Graph System · Graph Executor · State Containers · Wire Types

design-docs/<page>.html

§4Developer Guide / NodeSets

NodeSets

Reference docs for the 13 bundled NodeSets — env (Habitat, MP3D, LIBERO, SIMPLER, HM3D), perception/tool, and method nodesets.

nodesets/

§5Developer Guide / Meta

Getting set up and contributing.

Getting Started

First-run install + smoke test.

getting-started/

Community

Channels, contribution norms, code of conduct.

community/

§6Status & scope

Every section of docs-site/docs/ is now mirrored in v2 as HTML.

Section	v1 (docs-site/)	v2 (here)
developer-guide/core	✅ markdown	✅ 56 pages — 6 main + 8 field indexes + 37 ADRs (hand-written for shape)
developer-guide/capabilities	✅ markdown	✅ 8 pages — 7 capability pages + hub (numbered, prev/next linked)
developer-guide/design-docs	✅ markdown	✅ 16 pages — 15 docs + hub (generated)
developer-guide/nodesets	✅ markdown	✅ 13 pages
developer-guide/getting-started	✅ markdown	✅ 1 page
developer-guide/community	✅ markdown	✅ 1 page

§7How to view

# Direct open
xdg-open docs-site-v2/index.html         # Linux
open docs-site-v2/index.html              # macOS

# Or serve (recommended — some browsers block local fetch / relative anchors)
python -m http.server 8092 --directory docs-site-v2
# → http://127.0.0.1:8092/