Metadata-Version: 2.4
Name: cryptologin
Version: 1.1.3
Summary: Zero-Knowledge Authentication System - No Email, No Password, Just Your Secret
Author-email: erabytse <contact@fbfconsulting.org>
Maintainer-email: erabytse <contact@fbfconsulting.org>
License-Expression: Apache-2.0
Project-URL: Homepage, https://erabytse.github.io/cryptologin-website/
Project-URL: Documentation, https://docs.cryptologin.io
Project-URL: Repository, https://github.com/erabytse/CryptoLogin
Project-URL: Issues, https://github.com/erabytse/CryptoLogin.git/issues
Project-URL: Changelog, https://github.com/erabytse/CryptoLogin.git/releases
Keywords: authentication,security,cryptography,zero-knowledge,passwordless,aes-256-gcm,argon2id,fastapi
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration :: Authentication/Directory
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8
License-File: LICENSE
Requires-Dist: flash512-vanguard>=2.1.1
Requires-Dist: fastapi>=0.104.0
Requires-Dist: uvicorn[standard]>=0.24.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: slowapi>=0.1.9
Provides-Extra: postgres
Requires-Dist: psycopg2-binary>=2.9.9; extra == "postgres"
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: httpx>=0.25.0; extra == "dev"
Requires-Dist: httpx2>=2.0.0; extra == "dev"
Requires-Dist: black>=23.11.0; extra == "dev"
Requires-Dist: flake8>=6.1.0; extra == "dev"
Requires-Dist: mypy>=1.6.1; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Provides-Extra: full
Requires-Dist: cryptologin[postgres]; extra == "full"
Dynamic: license-file

<div align="center">

# ![Zero-Knowledge Authentication System](https://raw.githubusercontent.com/erabytse/CryptoLogin/main/images/logo.png)

## _Zero-Knowledge Authentication System_

**The Future of Authentication is Here. No Email. No Password. Just Your Secret.**

