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

docs/HANDOFF.md

@@ -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

requirements.txt

@@ -10,12 +10,18 @@ numpy>=1.26
 # Модуль 1: STT (речь → текст)
 faster-whisper==1.2.1
 
+# Модуль 5: клавиши и свободный режим
+keyboard==0.13.5         # глобальные клавиши (Windows; на Linux требует root)
+readchar==4.2.2          # одиночные клавиши в консоли без root (пробел без Enter)
+
+# Silero-VAD требует torch. СТАВИТЬ ТОЛЬКО 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
+silero-vad==6.2.1        # после torch (см. команды выше)
+
 # Модуль 4: brain (LLM через OpenRouter)
 openai>=3.13
 httpx>=0.27              # http_client с прокси для OpenAI-клиента
 
-# Модуль 5: глобальные клавиши (Windows; на Linux требует root — тест через console-бэкенд)
-keyboard==0.13.5
-
 # Дальше зависимости добавляются по мере готовности следующих модулей:
 # aiogram>=3    # Модуль 6 (Telegram)