CliPassGen (Console Smart Password Generator) ^v4.0.1

Terminal-based smart password generator with deterministic password generation. Generate passwords from secret phrases - same secret always produces the same password, no storage required.

Decentralized by Design: Unlike traditional password managers that store encrypted vaults on central servers, Smart Password Generator stores nothing. Your secrets never leave your device. Passwords are regenerated on-demand - no cloud, no database, no trust required.

Main Interface

Core Principles

• Zero-Storage Security: No passwords or secret phrases are ever stored or transmitted
• Decentralized Architecture: No central servers, no cloud dependency, no third-party trust required
• Deterministic Generation: Same secret + same length = same password, every time
• Memory-Based Security: Your brain is the only password database
• Terminal-First: Optimized for CLI workflows and scripting
• Multi-Mode Generation: Smart passwords, strong random, base passwords, auth codes, public keys, verification

What You Can Do:

1. Generate Smart Passwords: Deterministic passwords from secret phrases
2. Create Public Keys: Verification keys for secret proof without exposure
3. Verify Secrets: Check if a secret matches a stored public key
4. Generate Random Passwords: Cryptographically secure random generation
5. Create Authentication Codes: Secure codes with character diversity
6. Interactive Terminal Mode: Menu-driven interface for easy use
7. Command Line Mode: Scriptable generation for automation
8. Cross-Platform Operation: Works on any system with Python
9. No Dependencies: Pure Python with smartpasslib core

Key Features

• Decentralized & Serverless: No central database, no cloud lock-in, complete user sovereignty
• Deterministic Security: Identical input -> identical output, always
• Six Generation Modes: Smart, Strong, Base, Code, Public Key, Verify
• Public Key Verification: Generate and verify keys to prove secret knowledge
• Interactive & CLI Modes: Both menu-driven and command-line interfaces
• Hidden Input: Secret phrase entry via getpass (hidden typing)
• SmartPrinter Output: Beautiful centered and framed terminal text
• Length Flexibility: 12-100 characters for passwords, 4-100 for codes
• No Internet Required: All cryptographic operations local

Security Model

• Proof of Knowledge: Public keys verify secrets without exposing them
• Decentralized Trust: No third party needed - you control your secrets completely
• Deterministic Certainty: Mathematical certainty in password regeneration
• Ephemeral Passwords: Passwords exist only in memory during generation
• Local Computation: No data leaves your terminal
• No Recovery Backdoors: Lost secret = permanently lost passwords (by design)

Research Paradigms & Publications

• Pointer-Based Security Paradigm - Architectural Shift from Data Protection to Data Non-Existence
• Local Data Regeneration Paradigm - Ontological Shift from Data Transmission to Synchronous State Discovery

Technical Foundation

Powered by smartpasslib v4.0.1+ - The core library for deterministic password generation.

Key derivation (same as Python/JS/Kotlin/Go/C#/Rust versions v4.0.1):

Character Set (Google-compatible):

!@#$%^&*()_+-=[]{};:,.<>?/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyz

Validation Rules:

• Secret phrase: minimum 12 characters
• Password length: 12-100 characters
• Code length: 4-100 characters

Decentralized Architecture:

• No central authority required
• Metadata can be synced via any channel
• Your security depends only on your secret phrase
• Works offline - no internet connection required

Generation Modes:

• Smart Password: Deterministic from secret phrase
• Strong Password: Cryptographically secure random generation
• Base Password: Simple random password generation
• Authentication Code: Secure code generation for 2FA/MFA (4-100 chars)
• Public Key: Generate verification key from secret phrase
• Verify: Check secret against stored public key

Installation

git clone https://github.com/smartlegionlab/clipassgen
cd clipassgen
python app.py

or

pip install clipassgen==4.0.1

Quick Usage

Interactive Mode

clipassgen

Command-Line Mode

# Smart password (deterministic, CROSS-PLATFORM!)
clipassgen --smart -s "MyStrongSecretPhrase2026!" -l 16

# Strong random password
clipassgen --strong -l 20

# Base random password
clipassgen --base -l 16

# Authentication code (2FA) - up to 100 chars
clipassgen --code -l 8

# Generate public key from secret
clipassgen --public -s "MyStrongSecretPhrase2026!"

# Verify secret against public key
clipassgen --verify -s "MyStrongSecretPhrase2026!" -k "public_key_here"

Security Requirements

Secret Phrase

• Minimum 12 characters (enforced by library)
• Case-sensitive
• Use mix of: uppercase, lowercase, numbers, symbols
• Never store digitally
• NEVER use your password description as secret phrase

Strong Secret Examples

"MyStrongSecretPhrase2026!"   - mixed case + numbers + symbols
"P@ssw0rd!LongSecret"         - special chars + numbers + length
"КотБегемот2026НаДиете"       - Cyrillic + numbers

Weak Secret Examples (avoid)

"short"                       - too short, rejected by library
"password"                    - dictionary word, too short
"1234567890"                  - only digits, too short
"qwerty123"                   - keyboard pattern

Password Length Requirements

• Smart/Strong/Base passwords: 12-100 characters
• Authentication codes: 4-100 characters

Decentralized Nature

There is no "forgot password" button. This is by design:

• No central server can reset your passwords
• No support team can recover your access
• Your secret phrase is the ONLY key

This is the price of true decentralization - you are completely in control.

Cross-Platform Compatibility

CliPassGen produces identical passwords to:

Ecosystem

Core Libraries:

• smartpasslib - Python
• smartpasslib-js - JavaScript
• smartpasslib-kotlin - Kotlin
• smartpasslib-go - Go
• smartpasslib-csharp - C#
• smartpasslib-rs - Rust

CLI Applications:

• CLI Smart Password Manager (Python)
• CLI Smart Password Generator (Python) (this)
• CLI Smart Password Manager (C#)
• CLI Smart Password Generator (C#)
• CLI Smart Password Manager (Rust)

Desktop Applications:

• Desktop Smart Password Manager (Python)
• Desktop Smart Password Manager (C#)
• Desktop Smart Password Manager (Rust, GUI)
• Desktop Smart Password Manager (Rust, TUI)

Other:

• Web Smart Password Manager
• Android Smart Password Manager

License

BSD 3-Clause License

Copyright (©) 2026, Alexander Suvorov

Support

• Generator Issues: GitHub Issues
• Core Library Issues: smartpasslib Issues
• Documentation: Interactive help and this README

Note: Always test password generation with non-essential accounts first. Implementation security depends on proper usage.

Disclaimer

By using this software, you agree to the full disclaimer terms.

Summary: Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md