clipassgen 3.0.2

clipassgen (Console Smart Password Generator CLI) - Terminal-based smart password generator with deterministic password generation. Generate passwords from secret phrases - same secret always produces the same password, no storage required.

CliPassGen (Console Smart Password Generator) ^v3.0.2

---

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.

---

---

⚠️ 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

---

🔄 Breaking Change (v3.x.x)

⚠️ This release uses smartpasslib v3.x.x, which is NOT backward compatible with v2.x.x

Smart passwords created with v2.x.x or earlier will be different when generated with v3.x.x.

📖 Full migration instructions → see MIGRATION.md

---

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, and auth codes

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. Generate Random Passwords: Cryptographically secure random generation
4. Create Authentication Codes: Secure codes with character diversity
5. Interactive Terminal Mode: Menu-driven interface for easy use
6. Command Line Mode: Scriptable generation for automation
7. Cross-Platform Operation: Works on any system with Python
8. 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
• Four Generation Modes: Smart, Strong, Base, and Code
• Public Key Verification: Generate 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-1000 characters for passwords, 4-20 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 v3.x.x+ — The core library for deterministic password generation.

Key derivation (same as Python/JS/Kotlin/Go/C# versions):

Key Type	Iterations	Purpose
Private Key	30	Password generation (never stored, never transmitted)
Public Key	60	Verification (stored locally)

Character Set: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$&*-_

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 (BREAKING CHANGE in v3.x.x)
• Strong Password: Cryptographically secure random generation (unchanged)
• Base Password: Simple random password generation (unchanged)
• Authentication Code: Secure code generation for 2FA/MFA (unchanged)

---

Installation

pip install clipassgen==3.0.2

---

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

# Authentication code (2FA)
clipassgen --code -l 8

# Generate public key
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)
• Case-sensitive
• Use mix of: uppercase, lowercase, numbers, symbols, emoji, or Cyrillic
• 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)

❌ "password"                    — dictionary word, too short
❌ "1234567890"                  — only digits, too short
❌ "qwerty123"                   — keyboard pattern

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:

Platform	Application
Python CLI Manager	CLI PassMan
Desktop Python	Desktop Manager
Desktop C#	Desktop C# Manager
CLI C# Manager	CLI Manager (C#)
CLI C# Generator	CLI Generator (C#)
Web	Web Manager
Android	Android Manager
Core Libraries	smartpasslib, smartpasslib-csharp, etc.

Ecosystem

Core Libraries:

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

CLI Applications:

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

Desktop Applications:

• Desktop Smart Password Manager (Python)
• Desktop Smart Password Manager (C#)

Other:

• Web Smart Password Manager
• Android Smart Password Manager

Version History

Version	smartpasslib	Status	Migration Required
v2.1.6 and below	v2.x.x	❌ Deprecated/Unsupported	Must migrate to v3.x.x
v3.x.x+	v3.x.x	✅ Current	N/A

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.

---

Main Interface