Files
zeekay 531fc57003 chore(brand): purge Zama refs across docs, README, configs — phase 1
Brand-only sweep. Touches READMEs, docs, package metadata, comments,
notebook markdown, requirements.txt files; does NOT yet touch Python
`concrete.*` imports (those are module-level dependencies requiring the
phase-2 Python module port from `concrete` → `torus`).

Substitutions applied:

  Concrete ML                  → TorusML
  concrete-ml                  → torus-ml
  Concrete-ML                  → Torus-ML
  concrete_ml                  → torus_ml
  zama-ai/concrete-ml          → luxfhe/ml-sdk
  zama-ai/concrete             → luxfhe/torus
  github.com/zama-ai           → github.com/luxfhe
  docs.zama.ai/concrete-ml     → docs.luxfhe.com/ml-sdk
  docs.zama.ai/concrete        → docs.luxfhe.com/torus
  Zama Concrete ML             → Lux TorusML
  Zama Concrete                → Lux Torus
  Zama tfhe-rs / Zama TFHE-rs  → Lux-FHE
  tfhe-rs / TFHE-rs            → Lux-FHE
  Zama fhEVM / fhEVM           → TorusEVM
  Concrete framework           → Torus framework
  Concrete compiler            → Torus compiler
  Concrete by Zama             → Torus by Lux
  the Zama team                → the Lux Industries team
  Zama's                       → Lux Industries'
  (Zama)                       → (Lux)
  CoFHE / Fhenix               → (removed)

LICENSE: original Zama copyright RETAINED per BSD-3-Clause-Clear §1-§2
requirements; Lux Industries modifications copyright added. Per §3 no
name of ZAMA used to endorse the derived work — product marketed
exclusively as TorusML.

README image URLs migrated to github.com/luxfhe/ml-sdk/assets to break
the dependency on Zama's CDN.

Hit count: 350 → 295. Residual hits are Python `from concrete.fhe import`
imports referencing the upstream Zama `concrete` PyPI package; these
require module-level port (phase 2):

  Phase 2 plan:
    1. Fork zama-ai/concrete (the Python compiler) to luxfhe/torus
    2. Rename Python module `concrete` → `torus`; PyPI publish as `torus-fhe`
    3. Update ml-sdk imports from `concrete.fhe` → `torus.fhe`, etc.
    4. Wire `torus.compiler` GPU dispatch through `luxcpp/gpu` vtbl
       (lux-private/gpu-kernels for CUDA/Metal/WebGPU/FPGA targets)
    5. Port concrete-cuda + concrete-mlir kernels to
       lux-private/gpu-kernels/{cuda,metal,wgsl}/ckks/ (matrix-vector
       mul, rescale, rotate, bootstrap for TorusML inference)

  Phase 3 plan (kernels):
    - CKKS/BGV/BFV GPU kernels in lux-private/gpu-kernels/
      (currently only TFHE PBS / keyswitch / blind-rotate exist)
    - FPGA bitstreams in lux-private/fpga/ (currently scaffold only)

Phase 1 = docs/branding sweep. PR not opened; user reviews and merges.
2026-05-29 13:53:42 -07:00

188 lines
5.4 KiB
Python

