first commit

Author: RustamovAkrom

.env-example

@@ -0,0 +1,2 @@
+PORCUPINE_ACCESS_KEY=
+GEMINI_API_KEY=

.gitignore

@@ -0,0 +1,12 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+*.log
+.env

.python-version

@@ -0,0 +1 @@
+3.12

README.md

@@ -0,0 +1,248 @@
+![img](/assets/logo.png)
+# 🎙 Jarvis Voice Assistant (Windows)
+
+Jarvis — это офлайн + онлайн голосовой ассистент для Windows с поддержкой wake word, голосовых команд и AI-режима (Gemini).
+
+Поддерживает:
+- Активацию по голосу (Jarvis)
+- Локальное распознавание речи (Vosk)
+- Голосовой ответ (TTS)
+- Управление системой
+- AI режим (Gemini)
+- Работу в фоне
+
+
+---
+
+## 📦 Установка (Windows)
+
+### 1. Скачать installer
+
+Перейдите в раздел Releases на GitHub и скачайте файл:
+
+```
+
+JarvisInstaller.exe
+
+```
+
+---
+
+### 2. Установить
+
+1. Запустите `JarvisInstaller.exe`
+2. Нажмите Next → Install
+3. Дождитесь завершения установки
+4. Запустите Jarvis через ярлык на рабочем столе
+
+---
+
+## ⚙ Первоначальная настройка (ОБЯЗАТЕЛЬНО)
+
+После первого запуска Jarvis автоматически создаёт файл конфигурации:
+
+```
+
+C:\Users<YOUR_USERNAME>\AppData\Local\Jarvis\config.yaml
+
+```
+
+Откройте его для настройки API ключей.
+
+Быстрый способ:
+
+1. Нажмите Win + R
+2. Вставьте:
+
+```
+
+%localappdata%\Jarvis
+
+````
+
+3. Нажмите Enter
+4. Откройте `config.yaml`
+
+---
+
+# 🔑 Настройка Porcupine (Wake Word)
+
+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"
+```
+
+Сохраните файл.
+
+---
+
+# 🤖 Настройка Gemini AI (опционально)
+
+AI режим позволяет задавать вопросы ассистенту.
+
+---
+
+### Получить Gemini API key:
+
+1. Перейдите:
+
+[https://aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey)
+
+2. Создайте API Key
+3. Скопируйте ключ
+
+---
+
+### Вставить ключ
+
+В `config.yaml`:
+
+```yaml
+ai:
+  api_key: ""
+```
+
+Замените:
+
+```yaml
+ai:
+  api_key: "YOUR_GEMINI_API_KEY"
+```
+
+---
+
+### Включение AI режима
+
+Проверьте:
+
+```yaml
+ai:
+  enabled: true
+```
+
+---
+
+# 🎤 Использование ассистента
+
+### Активация:
+
+Скажите:
+
+```
+Jarvis
+```
+
+---
+
+### Примеры команд:
+
+```
+Открой браузер
+Включи YouTube
+Который час
+Выключи компьютер
+```
+
+---
+
+### AI режим:
+
+Пример:
+
+```
+Jarvis, что такое черная дыра
+Jarvis, объясни квантовую физику простыми словами
+```
+
+---
+
+# ⚠ Требования
+
+* Windows 10 / 11 (64-bit)
+* Микрофон
+* Интернет (для AI режима)
+* Porcupine API Key (обязательно)
+
+---
+
+# 🛠 Решение проблем
+
+### Ассистент не запускается
+
+Проверь:
+
+* config.yaml существует
+* Porcupine access_key указан
+* микрофон разрешён в Windows
+
+---
+
+### Микрофон не работает
+
+Открой:
+
+```
+Settings → Privacy → Microphone
+```
+
+Включи:
+
+* Allow desktop apps to access microphone
+
+---
+
+# 📁 Где хранится конфиг
+
+```
+C:\Users\<USERNAME>\AppData\Local\Jarvis\config.yaml
+```
+
+---
+
+# 🚀 Разработка
+
+Проект написан на Python и использует:
+
+* Vosk STT
+* Picovoice Porcupine
+* pyttsx3
+* Gemini API
+* PyInstaller
+* Inno Setup
+
+---
+
+# 📄 Лицензия
+
+MIT License
+
+---
+
+# ⭐ Поддержка проекта
+
+Если проект понравился — поставьте ⭐ на GitHub 🙂

ai/__init__.py

@@ -0,0 +1,95 @@
+import os
+import time
+from core.config import AI_MODEL
+
+
+VOICE_SYSTEM_PROMPT = """
+РОЛЬ:
+Ты — голосовой ассистент для общения с человеком в реальном времени.
+
+ОСНОВНАЯ ЦЕЛЬ:
+Давать понятные, короткие и естественные ответы, которые удобно слушать, а не читать.
+
+СТИЛЬ РЕЧИ:
+Говори как человек.
+Разговорный, спокойный, дружелюбный тон.
+Без формального языка и сложных терминов.
+
+ОГРАНИЧЕНИЯ ФОРМАТА:
+Отвечай ТОЛЬКО обычным текстом.
+НЕ используй markdown.
+НЕ используй списки.
+НЕ используй код.
+НЕ используй символы форматирования (* # - _ `).
+НЕ используй эмодзи.
+
+ДЛИНА ОТВЕТА:
+Максимум 2–3 коротких предложения.
+Если тема сложная — дай краткое объяснение и предложи продолжить.
+
+ПОВЕДЕНИЕ:
+Не повторяй вопрос пользователя.
+Не добавляй вводные фразы типа "Конечно" или "Вот ответ".
+Сразу отвечай по сути.
+
+ЕСЛИ НЕ УВЕРЕН:
+Скажи честно и предложи уточнить.
+
+ВАЖНО:
+Ты предназначен для озвучивания через TTS.
+Ответ должен звучать естественно вслух.
+"""
+
+class GeminiClient:
+
+    def __init__(self, api_key):
+
+        self.api_key = api_key
+        self.available = bool(api_key)
+
+        self.max_chars = 600
+        self.retry_count = 2
+
+        if self.available:
+            try:
+                from google import genai
+                self.genai_client = genai.Client()
+            except Exception as e:
+                print("❌ Gemini init failed:", e)
+                self.available = False
+
+
+    def ask(self, prompt):
+
+        if not self.available:
+            return None
+
+        full_prompt = VOICE_SYSTEM_PROMPT + "\n\nВопрос:\n" + prompt
+
+        for attempt in range(self.retry_count):
+
+            try:
+
+                response = self.genai_client.models.generate_content(
+                    model=AI_MODEL,
+                    contents=full_prompt
+                )
+
+                text = getattr(response, "text", None)
+
+                if not text:
+                    return None
+
+                text = text.strip()
+
+                # limit TTS spam
+                if len(text) > self.max_chars:
+                    text = text[:self.max_chars] + "..."
+
+                return text
+
+            except Exception as e:
+                print(f"⚠ Gemini request failed ({attempt+1}):", e)
+                time.sleep(1)
+
+        return None

ai/gemini.py

@@ -0,0 +1,28 @@
+VSVersionInfo(
+  ffi=FixedFileInfo(
+    filevers=(1,0,0,0),
+    prodvers=(1,0,0,0),
+    mask=0x3f,
+    flags=0x0,
+    OS=0x40004,
+    fileType=0x1,
+    subtype=0x0,
+    date=(0,0)
+  ),
+  kids=[
+    StringFileInfo(
+      [
+        StringTable(
+          '040904B0',
+          [
+            StringStruct('CompanyName', 'Jarvis Assistant'),
+            StringStruct('FileDescription', 'Jarvis Voice Assistant'),
+            StringStruct('FileVersion', '1.0'),
+            StringStruct('ProductName', 'Jarvis'),
+            StringStruct('ProductVersion', '1.0')
+          ]
+        )
+      ]
+    )
+  ]
+)