Skip to main content

A secure password generator with brown-themed GUI and CLI interfaces

Project description

🍫 cacao-password

PyPI version Python 3.8+ License: MIT Code style: black

A secure password generator with both CLI and GUI interfaces, featuring a brown-themed design and comprehensive password analysis capabilities.

🌟 Features

  • Password Generation: Create cryptographically secure passwords with customizable options
    • Configurable password length
    • Character type selection (uppercase, lowercase, numbers, symbols)
    • Character filtering and exclusion options
    • Batch generation capabilities
  • Password Strength Analysis: Real-time entropy calculation and crack time estimation
  • Dual Interfaces:
    • Command-line interface for automation and scripting
    • Graphical user interface with intuitive brown-themed design
  • Configuration Management: Persistent settings stored in JSON format in user config directory
  • User-Friendly GUI Controls:
    • Password length slider
    • Symbol toggle switches
    • One-click generate button
    • Copy-to-clipboard functionality

📦 Installation

From PyPI (Recommended)

pip install cacao-password

⚡Usage

Command Line Interface

Launch the CLI:

cacao-password

The CLI provides interactive prompts for password generation options and displays both the generated password and its strength analysis.

Command Line Options

The CLI supports various options for automated password generation:

  • Interactive mode with guided prompts
  • Password strength analysis with entropy metrics
  • Configurable output formats

Graphical User Interface

Launch the GUI:

cacao-password --gui

The GUI features:

  • Password Length Slider: Adjust password length from 4 to 128 characters
  • Character Type Toggles: Enable/disable uppercase, lowercase, numbers, and symbols
  • Generate Button: Create new passwords with current settings
  • Copy Button: Copy generated passwords to clipboard
  • Strength Meter: Visual indicator of password strength and entropy
  • Settings Persistence: Your preferences are automatically saved

The interface uses a warm brown color scheme designed for comfortable extended use.

📚 Requirements

  • Python: >= 3.8
  • Dependencies:
    • cacao-password-generator: Core password generation library

🐍 Supported Python Versions

  • Python 3.8
  • Python 3.9
  • Python 3.10
  • Python 3.11
  • Python 3.12

⚙️ Security

  • Uses cryptographically secure random number generation
  • Implements industry-standard entropy calculations
  • Provides realistic crack time estimations
  • No password storage or network transmission
  • All generation happens locally on your machine

License

This project is licensed under the MIT License - see the LICENSE file for details.

Links


Copyright (c) 2025 Cacao Research

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

cacao_password-1.0.1.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

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

cacao_password-1.0.1-py3-none-any.whl (13.9 kB view details)

Uploaded Python 3

File details

Details for the file cacao_password-1.0.1.tar.gz.

File metadata

  • Download URL: cacao_password-1.0.1.tar.gz
  • Upload date:
  • Size: 13.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.7

File hashes

Hashes for cacao_password-1.0.1.tar.gz
Algorithm Hash digest
SHA256 b24638209183e0d7607489d636721aebbe9d33fa3a0539f43968d7397d0d0e5e
MD5 347a1019e583440af242bf12d8a00fd5
BLAKE2b-256 3ef489d67fefbcf400464dda458a3dbeb2bbf8ab095582e87f4af2b7bff4075d

See more details on using hashes here.

File details

Details for the file cacao_password-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: cacao_password-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 13.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.7

File hashes

Hashes for cacao_password-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c099bb750f9b3c87de41df2f276b9b4ae92f0501147e7fa7490e8c06087ff159
MD5 29f38cbb119771df8758f20c3ce27745
BLAKE2b-256 78968ba215fb24809a7d1b2c4ffb1694da8c12712a05a5bbc5f93504a263ba5b

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