https://github.com/benoitc/gunicorn
gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications.
https://github.com/benoitc/gunicorn
http http-server python wsgi wsgi-server
Last synced: 10 days ago
JSON representation
gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications.
- Host: GitHub
- URL: https://github.com/benoitc/gunicorn
- Owner: benoitc
- License: other
- Created: 2009-11-30T18:18:08.000Z (about 16 years ago)
- Default Branch: master
- Last Pushed: 2025-09-02T17:06:33.000Z (5 months ago)
- Last Synced: 2025-09-06T01:21:33.514Z (5 months ago)
- Topics: http, http-server, python, wsgi, wsgi-server
- Language: Python
- Homepage: http://www.gunicorn.org
- Size: 4.54 MB
- Stars: 10,253
- Watchers: 222
- Forks: 1,796
- Open Issues: 260
-
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-python-applications - Repo - fork WSGI server, started as the counterpart to [Unicorn](https://en.wikipedia.org/wiki/Unicorn_(web_server)). `(server)` (<a id="tag-dev" href="#tag-dev">Dev</a> / <a id="tag-dev.ops" href="#tag-dev.ops">Ops</a>)
- awesome-python - gunicorn - Pre-forked, partly written in C. (WSGI Servers)
- awesome-python-zh - gunicorn - 预分叉，从Ruby的独角兽项目移植。 (WSGI服务器)
- awesome-python-applications - Repo - fork WSGI server, started as the counterpart to [Unicorn](https://en.wikipedia.org/wiki/Unicorn_(web_server)). `(server)` (<a id="tag-dev" href="#tag-dev">Dev</a> / <a id="tag-dev.ops" href="#tag-dev.ops">Ops</a>)
- awesome-python-resources - GitHub - 20% open · ⏱️ 25.08.2022): (WSGI 服务器)
- best-of-web-python - GitHub - 9% open · ⏱️ 05.10.2025): (Servers)
- python-awesome - gunicorn - Pre-forked, ported from Ruby's Unicorn project. (WSGI Servers)
- awesome-python - gunicorn - Pre-forked, partly written in C. (WSGI Servers)
- awesome-python - gunicorn - gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. ` 📝 3 months ago ` (WSGI Servers [🔝](#readme))
- fucking-awesome-python - gunicorn - Pre-forked, ported from Ruby's Unicorn project. (WSGI Servers)
- fucking-awesome-python - :octocat: gunicorn - :star: 9027 :fork_and_knife: 1665 - Pre-forked, partly written in C. (WSGI Servers)
- awesome-python - gunicorn - Pre-forked, ported from Ruby's Unicorn project. (WSGI Servers)
- stars - benoitc/gunicorn - gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (Python)
- awesome-django - Gunicorn
- awesome-python - gunicorn - Pre-forked, partly written in C. (WSGI Servers)
- jimsghstars - benoitc/gunicorn - gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (Python)
- awesome-python-web-frameworks - gunicorn - 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (Http servers / More)
- awesome - benoitc/gunicorn - gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (<a name="Python"></a>Python)
README
Gunicorn
========
.. image:: https://img.shields.io/pypi/v/gunicorn.svg?style=flat
:alt: PyPI version
:target: https://pypi.python.org/pypi/gunicorn
.. image:: https://img.shields.io/pypi/pyversions/gunicorn.svg
:alt: Supported Python versions
:target: https://pypi.python.org/pypi/gunicorn
.. image:: https://github.com/benoitc/gunicorn/actions/workflows/tox.yml/badge.svg
:alt: Build Status
:target: https://github.com/benoitc/gunicorn/actions/workflows/tox.yml
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 v24**: Native ASGI support (beta) for async frameworks like FastAPI!
Quick Start
-----------
.. code-block:: bash
pip install gunicorn
gunicorn myapp:app --workers 4
For ASGI applications (FastAPI, Starlette):
.. code-block:: bash
gunicorn myapp:app --worker-class asgi
Features
--------
- WSGI support for Django, Flask, Pyramid, and any WSGI framework
- **ASGI support** (beta) for FastAPI, Starlette, Quart
- uWSGI binary protocol for nginx integration
- Multiple worker types: sync, gthread, gevent, eventlet, asgi
- Graceful worker process management
- Compatible with Python 3.12+
Documentation
-------------
Full documentation at https://gunicorn.org
- `Quickstart `_
- `Configuration `_
- `Deployment `_
- `Settings Reference `_
Community
---------
- Report bugs on `GitHub Issues `_
- Chat in `#gunicorn`_ on `Libera.chat`_
- See `CONTRIBUTING.md `_ for contribution guidelines
License
-------
Gunicorn is released under the MIT License. See the LICENSE_ file for details.
.. _Unicorn: https://bogomips.org/unicorn/
.. _`#gunicorn`: https://web.libera.chat/?channels=#gunicorn
.. _`Libera.chat`: https://libera.chat/
.. _LICENSE: https://github.com/benoitc/gunicorn/blob/master/LICENSE