Installing Twisted

To install the latest version of Twisted using pip:

$ pip install twisted

Hard dependencies

To use Twisted you need to install a set of depend libraries. The exact list can be found in the pyproject.toml file in section [project], option dependencies.

The requires-python option from pyproject.toml declares the minimum supported Python version.

Optional Dependencies

This section describes the optional dependencies that Twisted supports. The dependencies are python packages that Twisted’s developers have found useful either for developing Twisted itself or for developing Twisted applications.

The intended audience of this document is someone who is familiar with installing optional dependencies using pip.

The information from this page might be outdated. Check the pyproject.toml [project] section to the list of hard dependencies and optional soft dependencies.

If you are unfamiliar with the installation of optional dependencies, the python packaging tutorial can show you how. For a deeper explanation of what optional dependencies are and how they are declared, please see the setuptools documentation.

To install an optional dependency, you can use pip as follows. It will install all the dependencies required to use Twisted with the TLS or HTTP2 protocols:

pip install twisted[tls,http2]

The following optional dependencies are supported:

  • dev - packages that aid in the development and testing of Twisted itself.

  • tls - packages that are needed to work with TLS.

  • http2 - packages needed for http2 support.

  • conch - packages for working with conch/SSH.

  • serial - package to work with serial data.

  • all-non-platform - installs tls, conch, and serial options.

  • macos-platform - all-non-platform options and dependencies to work with macOS specific APIs.

  • windows-platform - all-non-platform options and dependencies to work with Windows’s specific APIs.

  • gtk-platform - all-non-platform options and dependencies to work with the GTK API.