How ygyg4255-dotcom/ai-desktop-assistant works
Altron is a Windows desktop AI assistant. A user interacts through the floating chat UI or voice wake-word; the chat submits requests to the agent, which consults the AI backend and can execute tools, including file operations, desktop-icon control, and PDF reporting. The UI also exposes settings, conversation history, and permission prompts; voice and Telegram provide additional interaction and response channels. The graph follows documented capabilities, but some wiring—especially Telegram command dispatch and voice orchestration—is not visible in the sampled excerpts and is left unverified.
Main entry points: chat_window.py Chat capsule · executor.py Agent loop · tools.py Tool registry · app.py Application
Components 19
User interaction
- Application
src/app.py - Chat capsule
src/ui/chat_window.py - System tray
src/ui/system_tray.py - Settings dialog
src/ui/settings_window.py - Voice services
src/services/voice_service.py
Agent execution
- Agent loop
src/agent/executor.py - Permission rules
src/agent/permissions.py - Tool registry
src/agent/tools.py - File operations
src/agent/tools.py - PDF reporting
src/agent/tools.py
External capabilities
- Desktop icon control
src/services/desktop_icon_service.py - AI API client
src/services/ai_client.py - OmniRoute manager
src/services/omniroute_manager.py - Telegram service
src/services/telegram_service.py
Configuration and state
- App settings
src/config/settings.py - SQLite store
src/storage/db.py
Other components
- Desktop user
- LLM endpoint
- Telegram API
Connections 26
- Desktop user → Chat capsule: enters requests
README.md - Desktop user → System tray: opens controls
- Application → SQLite store: initializes
src/app.py - Application → System tray: creates
src/app.py - Application → Chat capsule: creates
src/app.py - Application → App settings: loads
src/app.py - Chat capsule → Agent loop: submits prompts
src/ui/chat_window.py - Chat capsule → SQLite store: uses history
src/ui/chat_window.py - Chat capsule → Voice services: uses voice
src/ui/chat_window.py - Chat capsule → Telegram service: uses messaging
src/ui/chat_window.py - Agent loop → AI API client: requests responses
src/agent/executor.py - Agent loop → Tool registry: dispatches tools
src/agent/executor.py - Agent loop → Permission rules: checks permissions
src/agent/executor.py - Agent loop → SQLite store: records executions
src/agent/executor.py - Tool registry → File operations: dispatches file actions
src/agent/tools.py - Tool registry → PDF reporting: dispatches reports
README.md - Tool registry → Desktop icon control: controls icons
src/agent/tools.py - AI API client → LLM endpoint: sends API requests
src/services/ai_client.py - OmniRoute manager → LLM endpoint: checks local endpoint
src/services/omniroute_manager.py - Telegram service → Telegram API: polls and sends
src/services/telegram_service.py - Settings dialog → App settings: edits configuration
src/ui/settings_window.py - Settings dialog → SQLite store: reads preferences
src/ui/settings_window.py - Settings dialog → Tool registry: configures permissions
src/ui/settings_window.py - Settings dialog → AI API client: tests connection
src/ui/settings_window.py - Desktop user → Voice services: speaks wake word
README.md - Telegram service → Chat capsule: delivers remote commands
src/ui/chat_window.py