How jackson254365/personal-ai-agent works
Personal AI Agent is a locally orchestrated Linux assistant with CLI, REST/WebSocket, messaging, and voice interaction channels. Its principal workflow sends a user request through the reasoning engine, which plans and dispatches registered tools subject to safety checks and approval; results are reflected and actions audited. Distinct capability branches cover finance, communications, desktop/system operations, scheduling, and document intelligence. The README documents several capabilities whose source was not sampled; those are represented without speculative implementation links.
Main entry points: reasoning_engine.py Reasoning Engine · autonomy_engine.py Offline Autonomy · resource_monitor.py Resource Monitor · market_ingestion.py Market Ingestion
Components 26
Interaction
- CLI
src/cli.py - REST / WebSocket
src/api/server.py - WhatsApp Bridge
src/messaging/whatsapp_bridge.py - SIP Pipeline
src/telephony/sip_pipeline.py
Agent Core
- Reasoning Engine
src/core/reasoning_engine.py - Tool Registry
src/core/tool_registry.py - Safety Gatekeeper
src/core/safety_gatekeeper.py - Priority Event Bus
src/core/event_bus.py - Audit Trail
src/audit/canonical_log.py - Merkle Chain
src/audit/merkle_chain.py
Finance
- Market Ingestion
src/finance/market_ingestion.py - Quant Risk
src/finance/quant_risk_engine.py - Execution Gateway
src/finance/execution_gateway.py
Communications
- E2EE Crypto
src/messaging/crypto_e2ee.py - Voice Biometrics
src/telephony/voice_auth.py
System Capabilities
- Calendar Sync
src/calendar/calendar_sync.py - Desktop Adapters
src/desktop/desktop_adapters.py - PTY Executor
src/terminal/pty_executor.py - OCR Pipeline
src/idp/ocr_pipeline.py - MPRIS Control
src/media/mpris_control.py - Resource Monitor
src/system/resource_monitor.py - Self Healing
src/system/self_healing.py - GFS Backup
src/system/gfs_backup.py - Connectivity Monitor
src/network/connectivity_monitor.py - Offline Autonomy
src/offline/autonomy_engine.py
Other components
- User
Connections 21
- User → CLI: submits command
README.md - User → REST / WebSocket: submits request
README.md - CLI → Reasoning Engine: routes prompt
src/cli.py - REST / WebSocket → Reasoning Engine: routes prompt
src/api/server.py - WhatsApp Bridge → Reasoning Engine: forwards messages
src/messaging/whatsapp_bridge.py - SIP Pipeline → Voice Biometrics: checks caller
src/telephony/sip_pipeline.py - SIP Pipeline → Priority Event Bus: publishes events
src/telephony/sip_pipeline.py - WhatsApp Bridge → E2EE Crypto: uses encryption
src/messaging/whatsapp_bridge.py - Reasoning Engine → Tool Registry: dispatches tools
src/core/reasoning_engine.py - Reasoning Engine → Audit Trail: records decisions
src/core/reasoning_engine.py - Tool Registry → Safety Gatekeeper: checks permissions
src/core/tool_registry.py - Market Ingestion → Priority Event Bus: publishes ticks
src/finance/market_ingestion.py - Quant Risk → Market Ingestion: reads orderbook
src/finance/quant_risk_engine.py - Execution Gateway → Quant Risk: validates exposure
src/finance/execution_gateway.py - Execution Gateway → Market Ingestion: reads market data
src/finance/execution_gateway.py - Audit Trail → Merkle Chain: uses hash chain
src/audit/canonical_log.py - Resource Monitor → Priority Event Bus: publishes telemetry
src/system/resource_monitor.py - Resource Monitor → Connectivity Monitor: reports status
- Offline Autonomy → Connectivity Monitor: checks connectivity
src/offline/autonomy_engine.py - Offline Autonomy → Reasoning Engine: falls back
src/offline/autonomy_engine.py - Offline Autonomy → Resource Monitor: reads snapshot
src/offline/autonomy_engine.py