Skip to content

Installation

Uvicorn is available on PyPI so installation is as simple as:

pip install uvicorn

uv add uvicorn

The above will install Uvicorn with the minimal set of dependencies:

  • h11 — Pure Python sans-io HTTP/1.1 implementation.
  • click — Command line interface library.

If you are running on Python 3.10 or early versions, typing_extensions will also be installed.

Optional Dependencies

There are many optional dependencies that can be installed to add support for various features.

If you just want to install all of them at once, you can use the standard extra:

pip install 'uvicorn[standard]'

uv add 'uvicorn[standard]'

The standard extra installs the following dependencies:

  • uvloop — Fast, drop-in replacement of the built-in asyncio event loop.

    When uvloop is installed, Uvicorn will use it by default.

  • httptools — Python binding for the Node.js HTTP parser.

    When httptools is installed, Uvicorn will use it by default for HTTP/1.1 parsing.

    You can read this issue to understand how it compares with h11: h11/issues/9.

  • websockets — WebSocket library for Python.

    When websockets is installed, Uvicorn will use it by default for WebSocket handling.

    You can alternatively install wsproto and set the --ws option to wsproto to use it instead.

  • watchfiles — Simple, modern and high performance file watching and code reload in python.

    When watchfiles is installed, Uvicorn will use it by default for the --reload option.

  • colorama — Cross-platform support for ANSI terminal colors.

    This is installed only on Windows, to provide colored logs.

  • python-dotenv — Reads key-value pairs from a .env file and adds them to the environment.

    This is installed to allow you to use the --env-file option.

  • PyYAML — YAML parser and emitter for Python.

    This is installed to allow you to provide a .yaml file to the --log-config option.