Skip to content

Repository files navigation

ZINC

ZINC

Fast, local GGUF inference for the GPUs people already own. ZINC is one Zig binary with a command line, browser chat, model manager, and OpenAI-compatible API.

CI status ZINC website ZINC Discord MIT license

Get started · See every benchmark · Read the docs · Join Discord

Faster on the hardware we test

ZINC beats the comparison llama.cpp build on prefill, decode, and combined time for all six models in the current Radeon AI PRO R9700 ROCm core suite. Both engines use the same GPU, GGUF files, prompts, reusable servers, warmups, and measured run counts.

ZINC ahead of llama.cpp across six model benchmarks on a Radeon AI PRO R9700 using ROCm

That is a scoped, reproducible result—not a claim about every model or GPU. The live benchmark page includes all four workloads, raw samples, exact prompts, build revisions, and the checked-in JSON.

Get running

ZINC needs Zig 0.15.2 or newer. Linux Vulkan builds also need glslc and a Vulkan loader; ROCm builds need a working ROCm installation.

git clone https://github.com/zolotukhin/zinc.git
cd zinc
zig build -Doptimize=ReleaseFast

./zig-out/bin/zinc --check
./zig-out/bin/zinc model pull qwen35-9b-q4k-m
./zig-out/bin/zinc --model-id qwen35-9b-q4k-m --prompt "Hello" --chat

Build the native AMD ROCm backend with:

ROCM_PATH=/opt/rocm zig build -Dbackend=rocm -Doptimize=ReleaseFast
ROCR_VISIBLE_DEVICES=0 ./zig-out/bin/zinc --check

See Getting started for package prerequisites and the first-run walkthrough, or use the dedicated ROCm setup guide.

Supported GPU paths

  • AMD Radeon: Vulkan and ROCm/HIP
  • Intel Arc: Vulkan
  • Apple Silicon: Metal
  • NVIDIA RTX: experimental CUDA

Backends have native kernels and are measured separately. The hardware guide keeps the validated cards, drivers, memory requirements, and current limitations in one place.

Models

ZINC works with local GGUF files and a managed model catalog. Current tuning work covers Qwen 3.5, Qwen 3.6, Qwen 3.8, Gemma 4, and Muse Glimmer.

You can also point directly at a file or Hugging Face repository:

./zig-out/bin/zinc -m /path/to/model.gguf --prompt "The capital of France is"
./zig-out/bin/zinc -hf Qwen/Qwen3-0.6B-GGUF:Q8_0 --prompt "Hello" --chat

Local server and API

./zig-out/bin/zinc chat --model-id qwen35-9b-q4k-m

This starts the browser chat and OpenAI-compatible API. Health checks are at /health; model listing and chat completions are under /v1. The API guide has curl and SDK examples.

Build, test, contribute

zig build -Doptimize=ReleaseFast
zig build test

Benchmark claims come from tools/performance_suite.mjs; published artifacts live in site/src/data/zinc-performance.json. Start with the development guide and contributing guide.

ZINC is active engineering work. If a model or GPU path is incomplete, the benchmark page leaves that result visible instead of quietly dropping it.

MIT licensed.

About

Zig INferenCe Engine — Local LLM inference on AMD GPUs and Apple Silicon

Topics

Resources

Code of conduct

Contributing

Stars

513 stars

Watchers

7 watching

Forks

Releases

Packages

Contributors

Languages