gunicorn README

The project's README from github.com/benoitc/gunicorn. As one markdown file: README.md.

Gunicorn

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

PyPI version Supported Python versions Build Status

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

Documentation

Full documentation at https://gunicorn.org

Community

Support

Powering Python apps since 2010. Support continued development.

Become a Sponsor

Sponsors

Enki Multimedia

License

Gunicorn is released under the MIT License. See the LICENSE file for details.

gunicorn (benoitc/gunicorn)

Searching Database…

10.7K ·GitHub
Что это такое?Gunicorn — «Green Unicorn» — это WSGI HTTP-сервер для Python, работающий на UNIX. Это тот процесс, который запускает ваше веб-приложение на Python и отдаёт его в интернет.
Gunicorn — это фреймворк, на котором я строю приложение, или сервер, который я разворачиваю?Ни то, ни другое: это не фреймворк и не библиотека, а сервер, который вы разворачиваете перед уже готовым приложением. Он работает практически с любым веб-фреймворком Python: Django, Flask или Pyramid поверх WSGI; FastAPI, Starlette или Quart поверх ASGI.
Как сделать, чтобы он обслуживал моё приложение?Установите пакет gunicorn через pip, затем в команде gunicorn укажите ваше приложение; в документации есть Quickstart и отдельный раздел Quick Start для ASGI-приложений.
Какая версия Python ему нужна?Python 3.10 или новее.
Всё здесь готово к продакшену, или есть бета-функции?Ядро сервера работает с приложениями на Python с 2010 года, но две самые новые функции пока в бете: HTTP/2 с мультиплексированием потоков и Dirty Arbiters — обе появились в v25.
Где он работает — на Linux, macOS, Windows?На UNIX-системах: Linux, macOS и FreeBSD (в репозитории даже есть FreeBSD CI). На Windows он не запустится.
Это бесплатно, в том числе для коммерческого использования?Да — лицензия MIT, полностью бесплатно, без платных тарифов.
Что такое Dirty Arbiters?Бета-функция Gunicorn, появившаяся в v25 и нацеленная на тяжёлые нагрузки вроде ML-моделей или долго выполняющихся задач: воркеры распределяются отдельно для каждого приложения. Если ваше приложение гоняет медленные, прожорливые к ресурсам задачи, — вот на это стоит обратить внимание.
Его обычно ставят за nginx?Да, это классическая схема: Gunicorn специально поддерживает бинарный протокол uWSGI, чтобы nginx мог интегрироваться с ним напрямую.
Насколько он требователен к ресурсам сервера?По замыслу — нетребователен: в README про него написано, что он просто устроен, мало расходует серверные ресурсы и довольно быстрый. Он рассчитан на то, чтобы стоять перед вашим приложением и не съедать весь сервер.
Creator
benoitc
Size
10.4 MB
Stars
10.7K
Age
16y
Commits · 90 Days