Readable, typable password generator script
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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

  • 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