passpy has been written to be a platform independent library and cli that is compatible with ZX2C4’s pass.

passpy saves your passwords in gpg encrypted files and optionally uses git as a revision tool. All files are stored inside the directory given by the PASSWORD_STORE_DIR environment variable (~/.password-store if not set) and can be organised into folders. You can also just copy the whole store to have your passwords available where ever you like.



Just do $ [sudo] pip install passpy

Arch Linux

The package python-passpy is available in the AUR for you to install however you like.


Either clone the git repository using $ git clone

or download the source from the releases tab and extract it. Afterwards change into the new folder and do $ [sudo] python install


passpy depends on Python 3.3 or later (it has mostly been tested using Python 3.5). The program makes use of git and gpg2 as well as either xclip or xsel on Linux.

The following Python packages will be installed alongside passpy:

If you are on Windows and want colourised output on the command line, you will additionally need to install colorama.



  • Now also read the default password store location from PASSWORD_STORE_DIR for the cli.
  • Show a better error message when the password store does not exist.
  • Always use the path parameter of Store.init_store relative to Store.store_dir.


  • Fix documentation.


  • Read the default password store location from the PASSWORD_STORE_DIR environment variable, just like pass does (contributed by Jonathan Waldrep).

Indices and tables