README — VoskWyoming Satellite
Удалённый голосовой спутник, использующий Wyoming protocol для Home Assistant.
Возможности
- 🏠 Интеграция с Home Assistant — Нативная поддержка Wyoming протокола
- 🎤 Локальная детекция wake word — Vosk, русские фразы ("привет дроид" и др.)
- 🔇 Аудио улучшения — Шумоподавление WebRTC и автоматическое усиление
- 💡 MQTT LED управление — ReSpeaker XVF3800 4-MIC с авто-обнаружением HA
- 🎯 Voice Activity Detection — Silero или WebRTC VAD для приватной работы
Быстрый старт
1. Установка
git clone <repository-url> ~/projects/Satellite
cd ~/projects/Satellite
python3 -m venv ~/.venv_satellite
source ~/.venv_satellite/bin/activate
pip install -r requirements.txt
2. Установка systemd сервисов
sudo ./install_systemd_services.sh
3. Запуск
sudo systemctl enable --now wyoming-satelite-vosk.service
sudo systemctl status wyoming-satelite-vosk.service
В Home Assistant: Настройки → Устройства и сервисы → Найдено → Wyoming Satellite → Настроить
Документация
| Руководство | Описание |
|---|---|
| Развёртывание | Полное руководство по развёртыванию |
| Tutorials | Пошаговые руководства для разного оборудования |
| Архитектура | Как работает Wyoming Satellite |
| MQTT LED | LED управление с Home Assistant |
| VAD/Wake интеграция | Техническое руководство |
| Настройки | Шпаргалка по CLI флагам |
Tutorials
- 2-MIC HAT — Raspberry Pi + ReSpeaker 2-MIC HAT
- Установщик — Интерактивный установщик
Требования
- Python 3.9+
- Linux (протестировано на Raspberry Pi OS)
- Микрофон (USB или HAT)
- Опционально: ReSpeaker XVF3800 USB 4-MIC Array (для LED управления)
Структура проекта
Satellite/
├── wyoming_satellite/ # Основной Python пакет
├── examples/ # Примеры скриптов (LED, MQTT, конфиги)
├── services/ # systemd сервис файлы
├── docs/ # Документация
│ ├── tutorials/ # Руководства по оборудованию
│ ├── integration/ # Технические руководства
│ ├── deployment/ # Руководства по развёртыванию
│ └── architecture/ # Документация по архитектуре
├── sounds/ # Аудио файлы (awake.wav и др.)
├── scripts/ # Вспомогательные скрипты
└── tests/ # Юнит тесты
Конфигурация
Wake words (русские)
Отредактируйте start_satellite.sh:
--wake-word-name "привет дроид"
--wake-word-name "привет придурок"
--wake-word-name "привет жопа с ушами"
Аудио настройки
--mic-noise-suppression 2
--mic-auto-gain 5
VAD настройки
--vad
--vad-system webrtc
--vad-threshold 0.5
Разработка
# Линтинг
pylint wyoming_satellite/
mypy wyoming_satellite/
# Тесты
pytest tests/
# Форматирование
black wyoming_satellite/
isort wyoming_satellite/
Видео уроки
Внешние ресурсы
License
Этот проект является частью экосистемы Open Home Foundation.