Smart Password Manager Desktop ^v4.0.3

• Zero-Storage Security — no passwords or secret phrases are ever stored or transmitted
• Decentralized Architecture — no central servers, no cloud dependency
• Deterministic Regeneration — passwords are recreated identically from your secret phrase
• Metadata Only — store only descriptions and verification keys
• Local Processing — all cryptographic operations happen on your device
• On-Demand Discovery — passwords exist only when you generate them

• Decentralized & Serverless — no central database, no cloud lock-in
• No Password Database — eliminates password storage completely
• Dark Theme Interface — easy on the eyes during extended use
• Public Key Verification — verify secret knowledge without exposure
• Table View — see all your password metadata at a glance
• Edit Functionality — update descriptions and lengths anytime
• Copy to Clipboard — quick password copying for account setup
• Export/Import — backup and restore functionality
• Desktop Native — no web dependencies or internet required
• QR Code Export — transfer password metadata to Android app via QR code

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

Smart passwords created with older versions cannot be regenerated using v4.0.3.

📖 Full migration instructions → see MIGRATION.md

Powered by smartpasslib — The core library for deterministic password generation.

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

Character Set:

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

Validation Rules: Secret phrase: min 12 chars · Password length: 12-100 chars

What's NOT stored: Secret phrase · The actual password · Any reversible password data

What IS stored (in ~/.config/smart_password_manager/passwords.json):

• Public verification key (hash of secret)
• Service description
• Password length parameter

Prerequisites: Python 3.7+, Git

# Clone repository
git clone https://github.com/smartlegionlab/smart-password-manager-desktop.git
cd smart-password-manager-desktop

# Create virtual environment (recommended)
python -m venv venv

# Activate virtual environment
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Launch application
python app.py

Creating Your First Password:

1. Click Add button
2. Enter service description (e.g., "GitHub Account")
3. Enter your secret phrase (minimum 12 characters, never stored)
4. Set password length (12-100 characters, 16-24 recommended)
5. Click Create Password — password appears for copying

Retrieving a Password:

1. Find service in table
2. Click Get button
3. Enter your secret phrase
4. Password regenerates identically for copying

Editing Password Metadata:

1. Click Edit button next to password
2. Update description or change length
3. Receive warning if changing length
4. Confirm changes

Security Model:

• Proof of Knowledge — public keys verify secrets without exposing them
• Decentralized Trust — no third party needed
• Deterministic Security — same secret + length = same password, always
• No Recovery Backdoors — lost secret = permanently lost access

Secret Phrase Requirements:

• Minimum 12 characters (enforced)
• Case-sensitive
• Use mix of: uppercase, lowercase, numbers, symbols
• Never store digitally

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

Smart Password Manager Desktop produces identical passwords to:

• CLI PassMan (Python)
• Desktop Manager (C#)
• Web Manager
• Android Manager

Core Libraries:

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

• Pointer-Based Security Paradigm — 10.5281/zenodo.17204738
  Architectural Shift from Data Protection to Data Non-Existence
• Local Data Regeneration Paradigm — 10.5281/zenodo.17264327
  Ontological Shift from Data Transmission to Synchronous State Discovery

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

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

Full legal disclaimer: See DISCLAIMER.md

License: BSD 3-Clause License