[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/cryptologin.svg)](https://pypi.org/project/cryptologin/)
[![CI Status](https://img.shields.io/badge/CI-Pending-yellow.svg)](https://github.com/erabytse/CryptoLogin)
[![Security](https://img.shields.io/badge/Security-Military%20Grade-red.svg)](SECURITY.md)
[![Stars](https://img.shields.io/github/stars/erabytse/CryptoLogin.svg)](https://github.com/yourusername/cryptologin)

## The time is now ripe for it

<img src="https://raw.githubusercontent.com/erabytse/CryptoLogin/main/images/CryptoLogin.gif" width="320" height="170" alt="CryptoLogin"/>

</div>

---

## 🚀 What is CryptoLogin?

**CryptoLogin** is a revolutionary **zero-knowledge authentication system** that eliminates the need for emails, passwords, or social logins.

### The Problem

- 🔓 Passwords are **stolen** daily
- 📧 Email verification is **slow** and **annoying**
- 🕵️‍♂️ Social logins **track** your users
- 💰 Authentication services are **expensive**

### The Solution

- 🔐 **One Master Secret** - All you need to remember
- 🛡️ **Military-Grade Encryption** - AES-256-GCM + Argon2id
- 🚫 **Zero-Knowledge** - Your secret never leaves your device
- ⚡ **Lightning Fast** - Register in seconds

---

## ✨ Key Features

| Feature                  | Description                    | Security          |
| :----------------------- | :----------------------------- | :---------------- |
| **Zero-Knowledge**       | Server never knows your secret | 🔒 **Military**   |
| **No Email Required**    | Register without email         | 🔒 **Privacy**    |
| **No Password Required** | Single master secret           | 🔒 **Simple**     |
| **AES-256-GCM**          | NIST standard encryption       | 🔒 **FIPS**       |
| **Argon2id**             | Memory-hard KDF                | 🔒 **OWASP**      |
| **SecureBuffer**         | Automatic memory wiping        | 🔒 **Military**   |
| **Data Vault**           | Encrypted user data            | 🔒 **Zero-Trust** |
| **REST API**             | FastAPI + OpenAPI              | 🔒 **Modern**     |
| **Rate Limiting**        | Brute-force protection         | 🔒 **Production** |

---

## 📦 Installation

```bash
# Install from PyPI
pip install cryptologin

# Or install from source
git clone https://github.com/erabytse/CryptoLogin.git
cd cryptologin
pip install -e .
```

🚀 Quick Start

```python
from cryptologin import CryptoLogin

# Initialize the system
auth = CryptoLogin()

# Register a user
user_id = auth.register(
    master_secret="my-super-secret-64-characters-minimum",
    user_data={"name": "John Doe", "email": "john@example.com"}
)

# Login
challenge = auth.login_init(master_secret)
session = auth.login_verify(master_secret, challenge)

# Access user data
data = auth.get_user_data(user_id, master_secret)
print(data)  # {"name": "John Doe", "email": "john@example.com"}
```

## 🏗️ Architecture

```text
┌─────────────────────────────────────────────────────────────────┐
│ CRYPTOLOGIN                                                     │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ [USER] → [API] → [UserManager] → [Data Vault] → [Storage]       │
│                                                                 │
│ 🔐 AES-256-GCM + Argon2id + SecureBuffer                       |
│ 🚫 Zero-Knowledge Architecture                                 |
│ ⚡ FastAPI + SQLite/PostgreSQL                                 |
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

## 🔒 Security Model

How It Works

```text
1. User creates a Master Secret
2. Secret is NEVER sent to the server
3. Server only stores:
   - User ID (derived from secret)
   - Challenge (encrypted with secret)
   - Vault Data (encrypted with secret)
4. Authentication via Challenge-Response
5. All data encrypted with AES-256-GCM
```

Security Certifications

| Standard      | Compliance        |
| ------------- | ----------------- |
| NIST FIPS 197 | ✅ AES-256        |
| OWASP ASVS    | ✅ Argon2id       |
| GDPR          | ✅ Zero-Knowledge |
| SOC2          | ✅ Audit Logs     |
|               |

📊 Comparison

| Feature              | CryptoLogin | Auth0  | Firebase | Clerk  |
| -------------------- | ----------- | ------ | -------- | ------ |
| Zero-Knowledge       | ✅          | ❌     | ❌       | ❌     |
| No Email Required    | ✅          | ❌     | ❌       | ❌     |
| No Password Required | ✅          | ❌     | ❌       | ❌     |
| Open Source          | ✅          | ❌     | ❌       | ❌     |
| Self-Hosted          | ✅          | ❌     | ❌       | ❌     |
| Military Encryption  | ✅          | ⚠️     | ⚠️       | ⚠️     |
| Price                | 💰Free      | 💰💰💰 | 💰💰     | 💰💰💰 |

🎯 Use Cases

- 🌐 Web Applications - Authentication without email/password

- 📱 Mobile Apps - Simple, secure login

- 🔒 Enterprise Apps - Zero-trust authentication

- 🏥 Healthcare - GDPR compliant authentication

- 💳 Fintech - High-security authentication

#

# 🧪 DEMO

Try it now

The interactive demo

Create an account in 2 seconds. One master secret. No personal data.

<b>[ONLINE DEMO](https://erabytse.github.io/cryptologin-website/)</b>

#

📚 Documentation

- API Reference

- Getting Started Guide

- Security Whitepaper

- Architecture Overview

#

🤝 Contributing

We welcome contributions! Please see our Contributing Guide.

Development Setup

```bash
# Clone the repository
git clone https://github.com/erabytse/CryptoLogin.git
cd cryptologin

# Install dev dependencies
pip install -e .[dev]

# Run tests
pytest tests/ -v

# Run the API
python run.py
```

#

📄 License

- Open Source: Apache 2.0

- Commercial: Available for enterprise use

#

🌟 Support the Project

- ⭐ Star the repository

- 🐛 Report issues

- 📝 Improve documentation

- 💰 Sponsor the project

- 🗣️ Spread the word

#

📞 Contact

- 📧 Email: contact@fbfconsulting.org

- 🐦 Twitter: @cryptologin (coming soon)

- 💬 Discord: Join our community (coming soon)

[©erabytse](https://erabytse.github.io/)

#

<div align="center">
Built with ❤️ by erabytse

Reinventing Authentication. One Secret at a Time.

A quiet rebellion against digital waste.

</div>
