Skip to main content

Generate readable, typable passwords

Project description


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

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

nupass-1.0.0.tar.gz (15.3 kB view hashes)

Uploaded source

Built Distribution

nupass-1.0.0-py3-none-any.whl (15.6 kB view hashes)

Uploaded py3

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