bossiara13/J.A.R.V.I.S-py

Bossiara13 1078b2daa3 docs: drop picovoice mentions, document WAKE_WORDS config

README no longer lists PICOVOICE_TOKEN as a required key, and the
configuration section explains the new WAKE_WORDS tuple.

2026-04-22 17:48:15 +03:00

4.2 KiB

Raw Blame History

J.A.R.V.I.S (Python) — Bossiara13's fork

Голосовой ассистент для Windows с wake-word «jarvis». Распознаёт речь локально через Vosk (русская модель), отвечает голосом через Silero TTS, а свободные вопросы (фразы, начинающиеся со слова «скажи …») отправляет в LLM на Groq и зачитывает ответ.

Это форк

Форк репозитория Priler/jarvis (автор оригинала — Abraham Tugalov, 2022). Лицензия наследуется: CC BY-NC-SA 4.0 (см. LICENSE.txt).

Что отличается от оригинала

Из истории удалены случайно закоммиченные секреты.
Бэкенд LLM переключён с OpenAI на Groq (бесплатный тариф) через openai-совместимый API.
Код обновлён под новую версию SDK openai (>=1.0); старый pre-1.0 интерфейс был сломан.
Убрана зависимость от Picovoice Porcupine — wake-word распознаётся напрямую через Vosk с grammar-constraint (второй KaldiRecognizer со словарём из WAKE_WORDS). Ключ Picovoice больше не нужен.
Обновлена ветка/тэги (dev, v0.0.1-import), причёсан README и requirements.txt.

Установка

Требуется Python 3.11 (на 3.13 ряд зависимостей пока ставится с бубном).

git clone https://github.com/DmitryBykov-ISPO/J.A.R.V.I.S-py.git
cd J.A.R.V.I.S-py
py -3.11 -m venv .venv
.venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt

Скопируйте dev.env.example в dev.env и заполните ключ:

GROQ_TOKEN — бесплатно на console.groq.com.

Vosk-модель для русского языка лежит в model_small/ (уже в репозитории). Запуск:

python main.py

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

config.py:
- MICROPHONE_INDEX = -1 — индекс микрофона (-1 означает устройство по умолчанию). Если микрофонов несколько и берётся не тот, поменяйте число.
- WAKE_WORDS = ('jarvis', 'джарвис') — варианты транскрипции wake-word, которые принимает Vosk. Если ваш голос/акцент стабильно расшифровывается как, например, жарвис — добавьте этот вариант сюда (всё в нижнем регистре).
- GROQ_MODEL — имя модели Groq (по умолчанию llama-3.3-70b-versatile).
commands.yaml — набор голосовых команд и их вариантов для fuzzy-матчинга.
custom-commands/ — скомпилированные AHK-скрипты под конкретный сетап автора оригинала (переключение мониторов, управление Яндекс.Музыкой и т.п.). На вашей машине большая часть из них работать не будет, но ассистент запустится в любом случае.

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

Скажите «Джарвис» (или «jarvis») — ассистент даст звуковой сигнал готовности.
В течение 10 секунд произнесите команду:
- либо одну из фраз из commands.yaml (открыть браузер, выключить звук и т.д.);
- либо начните со слова «скажи …» — остаток фразы уйдёт в Groq, ответ будет зачитан вслух.

Лицензия

CC BY-NC-SA 4.0 — см. LICENSE.txt. Авторство оригинала — Abraham Tugalov / Priler. Изменения в этом форке — Bossiara13 (Dmitry Bykov), 2026.

4.2 KiB Raw Blame History Unescape Escape