Files
satellite/DEPLOY.md
T
sirmrakandQwen-Coder 61b1532757 docs: перевод документации на русский язык
Полностью переведена вся документация в 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>
2026-05-19 23:25:34 +03:00

3.8 KiB
Raw Blame History

Руководство по развёртыванию

Быстрый старт для развёртывания 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 "привет жопа с ушами"

Внешние ресурсы