How coder1317/aria works
ARIA is a local-first autonomous engineering assistant. A terminal user or Telegram message enters the Brain orchestrator, which selects research, market, build, improve, or runtime work; build requests progress through architecture, code generation, review/security checks, debugging, tests, and project delivery. Separate branches provide deployment, persistent background tasks, API access, scheduling, and proactive event-driven actions. The tree and excerpts establish several calls directly; README-documented features with unsampled internals are shown at their supported enclosing paths, without speculative wiring.
Main entry points: orchestrator.py Brain orchestrator · engineering.py Engineering pipeline · research.py Research agent · tool_registry.py Tool registry
Components 34
User entry
- CLI
ultra/cli.py - Brain orchestrator
ultra/orchestrator.py - Intent routing
ultra/intent.py
Agent workflows
- Research agent
ultra/agents/research.py - Market agent
ultra/agents/market.py - Engineering pipeline
ultra/agents/engineering.py - Architecture planning
ultra/agents/architect.py - Code generation
ultra/agents/coder.py - Code review
ultra/agents/reviewer.py - Issue repair
ultra/agents/debugger.py - Test execution
ultra/agents/tester.py - Build evaluation
ultra/evaluator.py - Deployment generation
ultra/agents/deployer.py - Skill extraction
ultra/agents/trainer.py
Runtime and memory
- Provider pool
ultra/provider_pool.py - Background task queue
ultra/task_manager.py - Plan-act runtime
ultra/core/runtime.py - Tool registry
ultra/core/tool_registry.py - Memory and skills
ultra/core/memory.py - Vector store
ultra/core/vectors.py - Event bus
ultra/core/events.py - Event policies
ultra/core/policy_engine.py - File watchers
ultra/core/watchers.py - Goal manager
ultra/core/goals.py
Channels and integrations
- Telegram adapter
ultra/channels/telegram.py - Local Ollama
ultra/llm.py - Web search and fetch
ultra/tools/researcher.py - Built-in tools
ultra/tools - MCP client
ultra/tools/mcp_client.py - Notifications
ultra/core/notifications.py
Security and operations
- Security scanning
ultra/security.py - Audit log
ultra/audit.py
Other components
- Terminal user
- Telegram user
Connections 36
- Terminal user → CLI: submits request
- Telegram user → Telegram adapter: sends message
- Telegram adapter → Brain orchestrator: dispatches message
- CLI → Brain orchestrator: dispatches request
- Brain orchestrator → Intent routing: classifies intent
- Brain orchestrator → Provider pool: requests model work
- Provider pool → Local Ollama: routes locally
- Brain orchestrator → Research agent: dispatches research
- Research agent → Web search and fetch: searches and fetches
- Research agent → Provider pool: synthesizes report
- Brain orchestrator → Market agent: dispatches analysis
- Brain orchestrator → Engineering pipeline: starts build
- Engineering pipeline → Architecture planning: plans project
- Engineering pipeline → Code generation: generates files
- Engineering pipeline → Code review: reviews code
- Engineering pipeline → Security scanning: scans generated code
- Engineering pipeline → Issue repair: repairs issues
- Engineering pipeline → Test execution: runs tests
- Brain orchestrator → Build evaluation: scores build
- Brain orchestrator → Deployment generation: dispatches deployment
- Brain orchestrator → Skill extraction: extracts skills
- Brain orchestrator → Background task queue: submits background work
- Background task queue → Brain orchestrator: runs registered handlers
- Brain orchestrator → Plan-act runtime: creates and runs plan
- Plan-act runtime → Tool registry: executes tool calls
- Tool registry → Built-in tools: dispatches tools
- Tool registry → MCP client: invokes external tools
- Brain orchestrator → Memory and skills: reads and updates
- Brain orchestrator → Vector store: uses embeddings
- File watchers → Event bus: emits file events
- Event bus → Event policies: dispatches events
- Event policies → Background task queue: submits event tasks
- Event policies → Notifications: sends alerts
- Goal manager → Event bus: publishes goal events
- Brain orchestrator → Audit log: records operations
- Brain orchestrator → Notifications: sends updates