Skip to main content

Convert cryptographic keys to human-readable phrases, or generate random-yet-memorable passphrases

Project description

PyPI status Build status Documentation Status Updates

A Python port of Niceware, for generating random-yet-memorable passwords. Each word provides 16 bits of entropy, so a useful password requires at least 3 words.

Because the wordlist is of exactly size 2^16, Niceware is also useful for converting cryptographic keys and other sequences of random bytes into human-readable phrases. With Niceware, a 128-bit key is equivalent to an 8-word phrase.


To insall

$ pip install niceware

To generate an 8-byte passphrase

>>> import niceware
>>> niceware.generate_passphrase(8)
['deathtrap', 'stegosaur', 'nilled', 'nonscheduled']

or from the command line

$ niceware --words 5
tincturing distasting await trusser treadler

Niceware for Python uses os.urandom for entropy.


Niceware for Python is a port of Niceware, by yan.

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.2.1 (2017-03-25)

  • Add example command line usage

0.2.0 (2017-03-25)

  • Add niceware command to generate passphrase(s)

  • Add examples to docstrings

  • Mark Python 3.6 as supported

0.1.1 (2017-03-12)

  • README fixes, no code changes

0.1.0 (2017-03-11)

  • First release on PyPI.

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

niceware-0.2.1.tar.gz (213.0 kB view hashes)

Uploaded source

Built Distribution

niceware-0.2.1-py2.py3-none-any.whl (204.1 kB view hashes)

Uploaded 2 7

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