Handoff: полный набор зависимостей для нового ПК (torch CPU, silero-vad, readchar) + инструкция установки

2026-09-11 19:49:21 +03:00
parent 32754a1fe2
commit 82e0fa7ca2
2 changed files with 42 additions and 6 deletions
@@ -67,12 +67,42 @@ HOTKEY_DIALOG=space, HOTKEY_TALK=num 0, HOTKEY_STOP=esc, HOTKEY_REPEAT=enter.
 ## Окружение (на этой машине)

 - .venv на python3.13 (Debian: venv без pip — ставить `python3 -m pip --python .venv install ...`).
- torch 2.14.0+cpu, torchaudio 2.11.0+cpu (CPU-варианты!), silero-vad 6.2.1, faster-whisper 1.2.1,
-  edge-tts 7.2.8, piper-tts 1.8.0, sounddevice 0.5.6 (Linux: нужен apt-пакет libportaudio2),
-  keyboard 0.13.5, readchar 4.2.2, openai 3.13.0.
 - Модели: ~/.cache/huggingface (whisper small), models/piper/ (121 МБ).
 - Первый старт whisper качает модель ~460 МБ (если HF недоступен: HF_ENDPOINT=https://hf-mirror.com).

+## Установка на новом компьютере (полный набор, проверенный)
+
+```bash
+# 1. Клонировать и окружение
+git clone <репозиторий> && cd Blind
+python3 -m venv .venv && source .venv/bin/activate
+cp .env.example .env   # и вписать реальный OPENROUTER_API_KEY (и WAKE_WORD при желании)
+
+# 2. Основные зависимости
+pip install -r requirements.txt
+
+# 3. Linux: системный PortAudio (звук)
+sudo apt install -y libportaudio2
+
+# 4. torch/клиент для Silero-VAD — СТРОГО CPU (GPU-пакеты 2.5 ГБ не нужны):
+pip install --index-url https://download.pytorch.org/whl/cpu torch
+pip install --index-url https://download.pytorch.org/whl/cpu torchaudio --force-reinstall --no-deps
+
+# 5. Whisper-модель скачается при первом запуске (~460 МБ, кэш ~/.cache/huggingface)
+# 6. Голос Piper (если TTS_PROVIDER=piper):
+python -m piper.download_voices ru_RU-dmitri-medium --download-dir models/piper
+
+# 7. Куи-файлы уже в git (assets/earcons/*.wav); перегенерация после смены голоса:
+python assets/earcons/generate_cues.py --force
+
+# 8. Проверка:
+python modules/assistant/test_free.py   # «Марта» → диалог → «До свидания»
+```
+
+Прокси (OPENROUTER_PROXY=http://192.168.0.246:8887) работает только в LAN юзера —
+вне его сети понадобится VPN/другой egress, иначе openai/* и часть источников недоступны
+(gemma-3-27b и glm работают из РФ напрямую, проверено).
+
 ## Как запускать (проверенные команды)

 ```bash