## Fork Information
This is a fork of gunicorn with the following Frappe-specific changes to the
`gthread` worker:
1. **Request timeout for `gthread`** — upstream has no per-request timeout; a
slow request can otherwise tie up a thread indefinitely. See
https://github.com/frappe/gunicorn/pull/1
2. **Traceback dump on timeout** — when a request times out we
`faulthandler.dump_traceback()` before exiting, to aid debugging.
See https://github.com/frappe/gunicorn/pull/6
3. **Adaptive slow/fast-lane queueing** — when `enable_adaptive_queueing` is
set, the configured threads are split into a fast lane and a slow lane so
slow requests cannot starve fast ones. Controlled by
`--enable-adaptive-queueing` / `GUNICORN_ENABLE_ADAPTIVE_QUEUEING` and
`--slow-request-threshold`. See `gunicorn/workers/gthread_routing.py`.
4. **Higher selector timeout** — small optional throughput improvement.
See https://github.com/frappe/gunicorn/pull/2
Note to anyone upgrading / adding changes:
- Pull upstream changes.
- Reapply or reconcile our changes (the work lives in
`gunicorn/workers/gthread.py`, `gunicorn/workers/gthread_routing.py` and
`gunicorn/config.py`).
- Update the commit/ref in frappe/frappe `pyproject.toml`.
- Keep this section up to date. Keep changes small and to the point.
TODO:
- [ ] Plan a cleaner solution using custom workers. All current changes could
live in a custom worker, but that carries the same awkwardness of
maintaining a fork since we want to "override" rather than "extend" core
behaviour.
# Gunicorn
Gunicorn is maintained by volunteers. If it powers your production, please consider supporting us:
[](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** 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
- [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
Powering Python apps since 2010. Support continued development.
[](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.