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: 8 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 (almost 17 years ago)
• Default Branch: master
• Last Pushed: 2026-09-06T20:09:00.000Z (about 2 months ago)
• Last Synced: 2026-10-14T03:19:21.831Z (12 days ago)
• Topics: http, http-server, python, wsgi, wsgi-server
• Language: Python
• Homepage: http://www.gunicorn.org
• Size: 10.2 MB
• Stars: 10,702
• Watchers: 218
• Forks: 1,863
• Open Issues: 126
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Security: SECURITY.md
  • Notice: NOTICE
  • Maintainers: MAINTAINERS

Awesome Lists containing this project

• awesome-python - benoitc/gunicorn - gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (Other / Scientific Computing)
• 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 服务器)
• stars - benoitc/gunicorn - gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (Python)
• python-awesome - gunicorn - Pre-forked, ported from Ruby's Unicorn project. (WSGI Servers)
• jimsghstars - benoitc/gunicorn - gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (Python)
• 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)
• awesome-python - gunicorn - Pre-forked, partly written in C. (WSGI Servers)
• awesome-python-web-frameworks - gunicorn - 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. (Http servers / More)

README

          
# Gunicorn



  Gunicorn is maintained by volunteers. If it powers your production, please consider supporting us:


  

  



[![PyPI version](https://img.shields.io/pypi/v/gunicorn.svg?style=flat)](https://pypi.python.org/pypi/gunicorn)

[![Supported Python versions](https://img.shields.io/pypi/pyversions/gunicorn.svg)](https://pypi.python.org/pypi/gunicorn)

[![Build Status](https://github.com/benoitc/gunicorn/actions/workflows/tox.yml/badge.svg)](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](https://bogomips.org/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

```bash

pip install gunicorn

gunicorn myapp:app --workers 4

```

For ASGI applications (FastAPI, Starlette):

```bash

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.10+

## Documentation

Full documentation at https://gunicorn.org

- [Quickstart](https://gunicorn.org/quickstart/)

- [Configuration](https://gunicorn.org/configure/)

- [Deployment](https://gunicorn.org/deploy/)

- [Settings Reference](https://gunicorn.org/reference/settings/)

## Community

- Report bugs on [GitHub Issues](https://github.com/benoitc/gunicorn/issues)

- [Chat with us in your browser](https://web.libera.chat/?channels=%23gunicorn) (`#gunicorn` on Libera.Chat, no account needed)

- See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines

## Support

Powering Python apps since 2010. Support continued development.

[![Become a Sponsor](https://img.shields.io/badge/Become_a_Sponsor-❤-ff69b4)](https://gunicorn.org/sponsor/)

### Sponsors



## License

Gunicorn is released under the MIT License. See the [LICENSE](https://github.com/benoitc/gunicorn/blob/master/LICENSE) file for details.