Production Deployment

Overview

Chirp apps run on Pounce, a production-grade ASGI server with enterprise features built-in.

Phase 5 (Automatic)

• WebSocket compression — 60% bandwidth reduction
• HTTP/2 support — Multiplexed streams, server push
• Graceful shutdown — Finishes active requests on SIGTERM
• Zero-downtime reload —kill -SIGUSR1for hot code updates
• OpenTelemetry — Distributed tracing (configurable)

Phase 6 (Configurable)

• Prometheus metrics —/metricsendpoint for monitoring
• Per-IP rate limiting — Token bucket algorithm
• Request queueing — Load shedding during traffic spikes
• Sentry integration — Error tracking and reporting
• Hot reload — Zero-downtime worker replacement

Quick Start

Development Mode

from chirp import App, AppConfig

app = App(AppConfig(debug=True))

@app.route("/")
def index():
    return "Hello!"

app.run()  # Single worker, auto-reload

Production Mode

from chirp import App, AppConfig

config = AppConfig(
    debug=False,
    secret_key="your-secret-key-here",
    workers=4,
    metrics_enabled=True,
    rate_limit_enabled=True,
)

app = App(config=config)

@app.route("/")
def index():
    return "Hello, Production!"

app.run()  # Multi-worker, Phase 5 & 6 features

CLI Production Mode

chirp run myapp:app --production --workers 4 --metrics --rate-limit

Custom Port Checks

If your CLI checks whether a port is free before callingapp.run() (e.g. to avoid split-brain or show a clearer error), use SO_REUSEADDR in that check. Otherwise you'll block restarts when the port is in TIME_WAIT (30–120 seconds after shutdown). The server already uses SO_REUSEADDR; your check should match.

import socket

def is_port_in_use(host: str, port: int) -> bool:
    """Return True if another process is actively listening on host:port."""
    try:
        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
            s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
            s.bind((host, port))
            return False
    except OSError:
        return True

Without SO_REUSEADDR, the check fails when the port is in TIME_WAIT even though the server would bind successfully. When you can't identify the process holding the port, include a TIME_WAIT hint in your error message (e.g. "wait 30–60s or use a different port").

Docker

FROM python:3.14-slim
WORKDIR /app
COPY . .
RUN pip install bengal-chirp
CMD ["chirp", "run", "myapp:app", "--production", "--workers", "4"]

Configuration

Full Guide

For detailed deployment instructions, TLS setup, Kubernetes, and advanced configuration, see the full deployment guide in the repository:

docs/deployment/production.md