Skip to content
Python CLI tool for
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Python Build Status Issues License

Python based command line tool for checking the Have I Been Pwned database.

Table of Contents

Getting Started

These instructions will get you a copy of the project up and running on your local machine.


You'll need to have Python installed in order to run Pwnage. Start by downloading and installing the latest version of Python 3.

Note: Pwnage has not been tested with Python 2 and will probably not work without changing some things.


Download the latest version from GitHub using Git.

git clone

This will create a directory called Pwnage and all the code will be in it.

Switch to the Pwnage directory:

cd Pwnage

Install the required packages:

pip install -r requirements.txt


python -h
usage: [-h] [-a <account>] [-p <password>] [-r] [-v]

Checks passwords against the Have I Been Pwned database

optional arguments:
  -h, --help            show this help message and exit
  -a <account>, --account <account>
                        account to check against database
  -p <password>, --password <password>
                        password to check against database
  -r, --prompt          prompt for pass to check against database
  -v, --verbose         verbose output, useful for debugging issues

optional arguments '-p/--password' and '-r/--prompt' cannot be used together

Checking an account

python --account Zoidberg@freemail.web
Zoidberg@freemail.web has been pwned in these breaches:
Unverified: Collection1 on 2019-01-07. Details leaked: Email addresses, Passwords
Verified: VK on 2012-01-01. Details leaked: Email addresses, Names, Passwords, Phone numbers

Trying a bad password

python --password Password1234
This password has been pwned 3621 times!

Trying a better password

python --password "djf;hjdhfjk3;j4r436@@!"
This password has not been pwned yet.

Getting prompted for a password

python --prompt
Password to check:
This password has been pwned 21961 times!


This project is licensed under the MIT License - see the LICENSE file for details


You can’t perform that action at this time.