How anshulreddybuilds/aion-axon works
AION AXON is a governed agent platform: it plans and executes missions through a controlled capability registry, and when a capability is missing, SYNAPSE researches, generates, screens, tests, and evaluates one before Guardian policy and human approval can allow installation. Missions can resume after approval. The API and React dashboard expose mission progress, capability evidence, approvals, monitoring, and audit history. The README documents the acquisition sequence; some internal wiring is inferred only where the SOURCE INDEX names the relationship, so unsampled details are omitted.
Main entry points: engine.py SYNAPSE loop · orchestrator.py Tool orchestrator · api.py API service · guardian.py Policy guardian
Components 24
Mission execution
- Mission planner
app/agents/mission_planner.py - Mission lifecycle
app/missions/service.py - Step executor
app/missions/engine.py - Tool orchestrator
app/workflows/orchestrator.py - Workflow state
app/workflows/state.py
Capability acquisition
- SYNAPSE loop
app/synapse/engine.py - Capability research
app/tools/web_research.py - Code generation
app/synapse/generator.py - AST safety screen
app/synapse/safety_screen.py - Isolated sandbox
sandbox/main.py - Independent evaluator
app/synapse/evaluator.py
Governance and evidence
- Policy guardian
app/governance/guardian.py - Human approval
app/governance/approval.py - Autonomy ledger
app/governance/autonomy_ledger.py - Kill switch
app/governance/kill_switch.py - Red-team security
app/beastmode/red_team.py
Capability runtime
- Capability registry
app/capabilities/registry.py - Firestore persistence
app/memory/firestore_store.py - Background monitors
app/monitors/service.py
API and dashboard
- API service
app/api.py - React dashboard
web/src/App.jsx - Dashboard API client
web/src/api.js - Acquisition stage view
web/src/livePipeline.js
Other components
- Owner
Connections 31
- Owner → API service: submits requests
README.md - API service → Mission lifecycle: routes missions
app/api.py - Mission lifecycle → Mission planner: plans mission
app/missions/service.py - Mission lifecycle → Step executor: runs or resumes
app/missions/service.py - Step executor → Tool orchestrator: delegates steps
app/missions/engine.py - Tool orchestrator → Workflow state: updates state
app/workflows/orchestrator.py - Step executor → SYNAPSE loop: signals capability gap
- SYNAPSE loop → Capability research: researches approach
app/synapse/engine.py - SYNAPSE loop → Code generation: generates candidate
app/synapse/engine.py - SYNAPSE loop → AST safety screen: screens candidate
app/synapse/engine.py - SYNAPSE loop → Isolated sandbox: tests candidate
README.md - SYNAPSE loop → Independent evaluator: requests scoring
app/synapse/engine.py - SYNAPSE loop → Policy guardian: checks policy
app/synapse/engine.py - SYNAPSE loop → Human approval: requests decision
app/synapse/engine.py - Owner → Human approval: approves or rejects
README.md - Human approval → Firestore persistence: stores decision
app/governance/approval.py - SYNAPSE loop → Capability registry: installs capability
app/synapse/engine.py - SYNAPSE loop → Autonomy ledger: records evolution
app/synapse/engine.py - SYNAPSE loop → Kill switch: checks halt state
app/synapse/engine.py - Policy guardian → Autonomy ledger: checks autonomy
app/governance/guardian.py - Tool orchestrator → Capability registry: resolves capability
app/workflows/orchestrator.py - Tool orchestrator → Policy guardian: gates execution
app/workflows/orchestrator.py - Tool orchestrator → Human approval: handles approval
app/workflows/orchestrator.py - Background monitors → Tool orchestrator: executes scheduled checks
app/monitors/service.py - API service → Firestore persistence: reads and writes records
app/api.py - API service → Background monitors: serves monitor operations
app/api.py - Red-team security → Policy guardian: red-team references
app/beastmode/red_team.py - Red-team security → AST safety screen: tests screening
app/beastmode/red_team.py - React dashboard → Dashboard API client: loads dashboard data
web/src/App.jsx - Dashboard API client → API service: calls backend
- React dashboard → Acquisition stage view: renders acquisition stages