Development Status
- 5 - Production/Stable
Environment
- Other Environment
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- MacOS :: MacOS X
- POSIX
Programming Language
- Python
- Python :: 3
- Python :: 3.7
- Python :: 3.8
- Python :: 3.9
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3 :: Only
- Python :: Implementation :: CPython
- Python :: Implementation :: PyPy
Topic
- Internet
- Utilities
- Software Development :: Libraries :: Python Modules
- Internet :: WWW/HTTP
- Internet :: WWW/HTTP :: WSGI
- Internet :: WWW/HTTP :: WSGI :: Server
- Internet :: WWW/HTTP :: Dynamic Content
Gunicorn
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.
Feel free to join us in #gunicorn on Libera.chat.
Documentation
The documentation is hosted at https://docs.gunicorn.org.
Installation
Gunicorn requires Python 3.x >= 3.7.
Install from PyPI:
$ pip install gunicorn
Usage
Basic usage:
$ gunicorn [OPTIONS] APP_MODULE
Where APP_MODULE is of the pattern $(MODULE_NAME):$(VARIABLE_NAME). The module name can be a full dotted path. The variable name refers to a WSGI callable that should be found in the specified module.
Example with test app:
$ cd examples $ gunicorn --workers=2 test:app
Contributing
See our complete contributor’s guide for more details.
License
Gunicorn is released under the MIT License. See the LICENSE file for more details.
