Skip to main content

CLI tool for

Project description


Python Build Status Issues License

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

Table of Contents


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.


pip install pwnage


pwnage --help
usage: pwnage [-h] [-a <account>] [-g] [-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
  -g, --generate        generate a random password that has not been
  -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

pwnage --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

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

Trying a better password

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

Getting prompted for a password

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

Generating a random password that gets checked against HIBP to make sure it has never been compromised

pwnage --generate


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


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pwnage-1.0.0.tar.gz (5.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page