Installation guide

pwned-passwords-django 5.1.3 supports Django 4.2, 5.0, and 5.1, and Python 3.9 through 3.13. See Django’s Python support matrix for details of which Python versions are compatible with each version of Django.

Installing pwned-passwords-django

To install pwned-passwords-django, run the following command from a command prompt/terminal:

macOS/Linux/other Unix

python -m pip install pwned-passwords-django

Windows

py -m pip install pwned-passwords-django

This will use pip, the standard Python package-installation tool. If you are using a supported version of Python, your installation of Python should have come with pip bundled. If pip does not appear to be present, you can try running the following from a command prompt/terminal:

macOS/Linux/other Unix

python -m ensurepip --upgrade

Windows

py -m ensurepip --upgrade

Instructions are also available for how to obtain and manually install or upgrade pip.

If you don’t already have a supported version of Django installed, using pip to install pwned-passwords-django will also install the latest supported version of Django.

Installing from a source checkout

If you want to work on pwned-passwords-django, you can obtain a source checkout.

The development repository for pwned-passwords-django is at <https://github.com/ubernostrum/pwned-passwords-django>. If you have git installed, you can obtain a copy of the repository by typing:

git clone https://github.com/ubernostrum/pwned-passwords-django.git

Then follow the instructions in the file CONTRIBUTING.rst in the root directory of the source checkout.