requirements.txt

fastapi==0.115.14
uvicorn[standard]==0.30.1
sqlalchemy==2.0.31
aiosqlite==0.20.0
pydantic==2.7.4
pydantic-settings==2.3.4
httpx==0.27.0
docker==7.1.0
cryptography==46.0.6
qrcode[pil]==7.4.2
bcrypt==4.1.3
aiofiles==23.2.1
sse-starlette==2.1.3
python-multipart==0.0.9
pyyaml==6.0.2
python-dotenv==1.0.1
slowapi==0.1.9
pywebpush==2.0.0
psutil==6.0.0
numpy>=1.22.2,<2
pyaudio==0.2.14
python-vlc>=3.0.20115
websockets>=12.0
num2words==0.5.14
apscheduler>=3.10  # used by scheduler + clock modules for cron/date triggers

# Piper TTS runs INSIDE the container. start.sh supervises piper-server.py
# as a subprocess on :5100 (network_mode: host passes it through). aiohttp
# is piper-server's HTTP framework. See scripts/piper-server.py and
# system_modules/voice_core/tts.py.
piper-tts>=1.2.0
aiohttp>=3.9

# HuggingFace tokenizers — fast Rust-based tokenizer for the ONNX
# embedding model (all-MiniLM-L6-v2). Tiny (~2 MB wheel), no PyTorch.
tokenizers>=0.15.0

# Vosk STT (Vosk model files live under /var/lib/selena/models/vosk)
vosk>=0.3.45

# Local translation (Argos Translate — offline, ~50-100 MB per language pair).
# argostranslate is installed SEPARATELY in Dockerfile.core with --no-deps
# because its declared deps (stanza, spacy, minisbd) transitively pull
# ~2 GB of PyTorch + CUDA wheels that we never use. The Helsinki translator
# only touches argostranslate's ctranslate2 + sentencepiece primitives.
# For local dev OUTSIDE Docker install argostranslate manually:
#     pip install --no-deps "argostranslate>=1.9.0"
#     pip install sentencepiece ctranslate2 sacremoses
# argostranslate>=1.9.0   # DO NOT re-add — see note above

# Smart device drivers (used by system_modules/device_control)
tinytuya>=1.13.0             # Tuya local LAN protocol (push events via persistent socket)
tuya-device-sharing-sdk>=0.2  # Tuya Smart Life / Tuya Smart OAuth via user-code (no developer account needed)
greeclimate>=2.1             # Gree / Pular WiFi A/C local LAN protocol (UDP 7000, AES, async)

# Optional: Zigbee scanner (system_modules/network_scanner/zigbee_scanner.py).
# Only required if a USB Zigbee coordinator dongle is plugged in. Install
# manually when needed:
#   pip install 'zigpy>=0.60' 'zigpy-znp>=0.12'   # for TI CC2531/CC2652 dongles
#   pip install 'zigpy>=0.60' 'bellows>=0.39'     # for Silicon Labs EZSP dongles
# The scanner gracefully degrades to an empty result when these are absent.

# Pinned transitive dependencies (security)
h11>=0.16.0
anyio>=4.4.0
starlette>=0.40.0,<0.41.0
zipp>=3.19.1
requests>=2.33.0 # not directly required, pinned by Snyk to avoid a vulnerability
urllib3>=2.6.3 # not directly required, pinned by Snyk to avoid a vulnerability