How astracreates/astra works
Astra is an AI company-building platform: a founder submits an objective, the backend creates a durable run, plans and dispatches specialist work, streams progress, and records outcomes and artifacts. Separate product branches provide persistent company operations, knowledge retrieval, deployable agent stacks, and visual automations. The README documents both legacy and Temporal run paths; excerpts show selected storage, event, and task behavior, so unshown implementation links are omitted or cited only where documented.
Main entry points: start_run.py Run initialization · specialists Specialist agents · events.py Progress events · SessionView.tsx Astra workspace
Components 24
Founder experience
- Astra workspace
frontend/components/SessionView.tsx - Product API
backend/api/routes.py
Run execution
- Run initialization
backend/control_plane/start_run.py - Run planner
backend/core/orchestrator.py - Durable workflows
backend/control_plane/temporal/workflows.py - Specialist agents
backend/specialists - Agent tools
backend/tools
Company operations
- Company operating layer
backend/company_os.py - Company work dispatch
backend/company_os_dispatch.py - Routing copilot
backend/company_os_copilot.py - Research missions
backend/missions/goal_engine.py
Product capabilities
- Company Brain
backend/tools/company_brain.py - Agent Stack
backend/stacks/compiler.py - Visual automations
backend/tools/automation_runtime.py - Custom agents
backend/custom_agents/runner.py - Library and artifacts
backend/library/store.py - Deployments
backend/deployments/store.py - MCP interface
backend/astra_mcp.py
Durability and controls
- Progress events
backend/core/events.py - Session store
backend/core/session_store.py - Run records
backend/control_plane/supabase_repositories.py - Approval controls
backend/approval_workflows.py - Credits and billing
backend/credits/store.py
Other components
- Founder
Connections 26
- Founder → Astra workspace: submits goal
- Astra workspace → Product API: requests work
- Product API → Run initialization: creates run
backend/api/routes.py - Run initialization → Run planner: starts planning
- Run initialization → Durable workflows: selects workflow
- Run planner → Specialist agents: dispatches tasks
- Specialist agents → Agent tools: use tools
backend/specialists/sales_pipeline.py - Run planner → Progress events: publishes progress
- Durable workflows → Progress events: streams progress
- Progress events → Astra workspace: streams updates
- Progress events → Session store: persists events
backend/core/events.py - Run initialization → Run records: records run
backend/control_plane/start_run.py - Founder → Routing copilot: sends message
- Routing copilot → Company work dispatch: routes work
- Company work dispatch → Company operating layer: updates company state
- Company operating layer → Astra workspace: shows company state
- Research missions → Company Brain: gathers evidence
backend/missions/goal_engine.py - Specialist agents → Company Brain: queries context
- Founder → Agent Stack: defines outcome
- Founder → Visual automations: builds flows
- Founder → Custom agents: defines agents
- Specialist agents → Library and artifacts: creates deliverables
- Agent tools → Deployments: deploys work
- Specialist agents → Approval controls: requests approval
- Run initialization → Credits and billing: accounts credits
backend/control_plane/start_run.py - Founder → MCP interface: submits goals