How ayushman-311214/aetheros works
AetherOS is a desktop-oriented AI assistant runtime: users can interact through a command-line interface or voice, while agent and LLM components support tool-based work across desktop, browser, and vision capabilities. The desktop automation engine runs workflows through the tool execution layer and verifies results; desktop services also expose process, window, and application operations. The tree documents HUD, observability, and event subsystems as additional product capabilities. No README was provided, and several connections are shown only by source-index references, so the graph avoids inferring a complete end-to-end runtime sequence.
Main entry points: agent.py Agent runtime · engine.py Automation engine · bootstrapper.py Bootstrapper · main.py CLI runtime
Components 21
User interaction
- CLI runtime
src/aetheros/cli/main.py - Voice pipeline
src/aetheros/voice/pipeline.py - HUD service
src/aetheros/hud/service.py
Agent reasoning
- Agent runtime
src/aetheros/agents/agent.py - Agent planner
src/aetheros/agents/planner/planner.py - Policy engine
src/aetheros/agents/policy/engine.py - LLM engine
src/aetheros/llm/engine.py
Tool execution
- Automation engine
src/aetheros/desktop/automation/engine.py - Tool executor
src/aetheros/tools/executor.py - Tool registry
src/aetheros/tools/registry.py
Desktop capabilities
- Browser service
src/aetheros/browser/controller.py - Application service
src/aetheros/desktop/application/controller.py - Process service
src/aetheros/desktop/process/controller.py - Window service
src/aetheros/desktop/window/controller.py - Screen service
src/aetheros/desktop/screen/controller.py - Vision service
src/aetheros/vision/controller.py
Runtime services
- Bootstrapper
src/aetheros/bootstrap/bootstrapper.py - Service container
src/aetheros/core/container/container.py - Event bus
src/aetheros/runtime/events/event_bus.py - Observability pipeline
src/aetheros/core/observability/pipeline.py
Other components
- User
Connections 17
- User → CLI runtime: issues commands
- CLI runtime → Event bus: uses events
src/aetheros/cli/main.py - CLI runtime → HUD service: uses HUD
src/aetheros/cli/main.py - Voice pipeline → Event bus: publishes events
src/aetheros/voice/pipeline.py - Voice pipeline → Observability pipeline: emits traces
src/aetheros/voice/pipeline.py - Agent runtime → Agent planner: plans tasks
- Agent runtime → Policy engine: checks policy
- Agent runtime → LLM engine: requests reasoning
- Automation engine → Tool executor: executes steps
src/aetheros/desktop/automation/engine.py - Automation engine → Tool registry: checks tools
src/aetheros/desktop/automation/engine.py - Automation engine → Vision service: verifies outcomes
- Bootstrapper → Service container: configures services
src/aetheros/bootstrap/bootstrapper.py - Bootstrapper → Tool registry: discovers tools
src/aetheros/bootstrap/bootstrapper.py - Bootstrapper → Event bus: configures events
src/aetheros/bootstrap/bootstrapper.py - Application service → Process service: manages processes
src/aetheros/desktop/application/controller.py - Application service → Window service: resolves windows
src/aetheros/desktop/application/controller.py - Vision service → Screen service: analyzes captures