How brunogpj/jarvis-ai-os works
Jarvis is a personal AI assistant: people send requests through web chat or WhatsApp, the agent routes them to Gemini and domain tools, and results can be returned as text or spoken on Android. The README also describes hybrid RAG, an actionable dashboard, scheduled autonomy, multimodal processing, and human-approved WhatsApp replies. The tree includes a native Android companion despite the README’s older claim that there is no native app. Edges use README statements or indexed/excerpted Android references; unsampled internals are not assumed to call one another.
Main entry points: Jarvis.js Agent loop · SkillsManager.js Tool registry · Api.kt Server API client · WhatsApp.js WhatsApp
Components 28
Agent and memory
- Agent loop
Jarvis.js - Intent routing
Semantica.js - Gemini models
Gemini.js - Hybrid RAG
FileSearchDrive.js - Wiki memory
WikiMemoryService.js - Cloud Firestore
Firestore.js - Tool registry
SkillsManager.js
Domain capabilities
- Gmail tools
Gmail.js - Calendar tools
Agenda.js - Drive search
FileSearchDrive.js - Finance tools
Financas.js - Media processing
Midia.js
Automation and safety
- Async broker
AsyncBroker.js - Scheduled jobs
Jobs.js - Goal autonomy
Objetivos.js - Human approval
Autorizacoes.js - Security controls
Sandbox.js
Android companion
- Android companion
android/app/src/main/java/dev/jarvis/companion/MainActivity.kt - Server API client
android/app/src/main/java/dev/jarvis/companion/Api.kt - Voice service
android/app/src/main/java/dev/jarvis/companion/FalaService.kt - Voice conversation
android/app/src/main/java/dev/jarvis/companion/Conversa.kt - Push dispatcher
android/app/src/main/java/dev/jarvis/companion/JarvisMessagingService.kt - Ack queue
android/app/src/main/java/dev/jarvis/companion/AckQueue.kt - Notification listener
android/app/src/main/java/dev/jarvis/companion/NotificacaoService.kt - Action dashboard
android/app/src/main/java/dev/jarvis/companion/Historico.kt
Other components
- User
Connections 29
- User → Web chat: sends request
README.md - User → WhatsApp: sends message
README.md - Web chat → Agent loop: submits request
README.md - WhatsApp → Agent loop: submits request
README.md - Agent loop → Intent routing: routes intent
README.md - Intent routing → Hybrid RAG: searches first
README.md - Agent loop → Gemini models: calls model
README.md - Agent loop → Tool registry: dispatches tools
README.md - Tool registry → Gmail tools: dispatches tool
README.md - Tool registry → Calendar tools: dispatches tool
README.md - Tool registry → Drive search: dispatches tool
README.md - Tool registry → Finance tools: dispatches tool
README.md - Hybrid RAG → Wiki memory: retrieves memory
README.md - Wiki memory → Cloud Firestore: stores memory
README.md - Agent loop → Async broker: queues heavy work
README.md - Scheduled jobs → Async broker: runs background work
- Goal autonomy → Async broker: executes in background
README.md - WhatsApp → Human approval: requests approval
README.md - Agent loop → Security controls: guards execution
README.md - Agent loop → Media processing: processes media
README.md - User → Android companion: uses companion
README.md - Android companion → Server API client: posts requests
android/app/src/main/java/dev/jarvis/companion/MainActivity.kt - Server API client → Agent loop: calls Apps Script
README.md - Push dispatcher → Voice service: starts service
android/app/src/main/java/dev/jarvis/companion/JarvisMessagingService.kt - Voice service → Voice conversation: asks assistant
android/app/src/main/java/dev/jarvis/companion/FalaService.kt - Push dispatcher → Ack queue: queues acknowledgments
android/app/src/main/java/dev/jarvis/companion/JarvisMessagingService.kt - Ack queue → Server API client: posts acknowledgments
android/app/src/main/java/dev/jarvis/companion/AckQueue.kt - Notification listener → Server API client: loads configuration
android/app/src/main/java/dev/jarvis/companion/NotificacaoService.kt - Action dashboard → Server API client: fetches dashboard
android/app/src/main/java/dev/jarvis/companion/Historico.kt