How aipubg/genie works
GENIE is a persistent personal-intelligence daemon with a thin UI/API boundary. The principal path is an owner request through the director and mission orchestration to a permitted computer or browser action, verification, audit, and a result. Separate branches provide voice interaction, memory, models, plugins, device/perception services, and agent teams. The graph follows README-described capabilities and relationships visible in excerpts or the source index; unsampled implementations are represented only at supported paths, and uncertain links are omitted.
Main entry points: orchestrator.py Request orchestrator · computer/service.py Computer capabilities · server.py Local API · missions/service.py Mission state
Components 20
Interaction and orchestration
- Desktop and web UI
ui/web/api.js - Local API
core/ipc/server.py - Request orchestrator
core/orchestrator.py - Event bus
core/events.py
Planning and execution
- Director routing
director/heuristics.py - Mission state
missions/service.py - Computer capabilities
computer/service.py - Browser automation
browser/service.py
Trust and persistence
- PTE and policy
security/policy.py - Audit and trust
security/audit.py - Persistent memory
memory/service.py
Intelligence services
- Model gateway
models/gateway.py - Context compiler
context/compiler.py - Voice pipeline
voice/pipeline.py - Agent teams
agents/service.py
Devices and extensions
- Isolated plugins
plugins/client.py - Device mesh
devices/service.py - Perception service
perception/service.py - Skill execution
skills/service.py
Other components
- Owner
Connections 23
- Owner → Desktop and web UI: sends request
- Desktop and web UI → Local API: calls API
core/ipc/server.py - Local API → Request orchestrator: routes requests
core/ipc/server.py - Request orchestrator → Director routing: routes intent
core/orchestrator.py - Request orchestrator → Mission state: schedules missions
core/orchestrator.py - Director routing → Mission state: proposes mission
- Mission state → Computer capabilities: runs capability
- Computer capabilities → PTE and policy: checks permission
- Computer capabilities → Audit and trust: audits action
- Computer capabilities → Browser automation: uses browser
browser/service.py - Request orchestrator → Context compiler: builds context
core/orchestrator.py - Request orchestrator → Model gateway: requests model
- Request orchestrator → Agent teams: delegates work
- Voice pipeline → Request orchestrator: submits utterance
voice/pipeline.py - Request orchestrator → Persistent memory: uses memory
- Local API → Event bus: streams events
core/ipc/server.py - Request orchestrator → Event bus: publishes events
core/orchestrator.py - Local API → Device mesh: routes device APIs
core/ipc/server.py - Local API → Perception service: serves awareness
core/ipc/server.py - Request orchestrator → Skill execution: executes skills
- Computer capabilities → Isolated plugins: dispatches plugins
- Computer capabilities → Device mesh: routes device action
- Mission state → Audit and trust: records outcomes