Terminal-based smart password generator with deterministic password generation. Generate passwords from secret phrases - same secret always produces the same password, no storage required.
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
⚠️ This release (v3.0.1) uses smartpasslib v3.0.0, which is NOT backward compatible with v2.x.x
Smartpasslib v3.0.0 introduces fundamental improvements:
- Stronger cryptographic algorithm — enhanced deterministic generation with better entropy distribution
- Improved performance — faster password generation, especially for longer passwords
- Better cross-platform consistency — identical results guaranteed across all platforms
- Extended character set support — wider range of special characters for stronger passwords
- Future-proof architecture — easier updates and security patches
- The core password generation algorithm has been completely redesigned
- Smart passwords created with v2.1.6 or earlier will be different when generated with v3.0.1
- Same secret phrase + same length = different password between versions
- If you use smart passwords for existing accounts — you must regenerate and update them
- Use the same secret phrases — they will produce new passwords in v3.0.1
- Update your passwords on all websites/services after upgrading
Important: This only affects smart passwords (deterministic from secret phrase). Random generation modes (--strong, --base, --code) are unaffected.
📖 Full migration instructions → see Migration Section
- Deterministic Generation: Same secret + same length = same password, every time
- Zero Storage: Passwords exist only when generated, never stored
- 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:
- Generate Smart Passwords: Deterministic passwords from secret phrases
- Create Public Keys: Verification keys for secret proof without exposure
- Generate Random Passwords: Cryptographically secure random generation
- Create Authentication Codes: Secure codes with character diversity
- Interactive Terminal Mode: Menu-driven interface for easy use
- Command Line Mode: Scriptable generation for automation
- Cross-Platform Operation: Works on any system with Python
- No Dependencies: Pure Python with smartpasslib core
Key Features:
- 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
- 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)
- 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
Powered by smartpasslib v3.0.0+ — The core library for deterministic password generation.
⚠️ BREAKING CHANGE NOTICE
smartpasslib v3.0.0 is NOT backward compatible with v2.x.x
Smart passwords generated with v2.x.x will be different when generated with v3.0.1 due to fundamental changes in the deterministic generation algorithm.
What this means for you:
- All smart passwords created with v2.1.6 or earlier must be regenerated and updated after upgrading
- Random generation modes (
--strong,--base,--code) are unaffected - Public keys generated from secrets will also be different in v3.0.1
Key principle (unchanged): Deterministic generation from secret phrase. Same input = same output within the same major version.
Generation Modes:
- Smart Password: Deterministic from secret phrase (BREAKING CHANGE in v3.0.1)
- Strong Password: Cryptographically secure random generation (unchanged)
- Base Password: Simple random password generation (unchanged)
- Authentication Code: Secure code generation for 2FA/MFA (unchanged)
Public Key System:
- Generated from secret phrase via enhanced algorithm
- Can be safely stored/shared to verify secret knowledge
- No way to derive secret from public key
- Note: v3.0.1 public keys are different from v2.x.x
Step 1: Identify affected passwords
- Any password generated with
--smartmode using v2.1.6 or earlier - Passwords from other modes (
--strong,--base,--code) are not affected
Step 2: Document your existing smart passwords
- Before upgrading, retrieve all smart passwords you actively use
- Save them temporarily in a secure location
Step 3: Upgrade to v3.0.1
# Update via pip
pip install clipassgen==3.0.1
# Or rebuild executable with new versionStep 4: Regenerate your smart passwords
# Use the SAME secret phrase as before
clipassgen --smart -s "your_secret_phrase" -l 16
# Password will be DIFFERENT from v2.x.xStep 5: Update your passwords on all services
- Replace old passwords with newly generated ones
- Test login before removing old access
Important: Random generation modes (--strong, --base, --code) work exactly the same — no action needed.
- New cryptographic algorithm — stronger and faster smart password generation
- NOT backward compatible with v2.x.x — smart passwords will be different
- Random generation modes unaffected —
--strong,--base,--codework as before - See migration section above for detailed upgrade instructions
- Minimum 12 characters enforced for all secret phrases
- Password length minimum increased from 4 to 12 characters
- Authentication codes remain 4-20 characters (for manual entry convenience)
- Better security guidance with strong/weak examples
Simplified Architecture:
- Login parameter removed - now uses only secret phrase
- Single smart password type - streamlined generation process
- Cleaner command-line interface - intuitive argument structure
- Unified generation API - consistent across all modes
Enhanced Terminal Interface:
- SmartPrinter class for beautiful centered and framed text output
- Interactive menu system with clear navigation
- Automatic terminal width detection for perfect formatting
- Visual feedback with clear success/error messages
Security Improvements:
- Updated cryptographic backend to smartpasslib v3.0.0
- Stronger public key generation with enhanced algorithms
- Hidden secret input via getpass for interactive mode
- Input validation with helpful error messages
User Experience:
- Length parameter flexibility (12-1000 characters for passwords, 4-20 for codes)
- Public key display for verification purposes
- Multiple generation modes in one tool
- Python 3.7+ required
- pip for package management
# Install from PyPI
pip install clipassgen==3.0.1
# For systems with package conflicts
pip install clipassgen==3.0.1 --break-system-packages
# Verify installation
clipassgen --help# Clone repository
git clone https://github.com/smartlegionlab/clipassgen.git
cd clipassgen
pip install .# Start interactive menu system
clipassgenInteractive Menu:
********************************************************************************
------------------- Console Smart Password Generator v3.0.1 --------------------
---------------------------------- Main Menu: ----------------------------------
1. Smart Password (from secret)
2. Strong Random Password
3. Base Random Password
4. Authentication Code
5. Help
0. Exit
Enter your choice:
Smart Password Generation:
# Generate 16-character password from secret
clipassgen --smart -s "MySecureSecretPhrase@2026" -l 16
# Output example: Xk8#pLq2$Rm9@zN5*wT7 (different from v2.x.x)Random Password Generation (Unchanged):
# Generate 20-character strong random password
clipassgen --strong -l 20
# Generate 16-character base random password
clipassgen --base -l 16Authentication Codes (Unchanged):
# Generate 8-character authentication code
clipassgen --code -l 8# Public keys are automatically shown in interactive mode
# Note: v3.0.1 public keys are different from v2.x.xBuild a standalone clipassgen.exe that runs without Python installation:
- Download project ZIP:
- Go to: https://github.com/smartlegionlab/clipassgen
- Click green "Code" button
- Select "Download ZIP"
- Extract to:
C:\clipassgen-master\
- Download Python installer from: https://python.org/downloads/
- Run installer
- IMPORTANT: Check "Add Python to PATH"
- Click "Install Now"
- Press
Win + R - Type
cmd, press Enter - Navigate to project folder:
cd C:\clipassgen-master
# Create virtual environment
python -m venv venv
# Activate it (IMPORTANT!)
.\venv\Scripts\activate
# You should see (venv) in your command prompt# Install PyInstaller in virtual environment
pip install pyinstaller
pip install smartpasslib==3.0.0# Build single .exe file
pyinstaller --onefile --console --name "clipassgen.exe" --additional-hooks-dir=. app.py
# Wait for build to complete (1-2 minutes)Location: C:\clipassgen-master\dist\clipassgen.exe
Create desktop shortcut:
- Open
C:\clipassgen-master\dist\folder - Right-click
clipassgen.exe - Select "Create shortcut"
- Drag shortcut to desktop
- Rename shortcut to "CLIPassGen"
- Double-click to start
Run from command line:
C:\clipassgen-master\dist\clipassgen.exe --help
C:\clipassgen-master\dist\clipassgen.exe --smart -s "mysecret" -l 16What you get:
- Single file:
clipassgen.exe(~10MB) - No Python required to run
- Works on any Windows 10/11 PC
- Can be copied to USB drive
1. Smart Password Mode:
- Type: Deterministic
- Input: Secret phrase + Length (secret min 12 chars)
- Output: Same password for same inputs within same major version
- Use Case: Account passwords, master passwords
- Security: Based on secret phrase strength
- Length Range: 12-1000 characters
⚠️ v3.0.1 change: Output differs from v2.x.x
2. Strong Password Mode:
- Type: Cryptographically random
- Input: Length only
- Output: Unique password each time
- Use Case: One-time passwords, temporary access
- Security: System cryptographic randomness
- Length Range: 12-1000 characters
- ✅ Unaffected by v3.0.1
3. Base Password Mode:
- Type: Simple random
- Input: Length only
- Output: Unique password each time
- Use Case: Low-security applications, testing
- Security: Basic randomness
- Length Range: 12-1000 characters
- ✅ Unaffected by v3.0.1
4. Authentication Code Mode:
- Type: Code-optimized random
- Input: Length only
- Output: Unique code each time
- Use Case: 2FA codes, PIN replacements
- Security: Character diversity optimized
- Length Range: 4-20 characters
- ✅ Unaffected by v3.0.1
Bash Script Example:
#!/bin/bash
# Auto-generate password for service deployment
echo "Generating database password..."
DB_PASSWORD=$(clipassgen --strong -l 24)
echo "Database password: $DB_PASSWORD"
echo "Generating API secret..."
API_SECRET=$(clipassgen --smart -s "ProductionAPISecret@$(date +%Y)" -l 32)
echo "API secret generated"Python Script Integration:
import subprocess
from smartpasslib import SmartPasswordMaster
# Method 1: Using subprocess
result = subprocess.run(
['clipassgen', '--smart', '-s', 'mysecret', '-l', '16'],
capture_output=True,
text=True
)
password = result.stdout.strip()
# Method 2: Direct library usage (no CLI overhead)
password = SmartPasswordMaster.generate_smart_password(
secret="your_secret_phrase",
length=16
)
# Generate public key for verification
public_key = SmartPasswordMaster.generate_public_key(
secret="your_secret_phrase"
)Account Setup Workflow:
# 1. Generate password for new account
clipassgen --smart -s "GitHubPersonal@2026" -l 20
# 2. Save public key for verification
# (Run interactive mode to get public key)
clipassgen
# Choose option 1, enter same secret, note public key
# 3. Use password for account creation
# Copy password from terminal to account setup formYour secret phrase is the only key to all your passwords. Keep it safe, keep it secret.
- At least 12 characters — shorter secrets are not accepted
- Case-sensitive — "MySecret" and "mysecret" are different
✅ "MyCat🐱Hippo2026" — emoji + mixed case + numbers
✅ "P@ssw0rd!LongSecret" — special chars + numbers + length
✅ "КотБегемот2026НаДиете" — Cyrillic + numbers
✅ "Correct-Horse-Battery-42" — memorable phrase with separator
❌ "password" — dictionary word, too short
❌ "1234567890" — only digits, too short
❌ "qwerty123" — keyboard pattern
❌ "mysecret" — common phrase, too short
- Unique per service - Different secret for each account type
- Memorable but complex - Phrases you can remember
- Case-sensitive - v3.0.1 enforces exact case matching
- No digital storage - Keep only in memory
- Backup plan - Physical written backup in secure location
Core Technology:
- smartpasslib - Core password generation library
CLI Management:
- CLI Smart Password Manager - Password metadata management
Desktop Application:
- Desktop Smart Password Manager - Graphical interface with editing
Web Interface:
- Web Smart Password Manager - Browser-based access
Individual Users:
- Generate passwords for personal accounts
- Create verification keys for backup
- Generate temporary access codes
Developers & DevOps:
- Generate secrets for application configuration
- Create API keys and tokens
- Generate database passwords for deployments
- Automation scripts requiring secure passwords
System Administrators:
- Generate service account passwords
- Create temporary access credentials
- Generate SSH key passphrases
- Bulk password generation for user onboarding
| Version | smartpasslib | Status | Migration Required |
|---|---|---|---|
| v2.1.6 and below | v2.x.x | ❌ Deprecated/Unsupported | Must migrate to v3.0.1 |
| v3.0.1+ | v3.0.0 | ✅ Current | N/A |
Copyright (©) 2026, Alexander Suvorov
- 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.
Your secret phrase is the cryptographic foundation
- Permanent data loss: Lost secret phrase = irreversible loss of all derived passwords
- No recovery mechanisms: No password recovery, no secret reset, no administrative override
- Deterministic generation: Identical input (secret + length) = identical output (password) within same version
- Single point of failure: Secret phrase is the sole input for smart password generation
- Secure memorization required: Digital storage of secret phrases is prohibited
Critical: Test password generation with non-essential accounts before production use
The security of your passwords depends entirely on your secret phrase.
- Minimum 12 characters is enforced by the application
- Short secrets (under 12 chars) are automatically rejected
- Weak secrets like "password123" or "qwerty" will be rejected
- Use a mix of: uppercase, lowercase, numbers, symbols, emoji, or Cyrillic
- A 12-character secret with diverse character types provides practical brute-force immunity
Remember: The app cannot recover your secret phrase. If you lose it, all passwords are permanently lost.
- v3.0.1 smart passwords are different from v2.x.x
- Random generation modes are unchanged
- Always verify password compatibility before upgrading critical systems
Version: 3.0.1 | Author: Alexander Suvorov
********************************************************************************
------------------- Console Smart Password Generator v3.0.1 --------------------
---------------------------------- Main Menu: ----------------------------------
1. Smart Password (from secret)
2. Strong Random Password
3. Base Random Password
4. Authentication Code
5. Help
0. Exit
Enter your choice: 1
--------------------------- Smart Password Generator ---------------------------
Generates password from your secret phrase.
Same secret + same length = same password every time.
IMPORTANT: Your secret phrase (minimum 12 characters):
• Is case-sensitive
• Should be memorable but secure
• Will generate the same password every time
Good examples: 'MyCat🐱Hippo2026' or 'P@ssw0rd!LongSecret'
Bad examples: 'password123', 'qwerty', 'mysecret'
Enter secret phrase (hidden):
Confirm secret phrase (hidden):
Enter length [12-1000] (default 16): 16
-------------------
Generated Password:
-------------------
tX3qcpEJyLfIOY!k
Length: 16 characters
Press Enter to continue...
------------------------------
Public Key (for verification):
------------------------------
a72d11657902c5f1f603898b4a40f7d83c9505955ce3932b287ee6e938312ae5
Store this key to verify your secret later.
Press Enter to continue...
---------------------------------- Main Menu: ----------------------------------
1. Smart Password (from secret)
2. Strong Random Password
3. Base Random Password
4. Authentication Code
5. Help
0. Exit
Enter your choice: 2
-------------------------- Strong Password Generator ---------------------------
Enter length [12-1000] (default 16): 16
-------------------
Generated Password:
-------------------
*lZ5T2tN95&psd&r
Length: 16 characters
Press Enter to continue...
---------------------------------- Main Menu: ----------------------------------
1. Smart Password (from secret)
2. Strong Random Password
3. Base Random Password
4. Authentication Code
5. Help
0. Exit
Enter your choice: 3
--------------------------- Base Password Generator ----------------------------
Enter length [12-1000] (default 16): 16
-------------------
Generated Password:
-------------------
H0AVnlpiDWmn&br!
Length: 16 characters
Press Enter to continue...
---------------------------------- Main Menu: ----------------------------------
1. Smart Password (from secret)
2. Strong Random Password
3. Base Random Password
4. Authentication Code
5. Help
0. Exit
Enter your choice: 4
------------------------ Authentication Code Generator -------------------------
Enter length [4-20] (default 8):
-------------------
Generated Password:
-------------------
XX0C&fg0
Length: 8 characters
Press Enter to continue...
---------------------------------- Main Menu: ----------------------------------
1. Smart Password (from secret)
2. Strong Random Password
3. Base Random Password
4. Authentication Code
5. Help
0. Exit
Enter your choice: 5
------------------------------------- Help -------------------------------------
-----------------
CLIPASSGEN v3.0.1
-----------------
For more information, visit the project page on GitHub: https://github.com/smartlegionlab/clipassgen/
============================================================
Press Enter to continue...
---------------------------------- Main Menu: ----------------------------------
1. Smart Password (from secret)
2. Strong Random Password
3. Base Random Password
4. Authentication Code
5. Help
0. Exit
Enter your choice: 0
---------------- https://github.com/smartlegionlab/clipassgen/ -----------------
---------- Copyright © 2026, Alexander Suvorov. All rights reserved. -----------
********************************************************************************
$ clipassgen --smart -s "GitHubSecret@2026" -l 18
TAuedL5DSZUYyJoq
$ clipassgen --strong -l 24
aB3$dE6&gH9*jL1@nO4%qR7^tU0)yX2
$ clipassgen --code -l 8
XX0C&fg0