Popularity
6.9
Growing
Activity
8.5
Declining
2,401
69
166

Programming language: Python
License: BSD 3-clause "New" or "Revised" License
Tags: HTTP     Internet     WWW     ASGI Servers    
Latest version: v0.11.3
Add another 'ASGI Servers' Package

README

The lightning-fast ASGI server.


Build Status Coverage Package version

Documentation: https://www.uvicorn.org

Community: https://discuss.encode.io/c/uvicorn

Requirements: Python 3.6+ (For Python 3.5 support, install version 0.8.6.)

Uvicorn is a lightning-fast ASGI server implementation, using uvloop and httptools.

Until recently Python has lacked a minimal low-level server/application interface for asyncio frameworks. The ASGI specification fills this gap, and means we're now able to start building a common set of tooling usable across all asyncio frameworks.

Uvicorn currently supports HTTP/1.1 and WebSockets. Support for HTTP/2 is planned.

Quickstart

Install using pip:

$ pip install uvicorn

Create an application, in example.py:

async def app(scope, receive, send):
    assert scope['type'] == 'http'

    await send({
        'type': 'http.response.start',
        'status': 200,
        'headers': [
            [b'content-type', b'text/plain'],
        ],
    })
    await send({
        'type': 'http.response.body',
        'body': b'Hello, world!',
    })

Run the server:

$ uvicorn example:app

Uvicorn is BSD licensed code.Designed & built in Brighton, England.— 🦄 —


*Note that all licence references and agreements mentioned in the uvicorn README section above are relevant to that project's source code only.