HARVIS (Helpful, Adaptive, Reliable Virtual Intelligent Supporter) is a lightweight, modular AI assistant designed to support your daily productivity and motivation. HARVIS runs locally on your machine and interacts with you through natural voice commands — like a helpful friend or life coach.

• 🎤 Voice-Activated — responds to a custom wake word (“Hey HARVIS”)
• 🗣️ Offline Speech-to-Text using Vosk
• 💬 Positive, Motivating Conversations
• ⏰ Reminders & Schedules to help you stay on track
• 📝 Text & Video Summarization using lightweight LLMs
• 🚀 App Launcher (e.g., Notepad, YouTube)
• 🔒 Local-First and Privacy-Friendly

HARVIS/
├── harvis/
│   ├── input/              # Wake word + STT handling
│   ├── nlu/                # Intent and entity recognition
│   ├── tasks/              # Reminders, scheduling, app launcher
│   ├── llm_interface/      # Text generation and summarization
│   ├── output/             # TTS and text responses
│   ├── database/           # SQLite schemas and query logic
│   └── main.py             # Core controller
├── models/                 # Vosk & summarization models
├── config/                 # User preferences and settings
└── README.md

1. Clone the Repo

   git clone https://github.com/yourusername/HARVIS.git
   cd HARVIS

2. Create a Virtual Environment

   python -m venv venv
   source venv/bin/activate      # macOS/Linux
   .\venv\Scripts\activate       # Windows

3. Install Dependencies

   pip install -r requirements.txt

4. Download Models

   • Vosk model (small)
   • Lightweight LLMs from Hugging Face (e.g., distilbart-cnn-12-6)

5. Run HARVIS

   python harvis/main.py

HARVIS will be demonstrated in a short video showing:

• Wake word activation
• Voice commands for tasks
• Motivational dialogue
• Desktop notifications