Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Coroutine-based network library

Project description


gevent is a coroutine -based Python networking library that uses greenlet to provide a high-level synchronous API on top of the libev or libuv event loop.

Features include:

gevent is inspired by eventlet but features a more consistent API, simpler implementation and better performance. Read why others use gevent and check out the list of the open source projects based on gevent.

gevent was written by Denis Bilenko.

Since version 1.1, gevent is maintained by Jason Madden for NextThought with help from the contributors and is licensed under the MIT license.

See what’s new in the latest major release.

Check out the detailed changelog for this version.

Read the documentation online at

Post feedback and issues on the bug tracker, mailing list, blog and twitter (@gevent).

Installation and Requirements

Supported Platforms

gevent 1.5 runs on Python 2.7.9 and up, and Python 3.5, 3.6 and 3.7. gevent requires the greenlet library and will install the cffi library by default on Windows. The cffi library will become the default on all platforms in a future release of gevent.

gevent 1.5 also runs on PyPy 7.0 or above. On PyPy, there are no external dependencies.

gevent is tested on Windows, macOS, and Linux, and should run on most other Unix-like operating systems (e.g., FreeBSD, Solaris, etc.)


On Windows using the deprecated libev backend, gevent is limited to a maximum of 1024 open sockets due to limitations in libev. This limitation should not exist with the default libuv backend.

Older Versions of Python

Users of older versions of Python 2 or Python 3 may install an older version of gevent. Note that these versions are generally not supported.

Python Version Gevent Version
2.5 1.0.x
2.6 1.1.x
<= 2.7.8 1.2.x
3.3 1.2.x
3.4.0 - 3.4.2 1.3.x
3.4.3 1.4.x



This section is about installing released versions of gevent as distributed on the Python Package Index. For developing with gevent, including running tests, see development. For building gevent from source, including customizing the build and embedded libraries, see Installing From Source.

gevent and greenlet can both be installed with pip, e.g., pip install gevent. Installation using buildout is also supported.

On Windows, macOS, and Linux, both gevent and greenlet are distributed as binary wheels.


You need Pip 8.0 or later, or buildout 2.10.0 to install the binary wheels on Windows or macOS. On Linux, you’ll need pip 19 to install the manylinux2010 wheels.

Installing From Source

If you are unable to use the binary wheels (for platforms where no pre-built wheels are available or if wheel installation is disabled), you can build gevent from source. A normal pip install will fall back to doing this if no binary wheel is available. See Installing From Source for more, including common installation issues.

Extra Dependencies

gevent has no runtime dependencies outside the standard library, greenlet, and (on some platforms) cffi. However, there are a number of additional libraries that extend gevent’s functionality and will be used if they are available. All of these may be installed using setuptools extras, as named below, e.g., pip install gevent[events].

Configurable event support using zope.event is highly recommended for configurable event support.
Enables the new pure-Python resolver, backed by dnspython. On Python 2, this also includes idna. They can be installed with the dnspython extra.
Enhancements to gevent’s self-monitoring capabilities. This includes the psutil library which is needed to monitor memory usage. (Note that this may not build on all platforms.)
A shortcut for installing suggested extras together.
Everything needed to run the complete gevent test suite.


For development information, including installing from git and running tests, see development.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
gevent-1.5a1-cp27-cp27m-macosx_10_9_x86_64.whl (3.1 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.5a1-cp27-cp27m-manylinux2010_x86_64.whl (5.9 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.5a1-cp27-cp27mu-manylinux2010_x86_64.whl (5.9 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.5a1-cp27-cp27m-win32.whl (2.9 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.5a1-cp27-cp27m-win_amd64.whl (3.0 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.5a1-cp35-cp35m-macosx_10_6_intel.whl (4.1 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.5a1-cp35-cp35m-manylinux2010_x86_64.whl (6.3 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.5a1-cp35-cp35m-win32.whl (2.8 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.5a1-cp35-cp35m-win_amd64.whl (3.0 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.5a1-cp36-cp36m-macosx_10_6_intel.whl (4.2 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.5a1-cp36-cp36m-manylinux2010_x86_64.whl (6.5 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.5a1-cp36-cp36m-win32.whl (2.9 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.5a1-cp36-cp36m-win_amd64.whl (3.0 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.5a1-cp37-cp37m-macosx_10_9_x86_64.whl (3.2 MB) Copy SHA256 hash SHA256 Wheel cp37
gevent-1.5a1-cp37-cp37m-manylinux2010_x86_64.whl (6.5 MB) Copy SHA256 hash SHA256 Wheel cp37
gevent-1.5a1-cp37-cp37m-win32.whl (2.9 MB) Copy SHA256 hash SHA256 Wheel cp37
gevent-1.5a1-cp37-cp37m-win_amd64.whl (3.0 MB) Copy SHA256 hash SHA256 Wheel cp37
gevent-1.5a1-pp271-pypy_41-macosx_10_14_x86_64.whl (1.2 MB) Copy SHA256 hash SHA256 Wheel pp271
gevent-1.5a1-pp271-pypy_41-win32.whl (1.1 MB) Copy SHA256 hash SHA256 Wheel pp271
gevent-1.5a1.tar.gz (5.0 MB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page