smart-speaker/QWEN.md

Qwen Context: alexander_smart-speaker

Goal

Voice assistant for Linux with wake word, STT/TTS, AI dialogue, weather, timer/alarm/stopwatch and volume control.

Architecture

• Entry: run.py -> app/main.py
• Audio layer: app/audio/ (wakeword.py, stt.py, tts.py, sound_level.py)
• Core logic: app/core/ (commands.py, ai.py, config.py, cleaner.py)
• Features: app/features/ (weather, timer, stopwatch, alarm, music, cities game)
• State: data/*.json

High-Value Files

• app/core/commands.py for intent routing
• app/main.py for event loop and orchestration
• app/core/config.py for env configuration

How To Work In This Repo

1. Keep edits minimal and local.
2. Prefer fixes with clear fallback behavior (microphone/API failures).
3. Do not hardcode secrets; use .env and .env.example.
4. Update README when behavior/commands change.

Quick Checks

./scripts/qwen-check.sh

Notes For Agent

• If touching audio code, keep Linux compatibility first.
• For command parsing, add/adjust tests when test infra exists.
• Preserve Russian command phrases compatibility.