docs/deployment.md

Deployment

Hugging Face Space

• Space repo: https://huggingface.co/spaces/KPrashanth/agent-tina
• Live app: https://kprashanth-agent-tina.hf.space/
• SDK: Docker
• App port: 7860
• Runtime status last verified: RUNNING on 2026-06-08
• Dataset repo: https://huggingface.co/datasets/KPrashanth/agent-tina-meetings
• End-to-end meeting creation, transcription, correction, MoM generation, downloads, and Dataset persistence verified on 2026-06-08

Local Deployment Script

Run:

.\.venv\Scripts\python.exe scripts\deploy_hf_space.py

The script:

• reads credentials from .env
• creates or updates the Space
• uploads project files
• ignores .env, .venv, caches, bytecode, and sample.wav
• configures Space variables/secrets

Required .env Values

HF_TOKEN=...
HF_SPACE_NAME=agent-tina
HF_APP_BASE_URL=https://kprashanth-agent-tina.hf.space
HF_DATASET_REPO=KPrashanth/agent-tina-meetings
OPENROUTER_API_KEY=...
OPENROUTER_MODEL=openai/gpt-oss-20b
OPENROUTER_CORRECTION_MODEL=openai/gpt-4o-mini
WHISPER_MODEL=base
WHISPER_BEAM_SIZE=5
MAX_UPLOAD_MB=250

Space Secrets and Variables

Secret:

• OPENROUTER_API_KEY
• HF_TOKEN

Variables:

• OPENROUTER_MODEL
• OPENROUTER_CORRECTION_MODEL
• WHISPER_MODEL
• WHISPER_BEAM_SIZE
• MAX_UPLOAD_MB
• APP_BASE_URL
• HF_DATASET_REPO

Important Constraint

Hugging Face Space disk may be ephemeral unless persistent storage is enabled. The app optionally syncs meeting folders to HF_DATASET_REPO when HF_TOKEN and HF_DATASET_REPO are configured.

After a Space rebuild, meeting metadata is restored from the private Dataset on demand. Large original recordings and Markdown outputs are restored lazily only when requested.

Post-rebuild metadata and original-audio recovery were verified on 2026-06-09.