This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description


Keys is a Python package with utilities for managing your passwords, keys
and other secrets. It can be used directly from Python (``import keys``) or
run as program (``python3 -m keys``, or just ``keys``).

Unlike most password managers, this is completely offline. All your secrets
stay safe in local file. Nothing is sent anywhere, unless you explicitly
set up network synchronization using some other tool.


- Data encrypted using strong encryption (GPG file)
- 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 ever written to disk.


- The script should run on any system with Python3 and GPG installed.
- Requires no installation. You can bring your keys with you anywhere.
- Can be contained in single Python file (see Distribution_ bellow)


- Python 3.2 or later (Python 3.3 recommended)


Install Python package together with ``keys`` script::

python3 install

The package can also be run directly::

python3 -m keys

Getting Started

Run the program, type master password. New keybox file will be created.

You are now in the shell. The basic workflow is as follows:

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

See **help** for list of all commands.

Password Generator

Bundled password generator can be called from command line (``keys pwgen``)
or internally from shell. Try ``<tab>`` when asked for password (add command).

Pwgen is based on system word list usually found in ``/usr/share/dict/words``.
By default, it makes password from two concatenated words, one uppercase letter,
one digit and one punctuation character.

This gives around 50 bits of entropy on my system. [#wiki]_

See :mod:`keys.pwgen` for more information.

.. [#wiki]

Static Distribution

Call ``make`` to create [#zipapp]_ file containing all sources. Zipapp file
is written to ``dist`` directory and is directly executable by Python.

Additional requirement for Python 3.2 is ``funcsigs`` package.
It can be installed from pypy (``pip3 install funcsigs``).
Call ``make zipapp32`` to also embed funcsigs source into zipapp file.

.. [#zipapp]
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
keybox-keys-0.1.tar.gz (14.4 kB) Copy SHA256 Checksum SHA256 Source Jun 23, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting