Overview
llmfit answers the question every local-model user hits first: which of these will actually run here? It inspects your CPU cores, system RAM, discrete and integrated GPUs, VRAM and accelerator configuration — covering NVIDIA CUDA, Apple Silicon, AMD ROCm and Intel OneAPI, including unified-memory architectures — and then scores candidate models against what it found.
The scoring is not a single pass/fail. A compatibility engine reads each model's parameter count, context length and quantization format (GGUF, AWQ, GPTQ, EXL2) to project memory footprint and tokens-per-second, then rates every model on quality, speed, fit and context so you can see the trade-off rather than just a yes or no. It handles multi-GPU setups, MoE architectures and dynamic quantization selection, and knows the local runtime providers you would actually serve through: Ollama, llama.cpp, MLX, Docker Model Runner and LM Studio.
Estimates can be replaced with measurements. From the TUI you can download a model, serve it, benchmark real tokens per second on your own machine, and submit the result back to the project as a pull request — no GitHub CLI or third-party account involved. Runs are saved locally first and your own numbers override the estimates in your fit table; merged submissions ship in the next release, so anyone on identical hardware sees measured figures before they benchmark anything themselves. Beyond the interactive TUI there is a classic CLI mode, a web dashboard, and a REST API (/api/v1/system, /api/v1/models) for wiring the same data into orchestrators and deployment pipelines.
What it does
- Hardware auto-detection for CPU cores, RAM, discrete/integrated GPUs, VRAM and unified memory across CUDA, Apple Silicon, ROCm and OneAPI
- Compatibility engine projecting memory footprint and tokens-per-second from parameter count, context length and quantization (GGUF, AWQ, GPTQ, EXL2)
- Scores every model on quality, speed, fit and context, with multi-GPU, MoE and dynamic quantization support
- Built-in benchmarking: download, serve and measure real tok/s, then contribute results upstream as a PR from the TUI
- Interactive TUI plus a classic CLI mode and a web dashboard
- REST endpoints (/api/v1/system, /api/v1/models) for integration into orchestrators and automated deployments
- Knows local runtime providers — Ollama, llama.cpp, MLX, Docker Model Runner and LM Studio
Getting started
llmfit is a single Rust binary with packages on most platforms. It runs macOS (Apple Silicon and Intel), Linux (x86_64 and ARM64) and Windows (x86_64); release binaries are code-signed.
Install on macOS or Linux
Homebrew ships a prebuilt binary, which works across macOS and Linux versions. MacPorts and a curl installer are also available.
brew install AlexsJones/llmfit/llmfit
# or, without sudo:
curl -fsSL https://llmfit.axjns.dev/install.sh | sh -s -- --localInstall on Windows
Scoop is the supported package manager; signed release binaries are also on the GitHub Releases page.
scoop install llmfitOr run it without installing
llmfit is published as a Python-installable tool too, so uv can fetch and run it in one step.
uv tool install -U llmfit
# or run it once:
uvx llmfitRun the TUI, or use the container
Launching with no arguments opens the interactive TUI. A multi-architecture image is published for headless web UI and API server modes as well.
docker run -it --rm ghcr.io/alexsjones/llmfit --tuiCommands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Decide which open-weight model and quantization to download before spending bandwidth on a file that will not fit
- Size a workstation or GPU purchase against the models you actually intend to run
- Replace estimated throughput with a measured benchmark on your own hardware, and share it back to the project
- Expose hardware and model-fit data to an orchestrator or deployment pipeline through the REST API
How llmfit compares
llmfit alongside other open-source local runtimes tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| Ollama | ★ 181k | A developer-friendly tool that downloads and runs local LLMs from the terminal with a built-in OpenAI-compatible API. |
| llama.cpp | ★ 128k | A C/C++ inference engine that runs LLMs in the GGUF format on CPUs, Apple Silicon, and GPUs with low memory use. |
| GPT4All | ★ 77.4k | GPT4All is a free desktop app and Python client that runs large language models locally on your own computer, with no API calls or GPU required. |
| LocalAI | ★ 49.1k | A self-hosted server that exposes an OpenAI-compatible API for running text, vision, voice, and image models on local hardware. |
| Jan | ★ 44.5k | An open-source desktop app that runs LLMs fully offline as a ChatGPT-style assistant on your own computer. |
| llmfit | ★ 36.4k | Inspects your hardware and tells you which local models will actually run well |
| AirLLM | ★ 34.3k | A Python inference library that keeps only one transformer layer on the GPU at a time, so a 70B model runs on a single 4GB card and a 671B MoE model on about 12GB, without quantization. |
| Colibrì | ★ 29.7k | A pure-C inference engine that keeps a Mixture-of-Experts model's dense trunk resident in RAM and streams its routed experts from disk, so 744B-2.8T models run on consumer hardware. |