Deployment Principles

Version {{ version }}

Fail-Fast Config

Required environment variables with no fallbacks. The app fails immediately if configuration is missing, making issues obvious from the start.

📦

Version Management

Single source of truth in the VERSION file. Version is displayed in the UI and included in API responses for tracking deployments.

🔄

Single-Server Architecture

Flask serves both frontend and API on the same server. No CORS needed, simpler deployment, relative API paths work seamlessly.

🐍

UV Environment

Virtual environments are never synced, always recreated using UV. UV automatically installs Python 3.12+ if needed on the server.

Server Running