Skip to main content

Simple password manager. Stores secrets in encrypted tab-delimited table.

Project description


Keybox is a secure store for passwords, keys, and other secrets.

There is a Python API (import keybox), a runnable package (python3 -m keybox) and a wrapper script (keybox, created by setuptools).

Keybox is completely offline. All secrets stay safely in a local file. Nothing is sent anywhere, unless you explicitly set up network synchronization using some other tool.


  • Data encrypted using strong encryption (PyNaCl)
  • Inside encrypted envelope, it’s a simple tab-delimited file format
  • Shell-like text user interface


  • Master password is saved in memory for as long as the program runs.
  • Neither the password nor decrypted data are written to the disk (unless explicitly exported).


  • The script should run on any system with Python3 installed (including Windows).
  • Requires no installation. You can bring your keybox with you anywhere.
  • Can be contained in a single Python file (see Static Distribution below)


  • Python 3.7 or later
  • PyNaCl, prompt_toolkit, blessed, pyperclip


Install Python package, together with the keybox wrapper script, from PyPI:

pip3 install keybox

That’s it. PIP should pull in the required dependencies.

From source / Git repo

Alternatively, install from source:

python3 install

The package can also run without installation, directly from source tree root:

python3 -m keybox


  • pynacl - the encryption
  • argon2-cffi - optional, replaces argon2 from PyNaCl when available
  • prompt_toolkit, blessed, pyperclip - command-line and shell
  • /usr/share/dict/words
    • used for password generator
    • Debian: apt install wamerican
    • when not available, a replacement words file is downloaded from Internet (This is the only option on Windows)
  • pytest, coverage - for tests

Getting Started

Run the program, choose a master password. A new keybox file will be created.

You are now in the shell. The basic workflow uses the following commands:

  • add some passwords
  • list the records
  • select a record
  • print the password
  • quit

Type help for a list of all commands, help <cmd> for description of each command and its parameters.

Config file

The default config file path is ~/.keybox/keybox.conf. It can be used to point to a different location for the keybox file:

path = ~/vcs/keybox/

Without the config file, the default keybox path is ~/.keybox/

Password Generator

A bundled password generator can be called from command line (keybox pwgen) or internally from the shell. In the shell, use <tab> when asked for a password (in the add/modify commands) to generate some random passwords.

Pwgen is based on the system word list that is usually found in /usr/share/dict/words. By default, it generates a password from two concatenated words, altered by adding two uppercase letters and one digit somewhere inside the password.

This gives around 50 bits of entropy on my system (Password strength).

Static Distribution

Call make zipapp to create a zipapp file containing all sources. The zipapp file is written to build directory and is directly executable by Python.

The Makefile target uses zipapp module which is available since Python 3.5.


Build docs:

make -C docs html

Run tests:

make test

Show test code coverage:

make htmlcov

Build and check package:

make build
make check

The Project Name

There might be some confusion between this Keybox project and GnuPG project, which has something called “a keybox file (.kbx)” and a tool to handle it, kbxutil.

This Keybox is completely unrelated to the GnuPG one.

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

keybox-0.5.0.tar.gz (57.7 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page