Quickstart

Serve your first ASGI application with Pounce

1 min read 222 words

Create an ASGI App

Create a file calledapp.py:

async def app(scope, receive, send):
    """Minimal ASGI application."""
    assert scope["type"] == "http"

    await send({
        "type": "http.response.start",
        "status": 200,
        "headers": [
            [b"content-type", b"text/plain"],
        ],
    })
    await send({
        "type": "http.response.body",
        "body": b"Hello from Pounce!",
    })

Serve It

pounce app:app

import pounce

pounce.run("app:app")

Openhttp://127.0.0.1:8000in your browser. You should see "Hello from Pounce!".

Configure Workers

On Python 3.14t (free-threading), workers are threads. On GIL builds, workers are processes. The API is the same:

# Auto-detect worker count (based on CPU cores)
pounce app:app --workers 0

# Explicit 4 workers
pounce app:app --workers 4

Enable Development Reload

pounce app:app --reload

Pounce watches your source files and restarts workers automatically when changes are detected.

Add Protocol Extras

# HTTP/2 + WebSocket
pounce app:app  # after: pip install bengal-pounce[h2,ws]

# TLS termination
pounce app:app --ssl-certfile cert.pem --ssl-keyfile key.pem

App Factory Pattern

Pounce supports the app factory pattern with callable syntax:

pounce myapp:create_app()

This calls create_app() in the myappmodule and uses the returned ASGI application.

Next Steps