README.md

metadata

title: Friday Subconscious
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false

Project Jarvis

Personal AI Assistant — 100% Local, Zero Cloud Dependencies

Jarvis is a voice-first personal AI assistant that runs entirely on your Mac. No data leaves your machine. No API keys required for core functionality.

🧠 What Powers Jarvis (All Local)

Component	Technology	Purpose
LLM Brain	Ollama (llama3:8b)	Intent classification, reasoning, responses
Speech-to-Text	OpenAI Whisper (local)	Transcribes your voice commands
Text-to-Speech	Kokoro TTS + macOS native	Speaks responses back to you
Wake Word	openWakeWord	"Hey Jarvis" detection
Memory	ChromaDB + SQLite	Persistent memory and data storage
Backend	Python FastAPI	Service orchestration on localhost:7777

🚀 Quick Start

1. Run Setup (one-time)

bash scripts/setup.sh

This installs all dependencies, downloads models, and configures everything.

2. Start Jarvis

bash scripts/start.sh

3. Use Jarvis

• Web Dashboard: Open http://localhost:7777 in your browser
• CLI Mode: cd backend && source venv/bin/activate && python cli.py
• Voice Mode: cd backend && source venv/bin/activate && python cli.py --voice
• API Docs: http://localhost:7777/docs

4. Stop Jarvis

bash scripts/stop.sh

📁 Project Structure

Jarvis/
├── backend/            # Python FastAPI server
│   ├── app/
│   │   ├── api/        # REST API endpoints
│   │   ├── core/       # Brain, intent routing, context management
│   │   ├── services/   # STT, TTS, LLM, wake word, audio
│   │   └── models/     # Pydantic schemas
│   ├── main.py         # Server entry point
│   ├── config.py       # Configuration
│   └── cli.py          # Terminal interface
├── static/             # Web dashboard
├── app/                # macOS Swift menu bar app (Phase 2)
├── models/             # Downloaded AI models
├── data/               # Runtime data (SQLite, ChromaDB)
└── scripts/            # Setup, start, stop scripts

🎙️ Voice Commands (Phase 0)

Say This	Jarvis Does
"Hey Jarvis, what time is it?"	Tells you the current time
"Good morning"	Greets you with daily context
"What can you do?"	Lists available capabilities
"Draft an email to the team"	Drafts content for you
"Tell me a joke"	Engages in conversation

🛣️ Roadmap

• Phase 0 ✅ Core voice loop, LLM brain, web dashboard
• Phase 1 🔜 Expense tracking, SQLite database, ChromaDB memory
• Phase 2 🔜 Contact intelligence, Google Sheets integration
• Phase 3 🔜 OttoPilot CRM integration
• Phase 4 🔜 WhatsApp, Gmail, Calendar
• Phase 5 🔜 Call recording & memory
• Phase 6 🔜 Analytics & reporting
• Phase 7 🔜 macOS system intelligence
• Phase 8 🔜 Polish & hardening
• Phase 9 🔜 Mobile app (React Native)

⚙️ Configuration

Edit backend/.env to customize:

• OLLAMA_MODEL — Change the LLM model (default: llama3:8b)
• WHISPER_MODEL — STT model size (tiny/base/small/medium/large)
• TTS_ENGINE — kokoro (neural) or macos (system voice)
• OPENAI_API_KEY — Optional GPT-4 fallback

---

Built with ❤️ by Antigravity — Confidential