# zml/zml

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/zml-zml).**

3,171 stars · 118 forks · Zig · apache-2.0

## Links

- GitHub: https://github.com/zml/zml
- Homepage: https://docs.zml.ai
- awesome-repositories: https://awesome-repositories.com/repository/zml-zml.md

## Topics

`ai` `bazel` `hpc` `inference` `xla` `zig`

## Description

zml is a machine learning model compiler and cross-platform inference engine that transforms model descriptions into optimized executable binaries for specific hardware accelerators. It functions as a model deployment toolkit and hardware-agnostic orchestrator, utilizing a tensor-based architecture definition to provide strong type checking during the compilation process.

The project distinguishes itself through the ability to shard tensors and distribute large-scale AI workloads across a logical mesh of multiple devices. It further supports the remote model lifecycle by authenticating and downloading gated model weights from cloud repositories to integrate them into a local inference engine.

The toolkit covers a broad range of capabilities, including model architecture validation against reference activations, cross-platform binary compilation for various operating systems, and the packaging of compiled models into container images and archives for server deployment. It also provides mechanisms for tensor buffer management and the porting of models from other formats.

## Tags

### Artificial Intelligence & ML

- [Cross-Platform Inference Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/cross-platform-inference-frameworks.md) — Provides a runtime that executes pre-trained models across different operating systems and hardware architectures using a unified codebase.
- [Model Deployment Toolkits](https://awesome-repositories.com/f/artificial-intelligence-ml/model-optimization/inference-deployment/model-deployment-toolkits.md) — Provides a comprehensive suite for fetching remote model weights and packaging compiled binaries into container images for server deployment. ([source](https://docs.zml.ai))
- [Cross-Hardware Model Inference](https://awesome-repositories.com/f/artificial-intelligence-ml/cross-hardware-model-inference.md) — Provides a unified codebase to execute pretrained models across heterogeneous hardware including CPUs, GPUs, and NPUs. ([source](https://cdn.jsdelivr.net/gh/zml/zml@master/README.md))
- [Cross-Hardware Workload Distribution](https://awesome-repositories.com/f/artificial-intelligence-ml/cross-hardware-workload-distribution.md) — Distributes large-scale AI workloads by partitioning tensors across a logical mesh of multiple hardware devices.
- [Distributed Model Execution](https://awesome-repositories.com/f/artificial-intelligence-ml/distributed-model-execution.md) — Processes large-scale AI workloads by distributing model execution across a logical mesh of multiple devices. ([source](https://cdn.jsdelivr.net/gh/zml/zml@master/README.md))
- [Distributed Model Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/distributed-model-orchestration.md) — Orchestrates the distribution of large-scale model workloads by sharding tensors across a logical mesh of devices.
- [Inference Execution](https://awesome-repositories.com/f/artificial-intelligence-ml/inference-execution.md) — Executes compiled models by preparing input arguments and retrieving results from device memory. ([source](https://docs.zml.ai/tutorials/write_first_model/))
- [Model Compilers](https://awesome-repositories.com/f/artificial-intelligence-ml/machine-learning/frameworks/training-systems/model-performance-optimizations/model-compilers.md) — Transforms high-level model definitions into optimized, hardware-specific executable machine code. ([source](https://docs.zml.ai/learn/concepts/))
- [Cross-Platform Deployments](https://awesome-repositories.com/f/artificial-intelligence-ml/machine-learning/infrastructure/model-deployment-and-serving/local-and-on-device-inference/edge-ai-model-deployment/cross-platform-deployments.md) — Optimizes and packages models for deployment across diverse hardware from edge devices to cloud GPUs.
- [Tensor-Parallel Inference Distributions](https://awesome-repositories.com/f/artificial-intelligence-ml/model-optimization/inference-deployment/model-deployment-toolkits/distributed-deployment-utilities/multi-gpu-distribution/tensor-parallel-inference-distributions.md) — Splits large model weights across multiple hardware devices using tensor parallelism to handle massive workloads.
- [Architectural Type Definitions](https://awesome-repositories.com/f/artificial-intelligence-ml/neural-network-architectures/architectural-type-definitions.md) — Uses structured types to define model layers and shapes for strong type checking during compilation. ([source](https://docs.zml.ai/learn/concepts/))
- [Pre-trained Model Application](https://awesome-repositories.com/f/artificial-intelligence-ml/pre-trained-model-application.md) — Loads and executes pre-trained model implementations for tasks like image classification and text generation. ([source](https://docs.zml.ai/tutorials/getting_started/))
- [Tensor-Based Architecture Definitions](https://awesome-repositories.com/f/artificial-intelligence-ml/tensor-based-architecture-definitions.md) — Implements a structured tensor-based architecture definition to ensure strong type checking throughout the model compilation process.
- [Model Architecture Validation](https://awesome-repositories.com/f/artificial-intelligence-ml/model-architecture-validation.md) — Ensures network structure integrity through strong typing and verification of layer outputs against reference activations.
- [Model Lifecycle Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/model-lifecycle-managers.md) — Authenticates and downloads gated model weights from cloud repositories for local inference integration.
- [Model Weight Management](https://awesome-repositories.com/f/artificial-intelligence-ml/model-weight-management.md) — Binds external weight files to model definitions for loading trained parameters into the inference engine. ([source](https://docs.zml.ai/howtos/))
- [Model Format Converters](https://awesome-repositories.com/f/artificial-intelligence-ml/neural-networks/model-format-converters.md) — Translates model weights and architectures from PyTorch into a structured representation compatible with the inference engine. ([source](https://docs.zml.ai))

### Part of an Awesome List

- [Architecture Definitions](https://awesome-repositories.com/f/awesome-lists/ai/local-model-deployment/small-language-models/model-development/architecture-definitions.md) — Describes AI models using structs and functions that process tensors for strong type checking during compilation. ([source](https://docs.zml.ai/tutorials/write_first_model/))

### Data & Databases

- [Model Architecture Definitions](https://awesome-repositories.com/f/data-databases/data-type-definitions/schema-type-synchronization/type-safe-schema-definitions/model-architecture-definitions.md) — Uses structured types to describe network architectures ensuring strong type checking during the compilation process.

### Development Tools & Productivity

- [Hardware-Specific Binaries](https://awesome-repositories.com/f/development-tools-productivity/build-tooling/build-orchestration-logic/build-orchestration-configuration/build-automation-systems/build-systems/binary-compilation-toolchains/server-binary-compilers/hardware-specific-binaries.md) — Translates model descriptions into optimized executable binaries tailored for specific CPU and GPU accelerators.
- [Cross-Architecture Binary Compilation](https://awesome-repositories.com/f/development-tools-productivity/cross-architecture-binary-compilation.md) — Compiles model code into executable binaries for multiple target hardware architectures and operating systems. ([source](https://docs.zml.ai/howtos/deploy_on_server/))
- [Cross-Platform Toolchains](https://awesome-repositories.com/f/development-tools-productivity/cross-platform-toolchains.md) — Implements a toolchain to build model code across diverse hardware architectures and operating systems from a single source.

### Operating Systems & Systems Programming

- [GPU-Accelerated Compilers](https://awesome-repositories.com/f/operating-systems-systems-programming/hardware-interfacing-drivers/hardware-acceleration/gpu-acceleration/gpu-accelerated-compilers.md) — Compiles model definitions into optimized binaries targeting GPU and CPU accelerators for high-performance execution.
- [Model Memory Managers](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/process-and-memory-management/memory-management/allocation-strategies/dynamic-memory-allocation/custom-memory-allocators/managed-memory-allocators/model-memory-managers.md) — Handles the allocation and transfer of weights and data between host memory and accelerator buffers. ([source](https://docs.zml.ai/learn/concepts/))
- [Device Buffer Managers](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/process-and-memory-management/memory-management/allocation-strategies/dynamic-memory-allocation/gpu-memory-allocators/unified-memory-managers/device-buffer-managers.md) — Provides a system for allocating and controlling hardware-resident memory buffers for tensor data.

### DevOps & Infrastructure

- [Remote Model Loading](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/cloud-storage/remote-model-loading.md) — Downloads model weights and configurations from cloud buckets and HTTPS endpoints. ([source](https://cdn.jsdelivr.net/gh/zml/zml@master/README.md))
- [Container Image Packaging](https://awesome-repositories.com/f/devops-infrastructure/container-image-packaging.md) — Bundles compiled model binaries and associated weights into container images for consistent server deployment.
- [Model Container Execution](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/model-container-execution.md) — Wraps compiled models into Docker containers with a unified binary entrypoint for consistent inference execution. ([source](https://docs.zml.ai/howtos/))

### Scientific & Mathematical Computing

- [Dimension Tagging](https://awesome-repositories.com/f/scientific-mathematical-computing/tensor-data-management/dimension-tagging.md) — Uses tagged tensors to simplify dimension handling and reduce errors during tensor operations. ([source](https://docs.zml.ai))

### Software Engineering & Architecture

- [Tensor Buffer Offset Assignment](https://awesome-repositories.com/f/software-engineering-architecture/memory-buffering/fixed-memory-buffers/tensor-buffer-offset-assignment.md) — Manages the allocation of tensor data within fixed memory buffers to optimize inference loading times. ([source](https://docs.zml.ai/tutorials/write_first_model/))

### Testing & Quality Assurance

- [Activation Validation](https://awesome-repositories.com/f/testing-quality-assurance/activation-validation.md) — Verifies layer accuracy by comparing outputs against reference activations to identify mathematical or naming errors. ([source](https://docs.zml.ai/howtos/howto_torch2zml/))
- [Reference Implementation Validation](https://awesome-repositories.com/f/testing-quality-assurance/reference-implementation-validation.md) — Verifies model conversion correctness by comparing layer outputs against trusted reference activations.