# Pounce

> A free-threading-native ASGI server for Python 3.14t

## Overview

- [Pounce](/pounce/): A Python ASGI server for deployments, streaming responses, and free-threaded Python

## Documentation

- [Documentation](/pounce/docs/): Documentation for running, deploying, and tuning the Pounce Python ASGI server

## Releases

- [0.1.0](/pounce/releases/0.1.0/): Initial release — free-threading-native ASGI server with HTTP/2, WebSocket, TLS, and multi-worker
- [0.2.0](/pounce/releases/0.2.0/): Production grade security, static files, observability, and developer experience
- [0.2.1](/pounce/releases/0.2.1/): HTTP/3 backend switch to zoomies for free-threading compatibility
- [0.2.2](/pounce/releases/0.2.2/): Sync worker mode, CPU affinity, per-worker executor, httptools removed
- [0.3.0](/pounce/releases/0.3.0/): Multi-worker sync performance — matching uvicorn at 30k req/s, pure Python
- [0.3.1](/pounce/releases/0.3.1/): Public error type exports for downstream consumers
- [0.4.0](/pounce/releases/0.4.0/): First-class testing API, graceful shutdown overhaul, thread-safety fixes
- [0.5.0](/pounce/releases/0.5.0/): Elm Architecture lifecycle, milo-cli adoption, bench command, modern Python 3.14t patterns
- [0.5.1](/pounce/releases/0.5.1/): Fork-context fix for process workers, dependency updates, startup banner redesign
- [0.6.0](/pounce/releases/0.6.0/): Subinterpreter workers, RFC 9842 compression dictionaries, sendfile, framework compat tests, and 60+ fixes
- [0.7.0](/pounce/releases/0.7.0/): Release-readiness hardening for protocols, config discovery, operator diagnostics, and production-shaped benchmark coverage
- [0.7.1](/pounce/releases/0.7.1/): Patch release for HTTP/1 sendfile ownership, public-contract guardrails, and benchmark proof artifacts
- [0.8.1](/pounce/releases/0.8.1/): Patch release for HTTP/3 reload/drain parity, the subinterpreter FD leak fix, shared request-pipeline consolidation, and the drain benchmark profile
- [0.8.2](/pounce/releases/0.8.2/): Patch release for correct HEAD responses, drain-aware health checks, built-in endpoint parity, reliable threaded reloads, and high-value CLI flags
- [0.9.0](/pounce/releases/0.9.0/): Minor release for stable subinterpreter web workers, bounded stream and timeout lifecycle, protocol hardening, and deployment-backed evidence
- [0.9.1](/pounce/releases/0.9.1/): Patch release for stable readiness responses during drain, async shutdown cleanup, metadata-derived CLI help, and release tooling
- [0.9.2](/pounce/releases/0.9.2/): Patch release preventing large buffered HTTP/1 responses from truncating under downstream backpressure
- [Releases](/pounce/releases/): Pounce release notes and changelog

## About

- [About](/pounce/docs/about/): Architecture, performance, thread model, and comparison guidance for the Pounce Python ASGI server
- [Architecture](/pounce/docs/about/architecture/): How Pounce's server, supervisor, and worker layers fit together
- [When to Use Pounce](/pounce/docs/about/comparison/): When Pounce fits, how it differs from process-based ASGI servers, and when to consider alternatives
- [The Bengal Ecosystem](/pounce/docs/about/ecosystem/): A structured reactive stack — every layer written in pure Python for 3.14t free-threading
- [FAQ](/pounce/docs/about/faq/): Frequently asked questions about Pounce
- [Free-Threading Patterns](/pounce/docs/about/nogil-patterns/): Ten architectural patterns for building concurrent Python 3.14t applications
- [Performance](/pounce/docs/about/performance/): What makes Pounce fast and how the streaming-first design works
- [Thread Safety](/pounce/docs/about/thread-safety/): How Pounce handles shared state across workers on free-threading builds

## Configuration

