Skip to main content

Crate frink_inference

Crate frink_inference 

Source
Expand description

Frink — a pure-Rust GGUF / MoE inference engine.

This crate is a facade. It contains no logic of its own: it re-exports the workspace under one name so a dependent writes one line in Cargo.toml instead of six, and so the project is findable on crates.io (the name frink belongs to an unrelated crate).

The command-line tools are not here. cargo install frink-cli installs the frink binary; frink-server is the OpenAI-compatible HTTP server. Shipping a second binary called frink from this crate would just fight the first one over ~/.cargo/bin.

§Layout

The stack, bottom to top:

ModuleCrateWhat it is
gguffrink-ggufGGUF mmap reader, sharded checkpoints
quantfrink-quantBlock layouts and fused dequant+dot
safetensorsfrink-safetensorsSafeTensors mmap reader
corefrink-coreTensor ops, RoPE, GQA, KV cache
[edge]frink-edgeServing policy: q* split, radix prefix caches, output parsers
moefrink-moeExpert routing and dispatch
modelsfrink-modelsLoaders and decoder stacks
[api]frink-apiRoute constants + wire DTOs (feature api)

§Example

use frink_inference::gguf::ShardedGguf;

let file = ShardedGguf::open("model.gguf")?;
println!("{} tensors", file.tensor_count());

§Features

  • metal — Apple Metal kernels. Apple Silicon only.
  • cuda — CUDA/NVRTC kernels. Needs a CUDA toolkit at build time. Held to “must compile”: there is no pinned benchmark host and no published receipts for it. See docs/FEATURES.md.
  • api — pull in frink-api for client-side route constants.

Neither GPU feature is on by default, because both are wrong to assume: metal does not build off Apple Silicon and cuda needs a toolkit that most machines do not have.

Re-exports§

pub use frink_core as core;
pub use frink_gguf as gguf;
pub use frink_models as models;
pub use frink_moe as moe;
pub use frink_quant as quant;
pub use frink_safetensors as safetensors;

Constants§

VERSION
The workspace version this facade was built from.