How shahin0964/ai-agent- works
Nexus AI is an Android personal assistant whose main workflow runs from user-facing chat, voice, or vision interfaces through agent/AI capabilities to a response or device action. It also supports background routines and companion features. The README documents these capabilities and broad architecture; source excerpts here contain only build configuration, so internal call ownership and several integrations cannot be verified. The graph therefore uses documented product relationships and the exact implementation paths available in the tree, omitting uncertain wiring.
Main entry points: AgentOrchestrator.kt Agent Orchestrator · MainAppScreen.kt Main Dashboard · AndroidTools.kt Android Tools · VoiceScreen.kt Voice UI
Components 27
Assistant Interfaces
- App Shell
app/src/main/java/com/example/MainActivity.kt - Main Dashboard
app/src/main/java/com/example/ui/screens/MainAppScreen.kt - AI Chat
app/src/main/java/com/example/ui/screens/ChatScreen.kt - Voice UI
app/src/main/java/com/example/ui/screens/VoiceScreen.kt - Vision Studio
app/src/main/java/com/example/ui/screens/VisionScreen.kt - Agent Town
app/src/main/java/com/example/ui/screens/AgentTownScreen.kt - Automation Builder
app/src/main/java/com/example/ui/screens/AutomationBuilderScreen.kt - Speech Recognition
app/src/main/java/com/example/core/voice/AndroidSpeechRecognizerEngine.kt - Speech Output
app/src/main/java/com/example/core/tts/AndroidTextToSpeechEngine.kt
Agent And Device
- Agent Orchestrator
app/src/main/java/com/example/core/orchestrator/AgentOrchestrator.kt - Agent Controller
app/src/main/java/com/example/core/agent/AgentController.kt - Command Parser
app/src/main/java/com/example/core/action/CommandParser.kt - Android Tools
app/src/main/java/com/example/core/tool/AndroidTools.kt - Device Telemetry
app/src/main/java/com/example/core/telemetry/AndroidSystemTelemetry.kt - Accessibility Bridge
app/src/main/java/com/example/core/accessibility/AgentAccessibilityService.kt
AI Intelligence
- AI Router
app/src/main/java/com/example/core/ai/router/AIIntelligenceRouter.kt - AI Providers
app/src/main/java/com/example/core/ai/provider/AIProvider.kt - Vision Engine
app/src/main/java/com/example/core/ai/vision/VisionEngine.kt - Conversation Memory
app/src/main/java/com/example/core/ai/memory/MemoryManager.kt
Automation
- Automation Engine
app/src/main/java/com/example/core/automation/AutomationEngine.kt - Routine Scheduler
app/src/main/java/com/example/core/automation/scheduler/AutomationScheduler.kt - Automation Store
app/src/main/java/com/example/core/automation/store/AutomationStore.kt
Background Presence
- Companion Engine
app/src/main/java/com/example/core/companion/CompanionEngine.kt - Foreground Service
app/src/main/java/com/example/core/service/AgentForegroundService.kt
Other components
- Operator
- AI Service Providers
- Android Device
Connections 27
- Operator → App Shell: opens
- App Shell → Main Dashboard: shows
- Main Dashboard → AI Chat: navigates
- Main Dashboard → Voice UI: navigates
- Main Dashboard → Vision Studio: navigates
- Main Dashboard → Agent Town: navigates
- AI Chat → Agent Orchestrator: submits requests
- Voice UI → Speech Recognition: captures speech
- Voice UI → Agent Orchestrator: submits requests
- Vision Studio → Vision Engine: requests analysis
- Agent Orchestrator → Agent Controller: dispatches
- Agent Controller → Command Parser: parses commands
- Agent Orchestrator → AI Router: requests AI
- AI Router → AI Providers: routes requests
- AI Providers → AI Service Providers: calls
- Agent Orchestrator → Conversation Memory: uses context
- Agent Orchestrator → Android Tools: invokes tools
- Android Tools → Device Telemetry: reads device state
- Android Tools → Accessibility Bridge: uses accessibility
- Android Tools → Android Device: controls device
- Speech Recognition → Android Device: uses speech input
- Speech Output → Android Device: speaks responses
- Automation Builder → Automation Engine: configures routines
- Automation Engine → Automation Store: persists routines
- Automation Engine → Routine Scheduler: schedules execution
- Routine Scheduler → Android Device: sets alarms
- Foreground Service → Companion Engine: supports presence