Skip to main content

A light weight secure CLI tool for storing, retrieving, deleting, and generating encrypted passwords.

Project description

CryptKnox 🔐

CryptKnox is a lightweight CLI-based encrypted password manager written in Python. It allows you to securely store, retrieve, delete, and generate passwords using a single master password.

All stored credentials are encrypted locally using AES encryption, ensuring your secrets remain protected.


Features

  • 🔐 AES Encryption for secure password storage
  • 🗂 Store multiple accounts per service
  • 🔍 Retrieve specific services or all stored credentials
  • Delete credentials securely
  • 🔑 Generate strong random passwords
  • 💻 Simple CLI interface
  • 📦 Installable via PyPI

Installation

Install from PyPI:

pip install cryptknox

After installation you can run:

cryptknox --help

Usage

cryptknox --operation|-o [store|retrieve|delete|generate] [OPTIONS]

Operations

Store Credentials

Store a password for a service.

cryptknox -o store -m MySecretPassword -s gmail -u user@gmail.com -p mypassword

Options:

Option Description
--operation, -o Operation (store)
--master-password, -m Master password used for encryption
--service, -s Service name (example: gmail)
--username, -u Username for the service
--password, -p Password to store

Retrieve Credentials

Retrieve stored passwords.

Retrieve a specific service:

cryptknox -o retrieve -m MySecretPassword -s gmail

Retrieve all services:

cryptknox -o retrieve -m MySecretPassword -s all

Delete Credentials

Delete stored credentials.

Delete a specific service entry:

cryptknox -o delete -m MySecretPassword -s gmail

Delete all entries:

cryptknox -o delete -m MySecretPassword -s all

Generate Secure Password

Generate a random secure password.

cryptknox -o generate -l 12

Options:

Option Description
--length, -l Length of generated password (must be greater than 4)

The generated password includes:

  • uppercase letters
  • lowercase letters
  • numbers
  • special characters

Examples

Store credentials:

cryptknox -o store -m MySecretPassword -s github -u myuser -p mypassword

Retrieve all credentials:

cryptknox -o retrieve -m MySecretPassword -s all

Generate a strong password:

cryptknox -o generate -l 16

Delete credentials:

cryptknox -o delete -m MySecretPassword -s github

Security Notes

  • All credentials are encrypted before being stored.
  • Only the master password can decrypt the vault.
  • The master password is never stored.

⚠️ If the master password is lost, the vault cannot be recovered.


Requirements

  • Python 3.9+

License

MIT License


Author

Developed by Sreejith

GitHub: https://github.com/Sreejith-R-Mohan/cryptknox

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

cryptknox-0.1.14.tar.gz (8.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cryptknox-0.1.14-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

Details for the file cryptknox-0.1.14.tar.gz.

File metadata

  • Download URL: cryptknox-0.1.14.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for cryptknox-0.1.14.tar.gz
Algorithm Hash digest
SHA256 878f2f006a00a5d36fc57b04309dbd5dcced8314a9ee08d95de7e6c3e20857b1
MD5 4eb7906bde4781f20de93c8c1f43e58d
BLAKE2b-256 efaa5f168914d4c681b74671c4bb461785a63cff6c23d0e6276bacb6285e90cc

See more details on using hashes here.

File details

Details for the file cryptknox-0.1.14-py3-none-any.whl.

File metadata

  • Download URL: cryptknox-0.1.14-py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for cryptknox-0.1.14-py3-none-any.whl
Algorithm Hash digest
SHA256 e79cdd9c13ee756b47b2883e6ab457c57566ef692c1606b1866f4d572ee53d67
MD5 b0c8862cce58dfbadbac16b2f3c2f313
BLAKE2b-256 43a84e48a3d5cc051b41d04201d6ebf2cf99165170f0d40ff5a04986f747a6af

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page