hub / github.com/benoitc/gunicorn
github.com/benoitc/gunicorn
Chat with this repo
5,723 symbols
22,011 edges
438 files
⚖ MIT
3,832 documented · 67%
● updated 2d ago26.2.0 · 2026-08-24★ 10,65961 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
Gunicorn
Gunicorn is maintained by volunteers. If it powers your production, please consider supporting us:
Gunicorn 'Green Unicorn' is a Python WSGI HTTP Server for UNIX. It's a pre-fork worker model ported from Ruby's Unicorn project. The Gunicorn server is broadly compatible with various web frameworks, simply implemented, light on server resource usage, and fairly speedy.
New in v25: Per-app worker allocation for dirty arbiters, HTTP/2 support (beta)!
Quick Start
pip install gunicorn
gunicorn myapp:app --workers 4
For ASGI applications (FastAPI, Starlette):
gunicorn myapp:app --worker-class asgi
Features
- WSGI support for Django, Flask, Pyramid, and any WSGI framework
- ASGI support for FastAPI, Starlette, Quart
- HTTP/2 support (beta) with multiplexed streams
- Dirty Arbiters (beta) for heavy workloads (ML models, long-running tasks)
- uWSGI binary protocol for nginx integration
- Multiple worker types: sync, gthread, gevent, asgi
- Graceful worker process management
- Compatible with Python 3.9+
Documentation
Full documentation at https://gunicorn.org
Community
- Report bugs on GitHub Issues
- Chat with us in your browser (
#gunicornon Libera.Chat, no account needed) - See CONTRIBUTING.md for contribution guidelines
Support
Powering Python apps since 2010. Support continued development.
Sponsors
License
Gunicorn is released under the MIT License. See the LICENSE file for details.
Core symbols most depended-on inside this repo
↓ 76 filesTLVEncoder
TLV binary encoder/decoder. Encodes Python values to binary TLV format and decodes back. Supports: None, bool, int, float, bytes, …
gunicorn/dirty/tlv.py
↓ 81 filesConfiggunicorn/config.py
↓ 46 filesStashTableDict-like interface to a stash table. Example:: sessions = stash.table("sessions") sessions["user:1"] = {"name": "Alice"} user = …
gunicorn/dirty/stash.py
↓ 29 filesStashClientClient for stash operations. Communicates with the arbiter which stores all tables in memory.
gunicorn/dirty/stash.py
↓ 16 filesPidfile\ Manage a PID file. If a specific name is provided it and '"%s.oldpid" % name' will be used. Otherwise we create a temp file …
gunicorn/pidfile.py
↓ 16 filesASGIProtocolHTTP/1.1 protocol handler for ASGI applications. Handles connection lifecycle, request parsing, and ASGI app invocation. Uses …
gunicorn/asgi/protocol.py
Shape
Languages
Python100%
TypeScript1%
Modules by API surface
gunicorn/config.py202 symbols
tests/test_gthread.py132 symbols
tests/test_dirty_arbiter.py124 symbols
tests/test_arbiter.py103 symbols
tests/test_http2_stream.py94 symbols
tests/test_asgi_websocket_protocol.py93 symbols
tests/test_asgi_worker.py75 symbols
tests/test_config.py74 symbols
tests/test_asgi_compliance.py74 symbols
gunicorn/asgi/protocol.py74 symbols
tests/docker/asgi_compliance/test_http_compliance.py72 symbols
tests/test_dirty_worker.py71 symbols
Dependencies from manifests, versioned
Django5.0 · 1×
blacksheep2.0.0 · 1×
channels4.0.0 · 1×
fastapi0.110.0 · 1×
gunicorn_h1c0.6.6 · 1×
h24.4.1 · 1×
httptools0.6.0 · 1×
httpx0.27.0 · 1×
inotify0.2.10 · 1×
litestar2.7.0 · 1×
markdown-grid-tables0.6 · 1×
mkdocs1.6 · 1×
Datastores touched
myappDatabase · 1 repos
For agents
$ claude mcp add gunicorn \
-- python -m otcore.mcp_server <graph>