Diagnostics API

The stable diagnostics API is mlx_lattice.backend_info(). It reports compiled extension metadata, version information, and backend capability strings. Use it to verify that the native module imported successfully or to attach environment details to bug reports.

Capability keys are diagnostic booleans:

cpu

The native CPU semantic backend is compiled.

metal

Metal kernels and the package metallib are available to the extension.

mlir

The extension was built with native MLIR artifact execution bindings. Published macOS wheels are expected to report True. False does not mean the artifact contract is unavailable; it means this install can save/load artifact bundles and may validate with lattice-opt, but cannot compile graph.mlir into a LatticeProgram in-process.

backend_info() does not select routes. Public operations still dispatch from the active MLX device, input dtype, relation metadata, shape predicates, and available backend kernels.

The underscored mlx_lattice._native module is an implementation module. Do not import it from application code.

Related pages

• Backend path selection: Backend path selection

• Convolution routes: Convolution routes

• Quantized routes: Quantization routes

mlx_lattice.backend_info()

Return version and compiled native capability diagnostics.

Capabilities include semantic CPU support, Metal backend availability, and native MLIR artifact execution support. They are diagnostic booleans, not route-selection controls.

Return type:

dict[str, object]