Полностью переведена вся документация в docs/: - docs/architecture/overview.md — Архитектура Wyoming Satellite - docs/settings-cheatsheet.md — Шпаргалка по настройкам (CLI флаги) - docs/deployment/systemd-services.md — Настройка systemd сервисов - docs/integration/mqtt-led.md — MQTT LED управление - docs/integration/vad-wakeword.md — Уже был на русском - docs/tutorials/2mic-hat.md — Tutorial для 2-MIC HAT - docs/tutorials/installer.md — Интерактивный установщик - docs/README.md — Индекс документации Обновлены корневые файлы: - README.md — Полностью на русском - DEPLOY.md — Полностью на русском Вся документация теперь на русском языке для удобства русскоязычных пользователей. Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
3.8 KiB
3.8 KiB
Руководство по развёртыванию
Быстрый старт для развёртывания Wyoming Satellite.
Быстрый старт
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. Запуск сервисов
# LED управление (опционально, требуется ReSpeaker)
sudo systemctl enable --now wyoming-event.service
# Wyoming Satellite
sudo systemctl enable --now wyoming-satelite-vosk.service
# Детекция wake word (Vosk)
sudo systemctl enable --now wyoming-wakeword-vosk.service
4. Проверка
sudo systemctl status wyoming-satelite-vosk.service
journalctl -u wyoming-satelite-vosk.service -f
В Home Assistant: Настройки → Устройства и сервисы → Найдено → Wyoming Satellite → Настроить
Полная документация
| Руководство | Описание |
|---|---|
| systemd сервисы | Детальная настройка сервисов |
| Tutorials | Пошаговые руководства для разного оборудования |
| Архитектура | Как работает Wyoming Satellite |
| MQTT LED | LED управление с Home Assistant |
| Настройки | Шпаргалка по всем 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 управления)
Обзор сервисов
| Сервис | Порт | Описание |
|---|---|---|
wyoming-satelite-vosk.service |
10700 | Основной Wyoming спутник |
wyoming-wakeword-vosk.service |
10400 | Детекция wake word (Vosk) |
wyoming-event.service |
10500 | LED управление + MQTT события |
Конфигурация
Файлы сервисов используют плейсхолдеры, которые автоматически заменяются при установке:
| Плейсхолдер | Описание |
|---|---|
__SAT_BASE_DIR__ |
Путь к репозиторию Satellite |
__SAT_VENV__ |
Путь к виртуальному окружению |
__CURRENT_USER__ |
Имя текущего пользователя |
__HOME_DIR__ |
Домашняя директория пользователя |
Wake words (русские)
Отредактируйте start_satellite.sh:
--wake-word-name "привет дроид"
--wake-word-name "привет придурок"
--wake-word-name "привет жопа с ушами"