Files
zeekay b832ba2c39 Initial Torus commit
Forked from upstream concrete (BSD-3-Clause-Clear, © 2024 ZAMA) at HEAD
ecb729bb. Modifications copyright © 2026 Lux Industries Inc.

Rebranding scope:
  - Python module concrete → torus (across frontends/torus-python)
  - Rust module concrete-* → torus-* (across frontends/torus-rust)
  - MLIR dialect concretelang → toruslang (across compilers/torus-compiler)
  - Compiler optimizer concrete-optimizer → torus-optimizer
  - Backend concrete-cpu / concrete-cuda → torus-cpu / torus-cuda
  - Wire protocol concrete-protocol → torus-protocol
  - Parameter-curves concrete-security-curves-* → torus-security-curves-*
  - Public symbols concretelib → toruslib, ConcreteLang → TorusLang
  - URLs github.com/zama-ai/concrete → github.com/luxfhe/torus
  - URLs docs.zama.ai/concrete → docs.luxfhe.com/torus

Legal compliance:
  - LICENSE.txt retains original Copyright © 2024 ZAMA verbatim (§1-§2)
  - LICENSE.txt adds modifications copyright © 2026 Lux Industries Inc.
  - §3 endorsement clause: Torus is marketed exclusively as a Lux product;
    no Zama name used in README, docs, or marketing
  - NOTICE file provides factual attribution per legal best practice
    (not endorsement; required by upstream BSD-3-Clause-Clear)

README + NOTICE rewritten from scratch with Lux brand:
  - Quick-start in Python (torus.fhe)
  - Architecture diagram showing the gen-1 vtbl integration path
    (luxcpp/gpu → lux-private/gpu-kernels for CUDA/Metal/WebGPU)
  - Scheme coverage table: TFHE (luxfi/fhe), CKKS/BGV/BFV (luxfi/lattice)
  - Lux FHE family table: Torus / TorusVM / TorusEVM / TorusML / TorusNet

Known limitations (phase-2A scope):
  - PyPI package torus-fhe not yet published; the torus Python module
    is renamed structurally but pip-installable distribution is a
    follow-up (Phase 2A.1)
  - MLIR dialect rename is text-level; the compiler-internal LLVM
    rebuild (concrete-compiler-internal-llvm-project submodule) is
    structural and works; tablegen files renamed concrete→torus but the
    generated .inc files in the source tree will regenerate at build
    time
  - backends/torus-cuda/implementation/ is an upstream submodule
    pointer to the tfhe-rs source (not fetched in the staging clone);
    the CUDA backend body is delivered out-of-tree
  - ~100 test-fixture variable names like concrete_encoded_sample
    retain "concrete" as a math term (vs symbolic); these are inside
    tests/, not the public API; cleanup is a follow-up commit
  - 295 Python `from concrete import ...` residuals in luxfhe/ml-sdk
    consumer remain; that repo's import update is Phase 2B

This commit is the seed for the luxfhe/torus repo. Push as the first
commit to a fresh GitHub repo; do not re-import upstream Zama git
history.
2026-05-29 14:16:47 -07:00

135 lines
3.9 KiB
Python

"""
Benchmark primitive operations.
"""
# pylint: disable=import-error,cell-var-from-loop,redefined-outer-name
import random
import py_progress_tracker as progress
from torus import fhe
targets = []
configuration = fhe.Configuration()
# Table Lookup
for bit_width in range(2, 8 + 1):
targets.append(
{
"id": f"table-lookup :: tlu[eint{bit_width}]",
"name": f"{bit_width}-bit table lookup",
"parameters": {
"function": lambda x: x // 2,
"encryption": {"x": "encrypted"},
"inputset": fhe.inputset(lambda _: random.randint(0, (2**bit_width) - 1)),
"configuration": configuration,
},
}
)
# Encrypted Multiplication
for bit_width in range(2, 8 + 1):
targets.append(
{
"id": f"encrypted-multiplication :: eint{bit_width} * eint{bit_width}",
"name": f"{bit_width}-bit encrypted multiplication",
"parameters": {
"function": lambda x, y: x * y,
"encryption": {"x": "encrypted", "y": "encrypted"},
"inputset": fhe.inputset(
lambda _: random.randint(0, (2**bit_width) - 1),
lambda _: random.randint(0, (2**bit_width) - 1),
),
"configuration": configuration,
},
}
)
@progress.track(targets)
def main(function, encryption, inputset, configuration):
"""
Benchmark a target.
Args:
function:
function to benchmark
encryption:
encryption status of the arguments of the function
inputset:
inputset to use for compiling the function
configuration:
configuration to use for compilation
"""
compiler = fhe.Compiler(function, encryption)
print("Compiling...")
with progress.measure(id="compilation-time-ms", label="Compilation Time (ms)"):
circuit = compiler.compile(inputset, configuration)
progress.measure(
id="complexity",
label="Complexity",
value=circuit.complexity,
)
print("Generating keys...")
with progress.measure(id="key-generation-time-ms", label="Key Generation Time (ms)"):
circuit.keygen(force=True)
progress.measure(
id="evaluation-key-size-mb",
label="Evaluation Key Size (MB)",
value=(len(circuit.keys.evaluation.serialize()) / (1024 * 1024)),
)
# pylint: disable=unused-variable
print("Warming up...")
sample = random.choice(inputset)
encrypted = circuit.encrypt(*sample)
ran = circuit.run(encrypted)
decrypted = circuit.decrypt(ran) # noqa: F841
# pylint: enable=unused-variable
def calculate_input_output_size(input_output):
if isinstance(input_output, tuple):
result = sum(len(value.serialize()) for value in input_output)
else:
result = len(input_output.serialize())
return result / (1024 * 1024)
progress.measure(
id="input-ciphertext-size-mb",
label="Input Ciphertext Size (MB)",
value=calculate_input_output_size(encrypted),
)
progress.measure(
id="output-ciphertext-size-mb",
label="Output Ciphertext Size (MB)",
value=calculate_input_output_size(ran),
)
for i in range(10):
print(f"Running subsample {i + 1} out of 10...")
sample = random.choice(inputset)
with progress.measure(id="encryption-time-ms", label="Encryption Time (ms)"):
encrypted = circuit.encrypt(*sample)
with progress.measure(id="evaluation-time-ms", label="Evaluation Time (ms)"):
ran = circuit.run(encrypted)
with progress.measure(id="decryption-time-ms", label="Decryption Time (ms)"):
output = circuit.decrypt(ran)
progress.measure(
id="accuracy",
label="Accuracy",
value=int(output == function(*sample)),
)