mirror of
https://github.com/frappe/gunicorn.git
synced 2026-07-01 18:21:30 +08:00
a7e14e16fd
Update README.md and docs homepage with detailed support messaging including sponsorship benefits and corporate contact information.
70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
# Gunicorn
|
|
|
|
[](https://pypi.python.org/pypi/gunicorn)
|
|
[](https://pypi.python.org/pypi/gunicorn)
|
|
[](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** (beta) for FastAPI, Starlette, Quart
|
|
- **HTTP/2 support** (beta) with multiplexed streams
|
|
- **Dirty Arbiters** for heavy workloads (ML models, long-running tasks)
|
|
- uWSGI binary protocol for nginx integration
|
|
- Multiple worker types: sync, gthread, gevent, eventlet, asgi
|
|
- Graceful worker process management
|
|
- Compatible with Python 3.9+
|
|
|
|
## 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 in [#gunicorn](https://web.libera.chat/?channels=#gunicorn) on [Libera.chat](https://libera.chat/)
|
|
- See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines
|
|
|
|
## Support
|
|
|
|
gunicorn has been serving Python web applications since 2010. If it's running in your production stack and saving your team time and money, please consider supporting its continued development:
|
|
|
|
[](https://github.com/sponsors/benoitc)
|
|
|
|
Your sponsorship helps cover:
|
|
- Security updates and vulnerability responses
|
|
- Compatibility with new Python versions
|
|
- Bug fixes and performance improvements
|
|
- Documentation maintenance
|
|
|
|
**Corporate sponsors:** If gunicorn is part of your infrastructure, [reach out](mailto:benoitc@enki-multimedia.eu) for sponsored support options.
|
|
|
|
## License
|
|
|
|
Gunicorn is released under the MIT License. See the [LICENSE](https://github.com/benoitc/gunicorn/blob/master/LICENSE) file for details.
|