🔐 Vault - A Modern & Secure Password Manager

Vault is a secure, self-hosted password manager built with a Python backend and a modern, revolutionary web interface.
It allows you to store and manage your sensitive credentials locally, with all data encrypted on your disk.

⚠️ Disclaimer

This project is provided for educational purposes only. The author assumes no responsibility or liability for any data loss, account compromise, or security breach resulting from the use of this software. Although Vault uses secure encryption methods and local storage, it has not been professionally audited and is not intended for use in production environments or with real sensitive data. Use at your own risk.

---

✨ Features

• 🔒 Secure by Design: All passwords and sensitive data are encrypted using the cryptography library (AES-256 in GCM mode).
• 🗝️ Master Password: A single master password protects your entire vault.
• 🖥️ Modern Web GUI: An intuitive and beautiful interface built with HTML, CSS, and vanilla JavaScript.
• 📘 Detailed Entries: Store not only passwords but also usernames, URLs, categories, and notes.
• 🔎 Instant Search: Quickly find the account you're looking for.
• 🔐 Secure Password Generator: Create strong, random passwords directly from the app.
• 📋 Copy to Clipboard: Easily copy usernames and passwords with a single click.
• 💾 Local First: All your data stays on your machine. Nothing is sent to the cloud.

---

🛠️ Tech Stack

• Backend: Python 3, Flask
• Encryption: Fernet (from the cryptography library)
• Frontend: HTML5, CSS3, JavaScript (no frameworks)

---

🚀 Getting Started

Follow these instructions to get a copy of the project up and running on your local machine.

✅ Prerequisites

• Python 3.x
• pip package manager

---

🧪 Installation & Setup

1. Clone the repository:

   git clone https://github.com/your-username/vault-password-manager.git
   cd vault-password-manager
   

2. Create and activate a virtual environment (recommended):

   • On Windows:

     python -m venv venv
     .\venv\Scripts\activate

   • On macOS/Linux:

     python3 -m venv venv
     source venv/bin/activate

3. Install the required dependencies:

   pip install -r requirements.txt

4. Run the application:

   python backend.py

Usage

Once the server is running, open your web browser and navigate to:

http://127.0.0.1:5000/

• First Run: You will be prompted to create a strong master password.
• Subsequent Runs: You will need to enter your master password to unlock the vault.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.