Skip to main content

Python Orchestrator Starter

Goals

  • Typed contract validation at runtime
  • Adapter support for LangGraph and CrewAI Python ecosystems
  • Unified gate engine and run-ledger persistence

Starter setup

  1. Initialize Python project and add JSON schema validation dependency.
  2. Implement contract loader and validator.
  3. Add hook middleware for pre/post checks.
  4. Add gate engine with pass/fail/conditional outcomes.

Minimal interfaces

class AgentContract(TypedDict):
agent_id: str
allowed_tools: list[str]
required_gates: list[str]

Required references

  • templates/schemas/*.schema.json
  • reference-implementations/orchestration/mcp-adoption-guide.md
  • reference-implementations/examples/e2e-feature-flow-langgraph.md
  • reference-implementations/starter-repos/assets/python/