← all repositories
Michael-A-Kuykendall/shimmy

Single-Binary LLM Server That Ditched C++ for WebGPU

One Rust binary replaces OpenAI's API for local GGUF inference on any GPU, no Python or C++ required.

5.7k stars Rust Inference · Serving
shimmy
Velocity · 7d
+6.3
★ / day
Trend
accelerating
star history

What it does

Shimmy is a single-binary inference server that exposes OpenAI-compatible endpoints for GGUF models. Under the hood it runs Airframe, a pure-Rust WebGPU engine that dispatches WGSL compute shaders to NVIDIA, AMD, Intel, and integrated GPUs without a C++ toolchain in sight. Existing OpenAI clients point at it and work unchanged.

The interesting bit

In v2.0 the project deliberately removed its llama.cpp backend and replaced it with a from-scratch Rust transformer runtime. A companion feature called TurboShimmy squeezes the KV cache down to 4-bit integers entirely inside WGSL shaders—no CPU roundtrips—cutting KV cache VRAM usage from roughly 512 MB to 72 MB on a 3B model at 2048 context, with the project reporting no retrieval degradation in needle-in-a-haystack tests at shorter context lengths.

Key highlights

  • Native GGUF support: model architecture and quantization specs are auto-derived from GGUF metadata instead of hardcoded constants
  • GPU math verification: every supported quantization type is cross-checked against a CPU reference implementation
  • Auto-discovery of models from HuggingFace cache, Ollama, LM Studio, and local directories
  • YaRN RoPE scaling with automatic KV cache allocation for user-defined context windows
  • Deterministic F32 precision throughout the inference pipeline

Caveats

  • The llama.cpp backend was removed in v2.0.0; v1.x users must migrate to Airframe
  • 7B-class models and MoE offloading are on the roadmap but not yet GPU-validated
  • Windows users with older GTX 10xx/16xx cards may encounter TDR resets during long prefills

Verdict

Ideal for developers who want a zero-dependency, drop-in local OpenAI replacement for small-to-medium GGUF models. If you need production-grade large-model inference today, wait for the pending validations to clear.

Frequently asked

What is Michael-A-Kuykendall/shimmy?
One Rust binary replaces OpenAI's API for local GGUF inference on any GPU, no Python or C++ required.
Is shimmy open source?
Yes — Michael-A-Kuykendall/shimmy is open source, released under the Apache-2.0 license.
What language is shimmy written in?
Michael-A-Kuykendall/shimmy is primarily written in Rust.
How popular is shimmy?
Michael-A-Kuykendall/shimmy has 5.7k stars on GitHub and is currently accelerating.
Where can I find shimmy?
Michael-A-Kuykendall/shimmy is on GitHub at https://github.com/Michael-A-Kuykendall/shimmy.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.