How erriswheel/jarvis works
J.A.R.V.I.S. is a local-first personal AI workspace. The operator uses the React dashboard to send requests to a loopback FastAPI service; chat is handled with local Ollama, with conversation and memory data persisted in SQLite. Separate capabilities cover voice, document import, learning, model-team review, telemetry, and workspace operations. The README documents these capabilities; some current modules were not sampled, so their internal call relationships are left out rather than inferred.
Main entry points: main.py FastAPI service · App.tsx Dashboard UI · api.ts API client · database.py Conversation store
Components 26
Dashboard
- Dashboard UI
frontend/src/App.tsx - API client
frontend/src/api.ts - 3D hologram
frontend/src/Hologram.tsx - Development lab
frontend/src/DevelopmentLab.tsx - Operations panel
frontend/src/OperationsPanel.tsx
Assistant workflow
- FastAPI service
backend/app/main.py - Task routing
backend/app/task_router.py - Model team
backend/app/model_team.py - Learning modes
backend/app/learning.py - Operator instructions
backend/app/operator_instructions.py
Memory and files
- Conversation store
backend/app/database.py - Memory manager
backend/app/database.py - Memory vectors
backend/app/memory_vectors.py - Document import
backend/app/documents.py - File exports
backend/app/file_exports.py
Voice and telemetry
- Voice listener
backend/app/voice_listener.py - Speech
backend/app/speech.py - Hardware telemetry
backend/app/monitor.py
Workspace operations
- Workspace metadata
backend/app/platform_store.py - Local security
backend/app/security.py - Backup manager
backend/app/backup_manager.py - Self development
backend/app/self_development.py - Poster references
backend/app/poster_reference.py - Runtime configuration
backend/app/config.py
Other components
- Operator
- Local Ollama
Connections 27
- Operator → Dashboard UI: uses
README.md - Dashboard UI → API client: calls
frontend/src/App.tsx - API client → FastAPI service: sends requests
README.md - FastAPI service → Local Ollama: requests inference
README.md - FastAPI service → Local Ollama: checks models
backend/app/main.py - FastAPI service → Task routing
backend/app/main.py - FastAPI service → Model team
backend/app/main.py - FastAPI service → Learning modes
backend/app/main.py - FastAPI service → Operator instructions
backend/app/main.py - FastAPI service → Conversation store: persists history
README.md - FastAPI service → Memory manager: manages memories
README.md - FastAPI service → Memory vectors
backend/app/main.py - FastAPI service → Document import: imports documents
README.md - FastAPI service → File exports
backend/app/main.py - FastAPI service → Voice listener: uses wake listener
README.md - FastAPI service → Speech: produces speech
README.md - FastAPI service → Hardware telemetry: reads telemetry
README.md - FastAPI service → Workspace metadata
backend/app/main.py - FastAPI service → Local security: enforces local boundary
README.md - FastAPI service → Backup manager
backend/app/main.py - FastAPI service → Self development
backend/app/main.py - FastAPI service → Poster references
backend/app/main.py - FastAPI service → Runtime configuration
backend/app/main.py - Dashboard UI → 3D hologram: renders
frontend/src/App.tsx - Dashboard UI → Development lab: renders
frontend/src/App.tsx - Dashboard UI → Operations panel: renders
frontend/src/App.tsx - Conversation store → Memory manager
backend/app/database.py