.env.example

# OpenSpeakers Environment Configuration
# Copy to .env and edit as needed.
#
# QUICK START:
#   cp .env.example .env
#   ./scripts/download-models.sh
#   docker compose up -d --build
#
# Database migrations run automatically on backend startup — no separate command needed.

# ─── Docker Compose Files ─────────────────────────────────────────────────────
# Tells `docker compose` which files to load automatically.
# Change to docker-compose.offline.yml for air-gapped installs.
COMPOSE_FILE=docker-compose.yml:docker-compose.override.yml:docker-compose.gpu.yml

# ─── Database ────────────────────────────────────────────────────────────────
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_DB=openspeakers
POSTGRES_USER=openspeakers
POSTGRES_PASSWORD=openspeakers

# ─── Redis ────────────────────────────────────────────────────────────────────
REDIS_HOST=redis
REDIS_PORT=6379
# REDIS_PASSWORD=

# ─── Celery ───────────────────────────────────────────────────────────────────
CELERY_BROKER_URL=redis://redis:6379/0
CELERY_RESULT_BACKEND=redis://redis:6379/1

# ─── GPU ──────────────────────────────────────────────────────────────────────
# GPU device to use for TTS inference (0-indexed).
# A6000: 0 or 2 (48 GB each). 3080 Ti: 1 (12 GB).
GPU_DEVICE_ID=0
GPU_DEVICE=cuda

# ─── Model Cache ──────────────────────────────────────────────────────────────
# Where HuggingFace models are downloaded and cached.
# IMPORTANT: Must be owned by UID 1000 (container user) on the host.
MODEL_CACHE_DIR=./model_cache

# ─── Audio Output ─────────────────────────────────────────────────────────────
# Where generated audio files are stored.
AUDIO_OUTPUT_DIR=./audio_output

# ─── Service Ports ────────────────────────────────────────────────────────────
BACKEND_PORT=8080
FRONTEND_PORT=5200

# ─── Application ──────────────────────────────────────────────────────────────
ENVIRONMENT=development
SECRET_KEY=change_this_to_a_random_secret_key_in_production
LOG_LEVEL=INFO

# ─── Enabled Models ───────────────────────────────────────────────────────────
# Comma-separated list of model IDs to make available.
# Leaving empty enables all registered models.
ENABLED_MODELS=

# ─── VibeVoice ────────────────────────────────────────────────────────────────
VIBEVOICE_MODEL_PATH=microsoft/VibeVoice-Realtime-0.5B
# Alternatively use a local path: VIBEVOICE_MODEL_PATH=/models/VibeVoice-Realtime-0.5B

# ─── Fish Speech ──────────────────────────────────────────────────────────────
FISH_SPEECH_MODEL_PATH=fishaudio/s2-pro

# ─── Qwen3 TTS ────────────────────────────────────────────────────────────────
QWEN3_TTS_MODEL_PATH=Qwen/Qwen3-TTS

# ─── Kokoro ───────────────────────────────────────────────────────────────────
KOKORO_MODEL_PATH=hexgrad/Kokoro-82M

# ─── HuggingFace Token ────────────────────────────────────────────────────────
# Required for gated models (Orpheus 3B at canopylabs/orpheus-3b-0.1-ft).
# Create a token at https://huggingface.co/settings/tokens and accept the
# model license at https://huggingface.co/canopylabs/orpheus-3b-0.1-ft
# Leave blank to skip Orpheus — other 10 models work without a token.
HF_TOKEN=