Metadata-Version: 2.4
Name: securevault-pqc
Version: 0.1.0
Summary: Post-quantum file encryption using ML-KEM-768 + X25519
Home-page: https://github.com/yourusername/securevault
Author: Reggy Mane
Author-email: your.email@example.com
Project-URL: Bug Tracker, https://github.com/yourusername/securevault/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Security :: Cryptography
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: liboqs-python>=0.8.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: click>=8.1.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# SecureVault - Post-Quantum File Encryption
***Protect your files from future quantum computers.***
##

![Python Version](https://img.shields.io/badge/python-3.9%2B-blue)
![License](https://img.shields.io/badge/license-MIT-green)
![Platform](https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-lightgrey)
![Cryptography](https://img.shields.io/badge/crypto-ML--KEM--768-purple)
![NIST](https://img.shields.io/badge/NIST-Post--Quantum-orange)
![Status](https://img.shields.io/badge/status-active-success)


## The Problem
Quantum computers will break RSA/ECC encryption within 10-20 years. 
Attackers are stealing encrypted data NOW to decrypt LATER.

This is what we called "**harvest now, decrypt later**" attacks.

## The Solution
SecureVault uses ML-KEM-768 (NIST standardized post-quantum crypto) 
in hybrid mode with X25519 for maximum security. Even if quantum computers break one layer, your data stays protected.

## Features

- **Hybrid encryption**: X25519 + ML-KEM-768 (defense in depth²)
- **Password-protected keys**: PBKDF2 key derivation (100k iterations)
- **Cross-platform**: Works on Linux, macOS, and Windows
- **Future-proof**: Quantum-resistant for 30+ years
- **Easy CLI**: Simple commands, no crypto knowledge needed
- **Educational**: Shows security info about your files

## Installation

### Prerequisites
- Python 3.9 or higher
- pip

### Setup
```bash
# Clone the repo
git clone https://github.com/yourusername/securevault.git
cd securevault

# Install dependencies
pip install -r requirements.txt
```

## Quick Start
```bash
# 1. Generate your keypair
python3 secure_vault.py keygen --password mypassword --output my_keys.key
# Creates: my_keys.key (private) and my_keys_public.key (public)

# 2. Encrypt a file
echo "Secret data" > secret.txt
python3 secure_vault.py encrypt secret.txt my_keys_public.key

# 3. Check security info
python3 secure_vault.py info secret.txt.vault

# 4. Decrypt it
python3 secure_vault.py decrypt secret.txt.vault my_keys.key --password mypassword
```

## Technical Details
- Hybrid: X25519 + ML-KEM-768
- File encryption: AES-256-GCM (Fernet)
- Key derivation: PBKDF2

## Performance
[Benchmark results]

## Why This Matters
[Quantum threat timeline]
[Use cases]
