Deployment

Build & Run

bun run build
bun run start

The server starts on the port defined by PORT (default 3000).

Volumes & Persistence

Path	Purpose
data/posts.db	SQLite database (processed posts, pipeline runs)
data/browser-state/	Camoufox session cookies
output/	Generated MP4 files
assets/backgrounds/	Background loop videos
assets/music/	Background music tracks
assets/hooks/	Hook sound effects

System Requirements

• FFmpeg — required for video composition
• CMake + build tools — required for native ONNX runtime compilation
• Disk space — background videos + output can grow; implement rotation as needed
• RAM — Kokoro ONNX model loads ~200MB at q8 quantization

Monitoring

The dashboard is available at http://<host>:<port>/dashboard.

Health checks:

• GET /health — basic uptime
• GET /health/browser — Camoufox readiness
• GET /health/tts — Kokoro model loaded