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.

Features include:

  • Fast event loop based on libev or libuv.
  • Lightweight execution units based on greenlet.
  • Familiar API that re-uses concepts from the Python standard library.
  • Cooperative sockets with SSL support.
  • DNS queries performed through c-ares or a threadpool.
  • Ability to use standard library and 3rd party modules written for standard blocking sockets

gevent is inspired by eventlet but features 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 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.

Get gevent

gevent runs on Python >= 2.7, Python >= 3.4, or PyPy >= 5.5 (including PyPy2 and PyPy3). On all platforms, installing setuptools is required (this is done automatically if working in a virtual environment).

You can use pip to install gevent:

pip install gevent


You need Pip 8.0 or later to install the binary wheels.


You need to install from source, not the manylinux wheels, to use the libuv backend.

Download the latest release from Python Package Index or clone the repository.

Read the documentation online at Additional installation information can be found here.

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


To install the latest development version:

pip install setuptools cffi 'cython>=0.27' git+git://

To hack on gevent (using a virtualenv):

$ git clone
$ cd gevent
$ virtualenv env
$ source env/bin/activate
(env) $ pip install -r dev-requirements.txt


You must have a C compiler, Cython, and the Python development headers installed to build a checkout. Installing CFFI on CPython (it’s standard on PyPy) allows building the CFFI backends for testing, and tox is the command used to test multiple versions of Python.

Running Tests

There are a few different ways to run the tests. To simply run the tests on one version of Python during development, try this:

(env) $ pip install -e .
(env) $ cd src/greentest
(env) $ python ./

Before submitting a pull request, it’s a good idea to run the tests across all supported versions of Python, and to check the code quality using prospector. This is what is done on Travis CI. Locally it can be done using tox:

pip install tox

The testrunner accepts a --coverage argument to enable code coverage metrics through the package. That would go something like this:

cd src/greentest
python --coverage
coverage combine
coverage html -i
<open htmlcov/index.html>

Builds on Travis CI automatically submit updates to to monitor test coverage.


On Debian, you will probably need libpythonX.Y-testsuite installed to run all the tests.

Continuous integration

A test suite is run for every push and pull request submitted. Travis CI is used to test on Linux, and AppVeyor runs the builds on Windows.

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.3b2-cp27-cp27m-macosx_10_9_x86_64.whl (2.2 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.3b2-cp27-cp27m-manylinux1_x86_64.whl (4.2 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.3b2-cp27-cp27mu-manylinux1_x86_64.whl (4.2 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.3b2-cp27-cp27m-win32.whl (2.0 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.3b2-cp27-cp27m-win_amd64.whl (2.1 MB) Copy SHA256 hash SHA256 Wheel cp27
gevent-1.3b2-cp34-cp34m-macosx_10_6_intel.whl (3.1 MB) Copy SHA256 hash SHA256 Wheel cp34
gevent-1.3b2-cp34-cp34m-manylinux1_x86_64.whl (4.5 MB) Copy SHA256 hash SHA256 Wheel cp34
gevent-1.3b2-cp34-cp34m-win32.whl (2.0 MB) Copy SHA256 hash SHA256 Wheel cp34
gevent-1.3b2-cp34-cp34m-win_amd64.whl (2.1 MB) Copy SHA256 hash SHA256 Wheel cp34
gevent-1.3b2-cp35-cp35m-macosx_10_6_intel.whl (3.1 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.3b2-cp35-cp35m-manylinux1_x86_64.whl (4.4 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.3b2-cp35-cp35m-win32.whl (1.9 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.3b2-cp35-cp35m-win_amd64.whl (2.0 MB) Copy SHA256 hash SHA256 Wheel cp35
gevent-1.3b2-cp36-cp36m-macosx_10_6_intel.whl (3.1 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.3b2-cp36-cp36m-manylinux1_x86_64.whl (4.5 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.3b2-cp36-cp36m-win32.whl (1.9 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.3b2-cp36-cp36m-win_amd64.whl (2.1 MB) Copy SHA256 hash SHA256 Wheel cp36
gevent-1.3b2-cp37-cp37m-macosx_10_9_x86_64.whl (2.2 MB) Copy SHA256 hash SHA256 Wheel cp37
gevent-1.3b2-pp259-pypy_41-win32.whl (663.4 kB) Copy SHA256 hash SHA256 Wheel pp259
gevent-1.3b2-pp260-pypy_41-macosx_10_13_x86_64.whl (688.4 kB) Copy SHA256 hash SHA256 Wheel pp260
gevent-1.3b2.tar.gz (4.6 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