"""Sanity checks, to be sure that our package is usable"""
import argparse
import random
import shutil
from pathlib import Path
import numpy
from concrete.fhe import Compiler, Configuration
from sklearn.datasets import make_classification
from sklearn.metrics import average_precision_score, confusion_matrix
from sklearn.model_selection import train_test_split
# pylint: disable=ungrouped-imports
from concrete import ml
from concrete.ml.sklearn import DecisionTreeClassifier as ConcreteDecisionTreeClassifier
# pylint: enable=ungrouped-imports
def ml_check(args, keyring_dir_as_str):
"""Test about TorusML functions"""
is_fast = args.fast
print(ml.__version__)
features, classes = make_classification(
n_samples=1000,
n_features=10,
n_classes=2,
n_informative=5,
n_redundant=0,
n_clusters_per_class=1,
weights=(0.2, 0.8),
)
classes = classes.astype(numpy.int64)
x_train, x_test, y_train, y_test = train_test_split(
features,
classes,
test_size=0.15,
random_state=42,
)
model = ConcreteDecisionTreeClassifier(n_bits=3, max_depth=6)
model.fit(x_train, y_train)
# Compute average precision on test
y_pred = model.predict(x_test)
average_precision = average_precision_score(y_test, y_pred)
print(f"Average precision-recall score: {average_precision:0.2f}")
y_pred = model.predict(x_test)
true_negative, false_positive, false_negative, true_positive = confusion_matrix(
y_test, y_pred, normalize="true"
).ravel()
num_samples = len(y_test)
num_spam = sum(y_test)
print(f"Number of test samples: {num_samples}")
print(f"Number of negatives in test samples: {num_spam}")
print(f"True Negative rate: {true_negative}")
print(f"False Positive rate: {false_positive}")
print(f"False Negative rate: {false_negative}")
print(f"True Positive rate: {true_positive}")
# Parameter `enable_unsafe_features` and `use_insecure_key_cache` are needed in order to be
# able to cache generated keys through `insecure_key_cache_location`. As the name suggests,
# these parameters are unsafe and should only be used for debugging in development
configuration = Configuration(
enable_unsafe_features=True,
use_insecure_key_cache=is_fast,
insecure_key_cache_location=keyring_dir_as_str,
compress_input_ciphertexts=True,
)
# We first compile the model with some data, here the training set
model.compile(
x_train,
configuration=configuration,
)
nb_samples = 1 if is_fast else 10
# Predict in FHE simulation for a few examples
y_pred_simulated = model.predict(x_test[:nb_samples], fhe="execute")
# Check prediction FHE simulation vs sklearn
print(f"Prediction FHE simulation: {y_pred_simulated}")
print(f"Prediction sklearn : {y_pred[:nb_samples]}")
print(
f"{numpy.sum(y_pred_simulated == y_pred[:nb_samples])}/{nb_samples} "
"predictions are similar between the FHE simulated model and the clear sklearn model."
)
def cn_check(args, keyring_dir_as_str):
"""Test about Concrete functions"""
is_fast = args.fast
def function_to_compile(x):
return x + 42
n_bits = 3
compiler = Compiler(
function_to_compile,
{"x": "encrypted"},
)
# Parameter `enable_unsafe_features` and `use_insecure_key_cache` are needed in order to be
# able to cache generated keys through `insecure_key_cache_location`. As the name suggests,
# these parameters are unsafe and should only be used for debugging in development
configuration = Configuration(
enable_unsafe_features=is_fast,
use_insecure_key_cache=is_fast,
insecure_key_cache_location=keyring_dir_as_str,
compress_input_ciphertexts=True,
compress_evaluation_keys=True,
)
print("Compiling...")
engine = compiler.compile(range(2**n_bits), configuration)
inputs = []
labels = []
nb_samples = 1 if is_fast else 4
for _ in range(nb_samples):
sample_x = random.randint(0, 2**n_bits - 1)
inputs.append([sample_x])
labels.append(function_to_compile(*inputs[-1]))
correct = 0
for idx, (input_i, label_i) in enumerate(zip(inputs, labels), 1):
print(f"Inference #{idx}")
result_i = engine.encrypt_run_decrypt(*input_i)
if result_i == label_i:
correct += 1
print(f"{correct}/{len(inputs)}")
def main(args):
"""Entry point"""
is_fast = args.fast
keyring_dir_as_str = None
if is_fast:
keyring_dir = Path.home().resolve() / "ConcretePythonKeyCache"
keyring_dir.mkdir(parents=True, exist_ok=True)
keyring_dir_as_str = str(keyring_dir)
print(f"Using {keyring_dir_as_str} as key cache dir")
ml_check(args, keyring_dir_as_str)
cn_check(args, keyring_dir_as_str)
if is_fast:
keyring_dir = Path.home().resolve() / "ConcretePythonKeyCache"
if keyring_dir is not None:
# Remove incomplete keys
for incomplete_keys in keyring_dir.glob("**/*incomplete*"):
shutil.rmtree(incomplete_keys, ignore_errors=True)
if __name__ == "__main__":
parser = argparse.ArgumentParser(allow_abbrev=False)
parser.add_argument(
"--fast",
action="store_true",
help="do a single test, just to check that the code is correct.",
)
cli_args = parser.parse_args()
main(cli_args)