🔐 PassGuardian: Smart Password Evaluator

PassGuardian is a smart, terminal-based password strength evaluator that helps you create and test strong, secure passwords in real time. It combines entropy analysis, breach detection, actionable feedback, and an optional password generator — all with a colorful, polished CLI experience.

---

🚀 Features

• 🧠 Entropy-based Strength Scoring
• 🔥 Real-time Breach Check via HaveIBeenPwned API
• 💡 Smart Feedback with improvement tips
• 🔁 Interactive Password Generator
• 🎨 Colorful CLI UI powered by rich
• 🔐 Built with Security Best Practices

---

🛠 Tech Stack

• Python 3
• rich (for colorful CLI output)
• requests (for HIBP breach API)
• Regex & logic-based password scoring
• Optional: HIBP Pwned Passwords API

---

📦 Installation via PyPI

You can install PassGuardian globally using pip:

pip install passguardian

Then launch it from your terminal:

passguardian

⚙️ How to Run

1. Clone the Repository

git clone https://github.com/nv2105/PassGuardian.git
cd PassGuardian

2. Set Up Virtual Environment

python -m venv .venv
source .venv/Scripts/activate  # On Windows
# Or: source .venv/bin/activate  # On Mac/Linux

3. Install Dependencies

pip install -r requirements.txt

4. Run the CLI App

python main.py

📸 Sample Output

🧠 Estimated Entropy: 83.36 bits
✅ No known breaches found for this password.

╭──────────── Result ────────────╮
│ 🔒 Password Strength: Strong!  │
╰───────────────────────────────╯

💡 Tips to Improve:
- Add at least one special character
- Avoid common patterns like '123', 'password'

📂 Project Structure

PassGuardian/
├── passguardian/
│   ├── evaluator.py
│   ├── breaches.py
│   ├── entropy.py
│   ├── generator.py
│   └── __init__.py
├── main.py
├── requirements.txt
├── .gitignore
└── README.md

📌 Author

Naman Vora

Final Year CSE | Aspiring Data Analyst

Github | LinkedIn

📄 License

MIT License