Generate readable, typable passwords

pip install nupass==1.0.0



Readable, typable password generator script. Because your users can't deal with pwmake.

PyPI Version Build Status Downloads Stats Release Status

NuPass provides the nupass package and a command-line script for generating temporary passwords that your users can read and type. Passwords are provided by the gen_pass() function and are in the following format:


For example, 4Toffee@Buttercream7.


OS X & Linux:

pip install nupass


python -m pip install nupass

Usage example

Generate a single password:

$ nupass

Generate five passwords:

$ nupass 5

Development setup

Using NuPass in your projects:

import nupass
temp_pass = nupass.gen_pass() # returns a string containing your password

If you want to change the length of the words used in the password, you can set the parameters of gen_pass().

import nupass
temp_pass = nupass.gen_pass(min_w_len=4, max_w_len=10)
# functionally the same as nupass.genpass(4, 10)

Release History

  • 1.0.0
    • ADD: Include README as long description on PyPI.
    • CHANGE: Use native setuptools method for script installation.
  • 0.2.1
    • ADD: Word length now set by function parameters.
    • CHANGE: Fixed an issue where the wordlist wasn't being closed.
    • CHANGE: Fixed an issue with invalid command-line arguments.
  • 0.2.0
    • CHANGE: Converted to package
    • ADD: Script added to path when installed via
  • 0.1.0
    • The first proper release


Sean Callaway –

Distributed under the GNU GPL v2 license. See LICENSE for more information.


  1. Fork it (
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request