Repository navigation
FHElium 0.20.0 — A new architecture for FHE execution
FHElium 0.20.0
FHElium 0.20.0 redesigns how programs are represented, transformed, and executed on native CPU and NVIDIA CUDA backends. Eager execution and compiled Programs are now separate first-class programming models built on the same operation implementations and arithmetic resources.
Highlights
First-class Eager and Compile models
Use fhelium.eager.Engine for immediate, graph-free CKKS operations, or construct and transform Programs through fhelium.compile. Compile pipelines are caller-composable, allowing applications to choose lowering, CKKS state assignment, scheduling, resource binding, linking, and code-generation passes for each workload.
FHElium IR and shared Backend execution
FHElium’s intermediate representation (IR) models encrypted operations, lower-level residue arithmetic and polynomial transforms, control flow, and distributed operations as inspectable Programs. Caller-composable Compile passes can preserve high-level operations, lower them into logical compositions, assign CKKS state, resolve resources, and prepare Programs for execution.
The shared Backend maps registered operations to numerical implementations and live arithmetic resources. Compile links Programs through the Backend, while Eager calls the same implementations directly without constructing a Program. Both programming models therefore share native CPU and CUDA execution while retaining their own transformation, scheduling, and lifecycle behavior.
Native Windows support
FHElium now provides native Windows x86-64 wheels for supported CPython 3.12 and 3.13 environments, including CPU and NVIDIA CUDA configurations. Linux wheels and source installation remain supported.
Documentation
The documentation has been reorganized around the Eager, Compile, Backend, runtime, CUDA Graph, and distributed execution layers. New examples demonstrate built-in Compile pipelines, custom CKKS transformations, direct Backend execution, Python code generation, and rank-local collective Programs.
Compatibility
FHElium remains below version 1.0, and 0.20.0 contains breaking API and architecture changes from 0.10.0.
Full changelog: v0.10.0...v0.20.0