How iblamelessly/ai-assistant works
JARVIS is a personal desktop/CLI AI assistant. Users submit text or voice requests; the assistant routes conversation and invokes guarded automation or media/document tools, then streams results to the UI or terminal. The graph preserves README capabilities such as video, document generation, voice, and usage tracking. Several modules are indexed but not excerpted, so only documented or indexed relationships are shown; unsampled subsystem links are omitted where their callers are unclear.
Main entry points: tools.py Tool registry · assistant.py Assistant dispatcher · webview_app.py Desktop bridge · groq_client.py Groq client
Components 25
User Interfaces
- Desktop launcher
app.py - CLI entry
main.py - Desktop bridge
ui/webview_app.py - Webview interface
ui/web/app.js
Assistant Core
- Assistant dispatcher
core/assistant.py - Model router
core/model_router.py - Tool registry
core/tools.py
Automation & Safety
- Approval guard
core/permissions.py - App launching
core/app_launcher.py - File search
core/file_search.py
Media & Documents
- Image editing
core/media_editor.py - Image generation
core/ai_image.py - Video synthesis
core/ai_video.py - Document generation
core/document_generator.py
Models & Persistence
- Groq client
core/groq_client.py - Gemini client
core/gemini_client.py - Persistent memory
core/memory.py - Chat sessions
core/history.py - Configuration
core/config.py - Speech synthesis
core/voice.py - Voice input
core/mic.py
Other components
- User
- Pollinations service
- Groq Cloud
- Local Ollama
Connections 29
- User → Webview interface: submits request
README.md - Webview interface → Desktop bridge: calls bridge
README.md - User → CLI entry: enters request
main.py - CLI entry → Assistant dispatcher: streams chat
main.py - Desktop launcher → Desktop bridge: starts desktop
app.py - Desktop bridge → Assistant dispatcher: dispatches chat
ui/webview_app.py - Desktop bridge → Persistent memory: uses memory
ui/webview_app.py - Desktop bridge → Chat sessions: manages sessions
ui/webview_app.py - Desktop bridge → Configuration: loads settings
ui/webview_app.py - Desktop bridge → Voice input: records speech
ui/webview_app.py - Assistant dispatcher → Tool registry: invokes tools
core/assistant.py - Assistant dispatcher → Model router: routes prompts
core/assistant.py - Assistant dispatcher → Groq client: requests inference
core/assistant.py - Assistant dispatcher → Gemini client: uses alternate model
core/assistant.py - Assistant dispatcher → Approval guard: checks approvals
README.md - Assistant dispatcher → Speech synthesis: synthesizes speech
core/assistant.py - Tool registry → App launching: launches applications
core/tools.py - Tool registry → File search: resolves files
core/tools.py - Tool registry → Image editing: edits media
core/tools.py - Tool registry → Image generation: generates images
core/tools.py - Tool registry → Video synthesis: generates video
core/tools.py - Tool registry → Document generation: creates documents
core/tools.py - Tool registry → Groq client: tracks usage
core/tools.py - Gemini client → Groq client: shares usage tracker
core/gemini_client.py - Image generation → Pollinations service: requests image
core/ai_image.py - Video synthesis → Image generation: uses scene imagery
core/ai_video.py - Groq client → Groq Cloud: streams inference
core/groq_client.py - Voice input → Groq Cloud: transcribes audio
README.md - Desktop launcher → Local Ollama: checks availability
app.py