- [Configuration](/pounce/docs/configuration/): ServerConfig, CLI options, TLS, and display settings
- [CLI Reference](/pounce/docs/configuration/cli/): Command-line options for the pounce command
- [Display & Signage](/pounce/docs/configuration/display/): Application banner, startup display, and signage modes
- [ServerConfig](/pounce/docs/configuration/server-config/): The frozen dataclass that controls all server behavior
- [TLS](/pounce/docs/configuration/tls/): Setting up TLS termination for HTTPS and HTTP/2

## Deployment

- [Deployment](/pounce/docs/deployment/): Workers, compression, security, and production configuration
- [Backpressure](/pounce/docs/deployment/backpressure/): Rate limiting and request queueing for load protection
- [Compression](/pounce/docs/deployment/compression/): Zstd and gzip content-encoding with zero external dependencies
- [Framework Embedding](/pounce/docs/deployment/embedding/): Minimum production contract for frameworks that launch Pounce directly
- [Server Lifecycle](/pounce/docs/deployment/lifecycle/): Graceful reload and shutdown with connection draining
- [Observability](/pounce/docs/deployment/observability/): Health checks, request tracing, Prometheus metrics, OpenTelemetry, and Sentry
- [Production](/pounce/docs/deployment/production/): Running Pounce in production environments
- [Railway](/pounce/docs/deployment/railway/): Deploying Pounce on Railway public networking
- [Security](/pounce/docs/deployment/security/): Built-in security features for production deployments
- [Workers](/pounce/docs/deployment/workers/): Configuring worker count and understanding thread vs process mode

## Extending

- [Extending](/pounce/docs/extending/): ASGI bridge internals and protocol handler interface
- [ASGI Bridge](/pounce/docs/extending/asgi-bridge/): How Pounce translates protocol events to the ASGI interface

## Features

- [Features](/pounce/docs/features/): Built-in features beyond core protocol support
- [Development Error Pages](/pounce/docs/features/error-pages/): Rich HTML error pages with syntax highlighting for debugging
- [Lifecycle Logging](/pounce/docs/features/lifecycle-logging/): Structured connection and request lifecycle events with correlation IDs
- [Middleware System](/pounce/docs/features/middleware/): ASGI3 middleware stack for request/response transformation
- [Static File Serving](/pounce/docs/features/static-files/): Chunked file serving with pre-compression and ETags
- [WebSocket Compression](/pounce/docs/features/websocket-compression/): Permessage-deflate compression for WebSocket connections

## Get Started

- [Get Started](/pounce/docs/get-started/): Install Pounce and serve your first ASGI application with a production-friendly Python ASGI server
- [Installation](/pounce/docs/get-started/installation/): Install Pounce and optional protocol extras
- [Quickstart](/pounce/docs/get-started/quickstart/): Serve your first ASGI application with Pounce

## Protocols

- [Protocols](/pounce/docs/protocols/): HTTP/1.1, HTTP/2, and WebSocket protocol handling
- [HTTP/1.1](/pounce/docs/protocols/http1/): HTTP/1.1 protocol handling via h11 and built-in fast parser
- [HTTP/2](/pounce/docs/protocols/http2/): HTTP/2 support via h2 — stream multiplexing, header compression, priority signals
- [HTTP/3](/pounce/docs/protocols/http3/): QUIC/UDP HTTP serving through the optional bengal-zoomies transport
- [WebSocket](/pounce/docs/protocols/websocket/): Optional WebSocket support via wsproto

## Reference

- [Reference](/pounce/docs/reference/): Complete API reference, error codes, and configuration fields
- [API Reference](/pounce/docs/reference/api/): Public API for the pounce package
- [Error Reference](/pounce/docs/reference/errors/): Pounce error hierarchy and common error messages

## Testing

- [Testing](/pounce/docs/testing/): Run integration tests against a real Pounce server

## Troubleshooting

- [Troubleshooting](/pounce/docs/troubleshooting/): Common issues and solutions

## Tutorials

- [Tutorials](/pounce/docs/tutorials/): Step-by-step guides for common workflows and migrations
- [Migrate from Uvicorn](/pounce/docs/tutorials/migrate-from-uvicorn/): Switch from Uvicorn to Pounce with minimal changes

## Optional

- [index.json](/pounce/index.json): Search index with page metadata and excerpts
- [robots.txt](/pounce/robots.txt): Content Signals directives for AI crawlers