Simple Password Manager (Python)

Password manager with a curses-based TUI. Uses only the Python standard library.

Features

• Master password with PBKDF2-based key derivation
• Add/get/list/search/delete entries
• Generate passwords
• Export to JSON/CSV (JSON default)
• Clipboard copy (Wayland/X11/macOS/Windows)
• Terminal UI with arrow-key menu

Install

No dependencies beyond Python 3.10+.

Local dev (recommended):

python -m pip install -e .

On Ubuntu Wayland for clipboard support:

sudo apt-get update
sudo apt-get install wl-clipboard

On Ubuntu X11 for clipboard support:

sudo apt-get update
sudo apt-get install xclip

Tk fallback (optional):

sudo apt-get install python3-tk

Usage

You can run the CLI via the package (recommended) or the legacy wrapper script.

CLI

password-manager init
password-manager add --site example.com --username alice
password-manager get --site example.com
password-manager list
password-manager search --query gmail
password-manager copy --site example.com
password-manager export --format json --out vault.json

Module form:

python -m password_manager init
python -m password_manager add --site example.com --username alice
python -m password_manager get --site example.com
python -m password_manager list
python -m password_manager search --query gmail
python -m password_manager copy --site example.com
python -m password_manager export --format json --out vault.json

Legacy wrapper:

python password_manager.py init

TUI

password-manager-tui

Module form:

python -m password_manager.tui

Legacy wrapper:

python tui.py

Notes

• Vault file is vault.db in the working directory (override with PASSWORD_MANAGER_DB).
• This is a simple implementation and not a replacement for audited cryptography libraries.
• If you run the module form without installing, set PYTHONPATH=src.