pycryptox 1.0.1

Post-quantum cryptography library with built-in plausible deniability.

Pycryptox

Post-quantum cryptography library for Python.

Four protocols, one goal: protect your data against today's threats and tomorrow's quantum computers.

Protocol	What it does
PURPLE	Encrypt with a password
BLUE	Encrypt with asymmetric keys + plausible deniability
RED	Encrypt with a threshold (t-of-n)
YELLOW	Steganography (coming soon)

import pycryptox as crx

keys = crx.blue.genkeys("1")
bundle = crx.blue.encrypt("1", keys["gpubkey"], xmsg="real", ymsg="decoy")
crx.blue.decrypt("1", keys["xprivkey"], bundle)  # → "real"
crx.blue.decrypt("1", keys["yprivkey"], bundle)  # → "decoy"

Prerequisites

Pycryptox uses liboqs (via liboqs-python) for all ML-KEM-512 post-quantum operations. This dependency is not installed automatically because the current PyPI release of liboqs-python is broken — it must be installed from GitHub:

pip install git+https://github.com/open-quantum-safe/liboqs-python@0.12.0

This requires a C compiler, CMake, and Git. The first import oqs automatically downloads and compiles the liboqs C library (~2-5 min, one-time only). See installation guide for platform-specific instructions.

Installation

pip install pycryptox

Documentation

📖 English · Français

Tests

🧪 Test suite — 162 tests covering all protocols and keystores.

cd pycryptox/tests
python run_all.py

Credits

See CREDITS.md