hangups requires Python 3.6+ and is known to work on Linux, Mac OS X, and Windows (with Cygwin).

Python Package Index (PyPI)

hangups is listed in PyPI, and may be installed using pip:

pip3 install hangups


An official hangups Docker image is available.

Use Docker to run hangups in a container:

docker run -it --rm tdryer/hangups

To remember your login session between runs, specify a bind mount for the hangups cache directory:

docker run -it --rm --mount type=bind,source=$HOME/.cache/hangups,target=/home/hangups/.cache/hangups tdryer/hangups

To upgrade hangups, pull the latest version of the image:

docker pull tdryer/hangups

Arch Linux

An unofficial hangups package is available for Arch Linux in the Arch User Repository.

Install from Source

The hangups code is available from GitHub. Either download and extract a hangups release archive, or clone the hangups repository:

git clone

Switch to the hangups directory and install the package:

cd hangups
python3 install