Python Example

This example uses no built-in Python template. The orchestrator uses a repo-owned docker-compose.preview.yml (or docker-compose.preview.yaml) in the repository root and injects host ports for the app and db so nginx can route correctly.

Repository

Repo: python-project-preview-example — replace with your repo URL when published.

Stack

Framework: FastAPI (Python)
Database: PostgreSQL (async, SQLAlchemy)
Cache: Redis
Config: .env (DATABASE_URL, REDIS_URL)
Health: GET /health (DB + Redis status)
Endpoints: GET /, GET /docs, GET /items, GET /admins, etc.
Seeder: python -m scripts.seed_admin (optional, run separately or in startup)

Key files

`docker-compose.preview.yml` (repository root) — required

For Python there is no built-in template, so you must provide a preview compose file. Use service names app and db; do not set host ports—the orchestrator injects them. Example structure (adjust image/build and env to match your repo):

services:
  app:
    build: .
    ports: []   # Orchestrator injects host port
    environment:
      - DATABASE_URL=postgresql+asyncpg://preview:preview@db:5432/pr_${PR_NUMBER}
      - REDIS_URL=redis://redis:6379/0
    depends_on:
      - db
      - redis
  db:
    image: postgres:16-alpine
    # No host ports; orchestrator injects
    environment:
      POSTGRES_USER: preview
      POSTGRES_PASSWORD: preview
      POSTGRES_DB: pr_${PR_NUMBER}
  redis:
    image: redis:7-alpine

The orchestrator writes docker-compose.preview.generated.yml with the injected ports and runs docker compose against that file.

`preview-config.yml` (repository root) — required

You must add preview-config.yml with all required fields. Set framework: python so the orchestrator knows the app port and entrypoint; when you provide docker-compose.preview.yml, the orchestrator still uses it for compose and uses preview-config.yml for validation, health check path, and optional build/startup commands.

framework: python
database: postgres
health_check_path: /health
app_port: 8000
app_port_env: PORT
app_entrypoint: app.main:app
# Optional:
# build_commands:
#   - cp .env.example .env
# startup_commands:
#   - python -m scripts.seed_admin
# env:
#   - NODE_ENV=preview

Local run and API

See the repo README for:

Venv, pip install -r requirements.txt
DATABASE_URL, REDIS_URL in .env
python -m scripts.seed_admin, uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Endpoints: /health, /docs, /items, /admins, etc.

​Repository

​Stack

​Key files

​docker-compose.preview.yml (repository root) — required

​preview-config.yml (repository root) — required

​Local run and API