uvloop is a fast, drop-in replacement of the built-in asyncio event loop. uvloop is implemented in Cython and uses libuv under the hood.
The project documentation can be found here. Please also check out the wiki.
uvloop makes asyncio 2-4x faster.
![performance.png](performance.png)
The above chart shows the performance of an echo server with different
message sizes. The sockets benchmark uses loop.sock_recv()
and
loop.sock_sendall()
methods; the streams benchmark uses asyncio
high-level streams, created by the asyncio.start_server()
function;
and the protocol benchmark uses loop.create_server()
with a simple
echo protocol. Read more about uvloop in a
blog post
about it.
uvloop requires Python 3.5 or greater and is available on PyPI. Use pip to install it:
$ pip install uvloop
Note that it is highly recommended to upgrade pip before installing uvloop with:
$ pip install -U pip
Call uvloop.install()
before calling asyncio.run()
or
manually creating an asyncio event loop:
import asyncio
import uvloop
async def main():
# Main entry-point.
...
uvloop.install()
asyncio.run(main())
To build uvloop, you'll need Python 3.5 or greater:
Clone the repository:
$ git clone --recursive [email protected]:MagicStack/uvloop.git $ cd uvloop
Create a virtual environment and activate it:
$ python3.7 -m venv uvloop-dev $ source uvloop-dev/bin/activate
Install development dependencies:
$ pip install -r requirements.dev.txt
Build and run tests:
$ make $ make test
uvloop is dual-licensed under MIT and Apache 2.0 licenses.