v1.0.1

🎙 JARVIS Voice Assistant — Windows Release

JARVIS — современный голосовой ассистент для Windows с офлайн-распознаванием речи, wake word активацией и AI-режимом на базе Gemini.

Проект создан как реальный desktop assistant для повседневного использования, а не просто демонстрация.

---

🚀 Основные возможности

✅ Wake word активация (Jarvis)
✅ Офлайн распознавание речи (Vosk)
✅ Управление Windows голосом
✅ Системные команды (громкость, блокировка, перезагрузка)
✅ Работа в фоне
✅ AI-чат режим (Gemini)
✅ Гибкая настройка через config.yaml
✅ Production installer

---

🖥 Поддержка платформ

✔ Windows 10 (64-bit)
✔ Windows 11 (64-bit)

---

📦 Установка

1. Скачайте JarvisInstaller.exe
2. Запустите установщик
3. Следуйте инструкциям
4. Запустите Jarvis через ярлык

---

⚙ Важно после установки

После первого запуска настройте файл:

%localappdata%\Jarvis\config.yaml

Добавьте:

🔑 Picovoice Access Key (для wake word)
🤖 Gemini API Key (для AI режима)

---

🎤 Примеры команд

Jarvis
Открой браузер
Заблокируй экран
Сделай громче
Перезагрузи компьютер

AI режим:

Jarvis, объясни нейросети
Jarvis, помоги написать текст

---

⚠ Требования

✔ Микрофон
✔ Porcupine Access Key
✔ Интернет (для AI режима)

---

🧠 Используемые технологии

Python 3.12 · Vosk · Porcupine · Gemini API · PyInstaller · Inno Setup

---

⭐ Если проект вам понравился — поддержите его звездой на GitHub!
💡 Баги и идеи принимаются через Issues.

v1.0.0

🚀 Jarvis Assistant v1.0 — Windows Voice Assistant Release

Jarvis is a lightweight offline-first voice assistant for Windows with wake word activation, fast command execution, AI chat mode and system control.

Designed for real desktop usage with low latency and production-ready architecture.

---

✨ Features

🎙 Voice Control

• Wake word activation: "Jarvis"
• Smart silence detection
• Automatic session timeout
• Adaptive microphone calibration

⚡ Offline Commands (Fast Mode)

Works without internet:

• Open browser
• Open YouTube
• System volume control
• Mute / Unmute
• Time and date
• File explorer
• Lock screen
• Restart PC
• Shutdown PC
• Exit assistant
• Fun voice responses

🧠 AI Mode (Optional)

Powered by Google Gemini API:

• Natural conversations
• Voice-optimized answers (TTS friendly)
• Automatic fallback when internet is unavailable
• Can be enabled / disabled in config

🔊 Audio System

• Stable Windows 10/11 audio control
• No lag between STT and TTS
• Clean microphone handling
• Production safe audio pipeline

📦 Desktop Ready

• Standalone EXE
• Windows installer
• No Python required
• Portable build available
• Automatic config creation in user folder

---

🛠 Installation

1. Download installer from Releases
2. Run installer
3. Launch Jarvis Assistant
4. Edit config file:

C:\Users\YOUR_NAME\AppData\Local\Jarvis\config.yaml

---

🔑 API Setup (Optional)

Porcupine Wake Word

1. Create account:
   https://picovoice.ai/

2. Get Access Key

3. Paste into:

porcupine:
  access_key: "YOUR_KEY"

---

Gemini AI (Optional)

1. Create API key:
   https://ai.google.dev/

2. Paste into:

ai:
  api_key: "YOUR_KEY"

Enable:

ai:
  enabled: true

---

🗣 Example Commands

Jarvis open browser
Jarvis volume up
Jarvis mute sound
Jarvis what time is it
Jarvis tell a joke
Jarvis shutdown assistant

---

⚙ Configuration

All settings stored here:

%LOCALAPPDATA%\Jarvis\config.yaml

You can customize:

• Wake word
• Timeout
• Microphone sensitivity
• AI mode
• Audio settings

---

🧩 Tech Stack

• Python 3.12
• Vosk STT (offline)
• Porcupine Wake Word
• Pyttsx3 TTS
• PyInstaller
• Windows Audio API (pycaw)
• Gemini API

---

⚠ Known Notes

• First launch may take 2–3 seconds (model loading)
• Microphone permission required
• Windows Defender may scan on first run

---

🛣 Roadmap

Planned features:

• Tray mode
• GUI control panel
• Multi-language voice packs
• Spotify control
• Window management
• Per-app volume control
• Smart home integration