# PyAgent > PyAgent: a spec-driven architecture for orchestrating multi-agent systems — YAML blueprints, 18 orchestration patterns, three-tier memory, and OTel tracing PyAgent is a spec-driven architecture for orchestrating multi-agent systems — 18 named design patterns (also published as structured JSON at /patterns.json), four independent architecture pillars (Blueprint, Execution & Routing, Context & Memory, Observability), every package's full capability surface as structured JSON at /capabilities.json, and a Cookbook of 37 complete, runnable multi-agent orchestration examples across all 21 domains. ## Docs - [Adapters](https://pyagent.org/api/adapters/index.md) - [API & Hooks Bibliography](https://pyagent.org/api/bibliography/index.md) - [API](https://pyagent.org/api/blueprint/index.md) - [API](https://pyagent.org/api/compress/index.md) - [API](https://pyagent.org/api/context/index.md) - [API](https://pyagent.org/api/providers/index.md) - [API](https://pyagent.org/api/router/index.md) - [API](https://pyagent.org/api/studio/index.md) - [API](https://pyagent.org/api/trace/index.md) - [Advanced](https://pyagent.org/api/patterns/advanced/index.md) - [Base Classes](https://pyagent.org/api/patterns/base/index.md) - [Composition, Guardrails & Recovery](https://pyagent.org/api/patterns/composition-safety/index.md) - [Orchestration](https://pyagent.org/api/patterns/orchestration/index.md) - [Resolution](https://pyagent.org/api/patterns/resolution/index.md) - [Structural](https://pyagent.org/api/patterns/structural/index.md) - [Hooks Guide](https://pyagent.org/guides/hooks/index.md) - [Guide](https://pyagent.org/guides/router/index.md) - [Guide](https://pyagent.org/guides/providers/index.md) - [Guide](https://pyagent.org/guides/compression/index.md) - [Guide](https://pyagent.org/guides/context/index.md) - [Package](https://pyagent.org/packages/router/index.md) - [Package](https://pyagent.org/packages/providers/index.md) - [Package](https://pyagent.org/packages/compress/index.md) - [Package](https://pyagent.org/packages/context/index.md) ## Blueprint (Spec-Driven) - [Overview](https://pyagent.org/architecture/blueprint/index.md) - [Specification](https://pyagent.org/architecture/blueprint-specification/index.md) - [Guide](https://pyagent.org/guides/blueprint/index.md) - [Package](https://pyagent.org/packages/blueprint/index.md) - [Agents](https://pyagent.org/packages/blueprint/agents/index.md) - [CLI](https://pyagent.org/packages/blueprint/cli/index.md) - [Python API](https://pyagent.org/packages/blueprint/compiler/index.md) - [Context Config](https://pyagent.org/packages/blueprint/context/index.md) - [Contracts & Observability](https://pyagent.org/packages/blueprint/contracts/index.md) - [Providers Config](https://pyagent.org/packages/blueprint/providers/index.md) - [Spec Format](https://pyagent.org/packages/blueprint/spec-format/index.md) - [Workflows](https://pyagent.org/packages/blueprint/workflows/index.md) ## Design Patterns - [Overview](https://pyagent.org/packages/patterns/index.md) - [Human-in-the-Loop](https://pyagent.org/packages/patterns/advanced/human-in-the-loop/index.md) - [ReAct](https://pyagent.org/packages/patterns/advanced/react/index.md) - [Swarm](https://pyagent.org/packages/patterns/advanced/swarm/index.md) - [Talker-Reasoner](https://pyagent.org/packages/patterns/advanced/talker-reasoner/index.md) - [Fan-Out / Fan-In](https://pyagent.org/packages/patterns/orchestration/fan-out-fan-in/index.md) - [Hierarchical](https://pyagent.org/packages/patterns/orchestration/hierarchical/index.md) - [Orchestrator-Workers](https://pyagent.org/packages/patterns/orchestration/orchestrator-workers/index.md) - [Pipeline](https://pyagent.org/packages/patterns/orchestration/pipeline/index.md) - [Supervisor](https://pyagent.org/packages/patterns/orchestration/supervisor/index.md) - [Cross-Reflection](https://pyagent.org/packages/patterns/resolution/cross-reflection/index.md) - [Debate](https://pyagent.org/packages/patterns/resolution/debate/index.md) - [Evaluator-Optimizer](https://pyagent.org/packages/patterns/resolution/evaluator-optimizer/index.md) - [Self-Reflection](https://pyagent.org/packages/patterns/resolution/self-reflection/index.md) - [Voting](https://pyagent.org/packages/patterns/resolution/voting/index.md) - [Blackboard](https://pyagent.org/packages/patterns/structural/blackboard/index.md) - [Layered](https://pyagent.org/packages/patterns/structural/layered/index.md) - [Role-Based](https://pyagent.org/packages/patterns/structural/role-based/index.md) - [Topology](https://pyagent.org/packages/patterns/structural/topology/index.md) - [Composition](https://pyagent.org/guides/composition/index.md) - [Guardrails](https://pyagent.org/guides/guardrails/index.md) - [Recovery](https://pyagent.org/guides/recovery/index.md) ## Observability - [Overview](https://pyagent.org/architecture/observability/index.md) - [Guide](https://pyagent.org/guides/tracing/index.md) - [Guide](https://pyagent.org/guides/studio/index.md) - [Package](https://pyagent.org/packages/trace/index.md) - [Overview](https://pyagent.org/packages/studio/index.md) - [CLI](https://pyagent.org/packages/studio/cli/index.md) - [Dashboard](https://pyagent.org/packages/studio/dashboard/index.md) - [Services](https://pyagent.org/packages/studio/services/index.md) - [Traces](https://pyagent.org/packages/studio/traces/index.md) ## Why PyAgent - [Quickstart](https://pyagent.org/getting-started/index.md) - [Core Concepts](https://pyagent.org/getting-started/core-concepts/index.md) - [About](https://pyagent.org/about/index.md) - [Architecture Overview](https://pyagent.org/architecture/index.md) - [Overview](https://pyagent.org/why-blueprint/index.md) - [vs. AutoGen](https://pyagent.org/compare/vs-autogen/index.md) - [vs. CrewAI](https://pyagent.org/compare/vs-crewai/index.md) - [vs. Dapr Agents](https://pyagent.org/compare/vs-dapr-agents/index.md) - [vs. LangGraph](https://pyagent.org/compare/vs-langgraph/index.md) - [vs. Microsoft Agent Framework](https://pyagent.org/compare/vs-microsoft-agent-framework/index.md) - [vs. Pydantic AI](https://pyagent.org/compare/vs-pydantic-ai/index.md) - [Essay: Kubernetes for agent orchestration](https://pyagent.org/essays/kubernetes-for-agent-orchestration/index.md) - [What is an agent blueprint?](https://pyagent.org/concepts/agent-blueprint/index.md) - [What is multi-agent orchestration?](https://pyagent.org/concepts/multi-agent-orchestration/index.md) - [Overview](https://pyagent.org/architecture/decisions/index.md) - [Memory Tier Selection](https://pyagent.org/architecture/decisions/memory-tier-selection/index.md) - [Pipeline vs. Supervisor](https://pyagent.org/architecture/decisions/pipeline-vs-supervisor/index.md) - [Spec-First vs. Code-First](https://pyagent.org/architecture/decisions/spec-first-vs-code-first/index.md) - [Supervisor vs. Orchestrator-Workers](https://pyagent.org/architecture/decisions/supervisor-vs-orchestrator-workers/index.md) - [When Blueprint Is Justified](https://pyagent.org/architecture/decisions/when-blueprint-is-justified/index.md) - [Capability Catalog](https://pyagent.org/capabilities/index.md) - [Benchmarks](https://pyagent.org/benchmarks/index.md) - [Contributing](https://pyagent.org/contributing/index.md) ## Cookbook - [Overview](https://pyagent.org/cookbook/index.md) - [CI/CD Validation & Diff](https://pyagent.org/cookbook/blueprint-ops/ci-cd-validation/index.md) - [Contract Testing with MockLLM](https://pyagent.org/cookbook/blueprint-ops/contract-testing/index.md) - [Declaring Governance in YAML](https://pyagent.org/cookbook/blueprint-ops/governance-in-yaml/index.md) - [Customer Onboarding Workflow](https://pyagent.org/cookbook/customer-support/onboarding/index.md) - [Support Router](https://pyagent.org/cookbook/customer-support/support-router/index.md) - [Analytics Task Decomposer](https://pyagent.org/cookbook/data-analytics/analytics-decomposer/index.md) - [SQL Analyst](https://pyagent.org/cookbook/data-analytics/sql-analyst/index.md) - [Incident Triage](https://pyagent.org/cookbook/devops-sre/incident-triage/index.md) - [Product Launch Planner](https://pyagent.org/cookbook/ecommerce-retail/product-launch-planner/index.md) - [Essay Grading by Consensus](https://pyagent.org/cookbook/education/essay-grader/index.md) - [AML Transaction Monitoring](https://pyagent.org/cookbook/finance-trading/aml-monitoring/index.md) - [Earnings Call Analyzer](https://pyagent.org/cookbook/finance-trading/earnings-call/index.md) - [ESG Report Analyzer](https://pyagent.org/cookbook/finance-trading/esg-analyzer/index.md) - [Loan Origination Workflow](https://pyagent.org/cookbook/finance-trading/loan-origination/index.md) - [Loan Underwriting Committee](https://pyagent.org/cookbook/finance-trading/loan-underwriting/index.md) - [Portfolio Review](https://pyagent.org/cookbook/finance-trading/portfolio-review/index.md) - [Robo-Advisor Onboarding](https://pyagent.org/cookbook/finance-trading/robo-advisor/index.md) - [Trading Signal Desk](https://pyagent.org/cookbook/finance-trading/trading-signals/index.md) - [Wealth Rebalancing Crew](https://pyagent.org/cookbook/finance-trading/wealth-rebalancing/index.md) - [Emergent NPC World](https://pyagent.org/cookbook/gaming/npc-world/index.md) - [Policy Briefing Pipeline](https://pyagent.org/cookbook/government/policy-briefing/index.md) - [Clinical Summary](https://pyagent.org/cookbook/healthcare/clinical-summary/index.md) - [CV Screener](https://pyagent.org/cookbook/hr-recruiting/cv-screener/index.md) - [Regulatory Compliance Checker](https://pyagent.org/cookbook/legal-compliance/compliance-checker/index.md) - [Contract Review](https://pyagent.org/cookbook/legal-compliance/contract-review/index.md) - [Campaign Planner](https://pyagent.org/cookbook/marketing-content/campaign-planner/index.md) - [Writers' Room](https://pyagent.org/cookbook/media-entertainment/writers-room/index.md) - [Property Valuation Stack](https://pyagent.org/cookbook/real-estate/property-valuation/index.md) - [Literature Review Team](https://pyagent.org/cookbook/research-analysis/literature-review/index.md) - [Research Assistant](https://pyagent.org/cookbook/research-analysis/research-assistant/index.md) - [Lead Qualifier](https://pyagent.org/cookbook/sales-crm/lead-qualifier/index.md) - [Peer-Review Mesh](https://pyagent.org/cookbook/scientific/peer-review/index.md) - [Fraud Investigation Assistant](https://pyagent.org/cookbook/security/fraud-investigation/index.md) - [Alert Triage](https://pyagent.org/cookbook/security/log-triage/index.md) - [Code Review](https://pyagent.org/cookbook/software-engineering/code-review/index.md) - [Software Startup Simulation](https://pyagent.org/cookbook/software-engineering/startup-simulation/index.md) - [Trip-Planning Swarm](https://pyagent.org/cookbook/travel-hospitality/trip-planner/index.md)