How manish-kuntal/altros-ai works
ALTROS is a local-first personal assistant: users speak or type requests, which are routed to an LLM, knowledge retrieval, or action modules; responses return through the CLI, voice, or web server. Its major documented branches include persistent memory, PDF/RAG learning, web search, desktop and browser automation, scheduled autonomy, and communication integrations. The excerpts show core routing, brain, memory, and server behavior; several feature connections are documented in the README rather than verified in sampled implementation.
Main entry points: main.py Application Entry · router.py Request Router · brain.py LLM Brain · memory.py Persistent Memory
Components 26
User Interaction
- Application Entry
main.py - Voice I/O
modules/voice.py - Wake Word
modules/wake_word.py - Web API
modules/server.py
Reasoning and Knowledge
- Request Router
core/router.py - LLM Brain
core/brain.py - Thinking Engine
core/thinking.py - Persistent Memory
core/memory.py - RAG Knowledge
modules/knowledge.py - Runtime Configuration
config.py
Automation and Control
- PC Control
modules/pc_control.py - Browser Control
modules/browser_control.py - System Control
modules/system_control.py - Terminal Control
modules/terminal_control.py - Autonomous Tasks
modules/autonomy.py - Task Scheduler
modules/scheduler.py - Event Watcher
modules/event_watcher.py - Action Permissions
core/permissions.py - Action Log
core/action_logger.py
External Integrations
- Ollama Runtime
- Web Search
modules/internet.py - Gmail Workflows
modules/gmail.py - Instagram Workflows
modules/instagram.py - WhatsApp Bridge
modules/whatsapp.py - WhatsApp Service
whatsapp/whatsapp_bridge.js
Other components
- User
Connections 39
- User → Application Entry: submits request
README.md - Application Entry → Request Router: routes requests
main.py - Application Entry → Voice I/O: starts voice
main.py - Application Entry → Wake Word: enables activation
main.py - Application Entry → Web API: starts server
main.py - Application Entry → Persistent Memory: initializes
main.py - Application Entry → LLM Brain: initializes
main.py - Application Entry → Thinking Engine: initializes
main.py - Application Entry → RAG Knowledge: registers feature
main.py - Application Entry → Web Search: registers feature
main.py - Application Entry → PC Control: registers feature
main.py - Application Entry → Autonomous Tasks: registers feature
main.py - Application Entry → Gmail Workflows: registers feature
main.py - Application Entry → Instagram Workflows: registers feature
main.py - Request Router → LLM Brain: generates response
core/router.py - Request Router → Persistent Memory: reads context
core/router.py - Request Router → RAG Knowledge: passes retrieved context
README.md - Request Router → Web Search: passes search context
README.md - Request Router → PC Control: dispatches action
core/router.py - Request Router → Autonomous Tasks: dispatches action
core/router.py - LLM Brain → Persistent Memory: reads history
core/brain.py - LLM Brain → Thinking Engine: requests intent plan
core/brain.py - LLM Brain → Ollama Runtime: sends prompt
core/brain.py - Web API → Request Router: routes chat
modules/server.py - Web API → Persistent Memory: reads and stores
modules/server.py - Voice I/O → Request Router: submits transcript
modules/voice.py - Voice I/O → User: speaks response
modules/voice.py - RAG Knowledge → Persistent Memory: indexes knowledge
README.md - Autonomous Tasks → Task Scheduler: schedules tasks
README.md - Event Watcher → Action Log: logs actions
modules/event_watcher.py - Browser Control → Action Log: logs actions
modules/browser_control.py - Task Scheduler → Action Log: logs actions
modules/scheduler.py - System Control → Action Permissions: checks permissions
modules/system_control.py - Terminal Control → Action Permissions: checks permissions
modules/terminal_control.py - WhatsApp Bridge → Action Permissions: checks permissions
modules/whatsapp.py - WhatsApp Bridge → WhatsApp Service: communicates with
README.md - Runtime Configuration → LLM Brain: configures model
core/brain.py - Runtime Configuration → Persistent Memory: configures storage
core/memory.py - Runtime Configuration → Web API: configures endpoint
modules/server.py