Python 3.12 | Windows | Offline STT | AI Powered

🎙 Jarvis Voice Assistant — Windows Voice AI Assistant

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

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

---

🚀 Возможности

Jarvis умеет:

✅ Голосовая активация по wake word
✅ Офлайн распознавание речи (Vosk)
✅ Быстрые системные команды
✅ Управление компьютером голосом
✅ Управление громкостью
✅ Работа в фоне
✅ AI режим общения (Gemini)
✅ Гибкая настройка через config.yaml
✅ Production-ready installer

---

🖥 Поддерживаемая платформа

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

---

📦 Установка (Windows)

1️⃣ Скачать установщик

Перейдите в раздел Releases и скачайте:

JarvisInstaller.exe

---

2️⃣ Установка

1. Запустите JarvisInstaller.exe
2. Нажмите Next → Install
3. Дождитесь завершения
4. Запустите Jarvis через ярлык на рабочем столе

---

⚙ Первоначальная настройка (ОБЯЗАТЕЛЬНО)

После первого запуска Jarvis автоматически создаёт файл конфигурации:

C:\Users<USERNAME>\AppData\Local\Jarvis\config.yaml

---

Как открыть папку конфигурации:

1. Нажмите Win + R
2. Вставьте:

%localappdata%\Jarvis

````

3. Нажмите Enter  
4. Откройте `config.yaml`

---

# 🔑 Настройка Wake Word (Porcupine)

Jarvis использует Picovoice Porcupine для мгновенного распознавания слова активации.

---

## Получение ключа:

1. Перейдите:

https://console.picovoice.ai/

2. Зарегистрируйтесь  
3. Создайте **Access Key**  
4. Скопируйте ключ  

---

## Вставка ключа

В `config.yaml`:

```yaml
porcupine:
  access_key: ""
````

Замените:

```yaml
porcupine:
  access_key: "YOUR_PICOVOICE_KEY"

Сохраните файл.

---

🤖 Настройка AI режима (Gemini)

AI режим позволяет общаться с ассистентом как с ChatGPT.

---

Получить Gemini API key:

1. Перейдите:

https://aistudio.google.com/app/apikey

1. Создайте API Key
2. Скопируйте

---

Вставить ключ

В config.yaml:

ai:
  api_key: ""

Замените:

ai:
  api_key: "YOUR_GEMINI_API_KEY"

---

Проверить что AI включен:

ai:
  enabled: true

---

🎤 Использование ассистента

---

▶ Активация

Произнесите:

Jarvis

Ассистент перейдёт в режим ожидания команд.

---

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

Открой браузер
Включи YouTube
Который час
Перезагрузи компьютер
Заблокируй экран
Сделай громче
Открой проводник

---

▶ AI режим (чат)

Примеры:

Jarvis, что такое чёрная дыра
Jarvis, объясни нейросети простыми словами
Jarvis, помоги написать текст

---

🛠 Настройки config.yaml

Пример:

assistant:
  wakeword: "jarvis"
  command_timeout: 15
  confidence_threshold: 70

audio:
  microphone_sensitivity: 2.5
  silence_timeout: 1.2

porcupine:
  access_key: ""

ai:
  enabled: true
  api_key: ""
  model: "gemini-3-flash-preview"

---

⚠ Требования

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

---

🧯 Решение проблем

---

Ассистент не запускается

Проверь:

• config.yaml существует
• Porcupine key указан
• микрофон разрешён

---

Не работает микрофон

Открой:

Settings → Privacy → Microphone

Включи:

✔ Allow desktop apps to access microphone

---

📁 Где хранятся данные

Конфигурация:

C:\Users\<USERNAME>\AppData\Local\Jarvis\

---

🧠 Технологии проекта

Проект использует:

• Python 3.12
• Vosk STT
• Picovoice Porcupine
• pyttsx3
• Gemini API
• PyInstaller
• Inno Setup

---

💡 Для разработчиков

Jarvis построен модульно:

core/
 ├── assistant.py
 ├── command_router.py
 ├── stt.py
 ├── wakeword.py
 ├── actions/
ai/
models/

Можно легко добавлять новые навыки и команды.

---

📄 Лицензия

MIT License

---

⭐ Поддержка проекта

Если Jarvis оказался полезным:

⭐ Поставьте звезду на GitHub 🐛 Сообщайте об ошибках 💡 Предлагайте идеи

Спасибо за поддержку ❤️