kybercffi 1.0.0

Python CFFI bindings for Kyber post-quantum cryptography

KyberCFFI

Python CFFI buildings for post-quantum cryptography algorithm Kyber

Description

KyberCFFI provides Python bindings for the reference implementation of the Kyber cryptographic algorithm, winner of the NIST post-quantum cryptography competition. The library uses CFFI to efficiently interact with the original Kyber C code.

Supported variants

• Kyber512 - Security level 1 (equivalent to AES-128)
• Kyber768 - Security level 3 (equivalent to AES-192)
• Kyber1024 - Security level 5 (equivalent to AES-256)

Installation

pip install kybercffi

Requirements

• Python >= 3.8
• CFFI >= 1.15.0
• C compiler

Quick start

import kybercffi

# Create a Kyber768 instance
kyber = kybercffi.Kyber768()

# Generate key pair
public_key, secret_key = kyber.generate_keypair()

# Encapsulation (create shared secret)
ciphertext, shared_secret = kyber.encapsulate(public_key)

# Decapsulation (recover shared secret)
recovered_secret = kyber.decapsulate(ciphertext, secret_key)

# Verification
assert shared_secret == recovered_secret
print("Kyber работает корректно!")

Convenient functions

from kybercffi import generate_keypair, encapsulate, decapsulate

# Generate keys with specified security level
pk, sk = generate_keypair(security_level=3)  # Kyber768

# Encapsulation
ct, ss = encapsulate(pk, security_level=3)

# Decapsulation
ss2 = decapsulate(ct, sk, security_level=3)

Factory method

# Creating an instance via the factory
kyber512 = kybercffi.KyberKEM.create(security_level=1)   # Kyber512
kyber768 = kybercffi.KyberKEM.create(security_level=3)   # Kyber768
kyber1024 = kybercffi.KyberKEM.create(security_level=5)  # Kyber1024

Information about variants

# Getting information about all variants
info = kybercffi.get_kyber_info()
print(info)

# Getting version information
version_info = kybercffi.get_version_info()
print(version_info)

Size of key and encrypted text

Variant	Public key	Secret key	Ciphertext	Shared secret
Kyber512	800 bytes	1632 bytes	768 bytes	32 bytes
Kyber768	1184 bytes	2400 bytes	1088 bytes	32 bytes
Kyber1024	1568 bytes	3168 bytes	1568 bytes	32 bytes

Features

• ⚡ High performance - uses an optimized C implementation
• 🛡️ Post-quantum security - resistant to attacks from quantum computers
• 🌐 Cross-platform - works on Windows, Linux, macOS
• 📦 Easy installation - automatic compilation during installation
• 🔒 Cryptographically secure - based on the NIST reference implementation

License

The project is distributed under the MIT license. See the LICENSE file for details.

Author

Denis Magnitov

• Email: [e-mail]
• GitHub: Denis872

Links

• Repository
• PyPI
• Official Kyber Specification
• NIST Post-Quantum Cryptography

Support

If you encounter any problems or have any questions, please:

1. Check existing Issues
2. Create a new Issue with a detailed description of the problem
3. Specify the version of Python, OS, and kybercffi