Alexander Smart Speaker

Голосовой ассистент для Linux с wake word, STT/TTS и набором голосовых навыков.

Что умеет

Активация по ключевому слову Alexandr.
Диалог с AI (Perplexity) с сохранением контекста.
Перевод RU ↔ EN с озвучиванием.
Погода по умолчанию и по названию города.
Будильники, таймеры и секундомеры.
Управление громкостью системы.
Управление Spotify (play/pause/next/current track).
Игра в города.

Технологии

Wake word: pvporcupine
STT: deepgram-sdk
TTS: Silero (torch, torchaudio)
AI: Perplexity API
Погода: Open-Meteo
Музыка: Spotify Web API (spotipy)

Требования

Linux
Python 3.9+
Системные пакеты:

sudo apt-get update
sudo apt-get install -y portaudio19-dev libasound2-dev mpg123

Для управления громкостью нужен pactl или amixer (обычно из pulseaudio-utils/alsa-utils).

Установка

git clone https://github.com/your-username/alexander_smart-speaker.git
cd alexander_smart-speaker

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Настройка `.env`

cp .env.example .env

Минимально обязательные переменные:

PERPLEXITY_API_KEY=...
DEEPGRAM_API_KEY=...
PORCUPINE_ACCESS_KEY=...

Полный пример (как в .env.example):

PERPLEXITY_API_KEY=your_perplexity_api_key_here
PERPLEXITY_MODEL=llama-3.1-sonar-small-128k-chat
DEEPGRAM_API_KEY=your_deepgram_api_key_here
PORCUPINE_ACCESS_KEY=your_porcupine_access_key_here
PORCUPINE_SENSITIVITY=0.8
TTS_EN_SPEAKER=en_0
WEATHER_LAT=63.56
WEATHER_LON=53.69
WEATHER_CITY=Ухта
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888/callback

Запуск

make run
# или
python run.py

Примеры голосовых команд

Активация: Alexandr
Диалог: Почему небо голубое?
Погода: Какая сейчас погода?, Погода в Москве
Перевод: Переведи на английский: как дела
Таймер: Поставь таймер на 5 минут
Будильник: Поставь будильник на 7:30, Будильник по будням в 8:00
Секундомер: Запусти секундомер, Покажи активные секундомеры
Громкость: Громкость 5
Spotify: Включи музыку, Пауза, Что сейчас играет
Игра: Давай сыграем в города
Остановка/прерывание: Стоп, Хватит, Повтори

Полезные команды

make run          # запуск ассистента
make check        # базовая проверка проекта
make qwen-context # собрать контекст проекта

Структура проекта

run.py - точка входа.
app/main.py - главный цикл ассистента.
app/audio/ - wake word, STT, TTS, громкость.
app/core/ - конфиг, AI, роутинг команд, утилиты.
app/features/ - погода, будильник, таймер, секундомер, музыка, города.
assets/ - модели и звуки.
data/ - сохраненные будильники/таймеры/секундомеры.

Диагностика проблем

Ошибки STT/AI: проверьте ключи в .env.
Нет звука: проверьте системное устройство вывода и утилиты pactl/amixer.
Не играет будильник/таймер: убедитесь, что установлен mpg123.
Spotify не управляется: проверьте SPOTIFY_*, авторизацию и наличие активного устройства.

Лицензия

MIT, см. LICENSE.txt.

4.3 KiB Raw Blame History Unescape Escape