llmfit README

The project's README from github.com/AlexsJones/llmfit. As one markdown file: README.md.

llmfit

llmfit icon

English · 中文 · 日本語

CI Crates.io License Signed with SignPath

Find out which open-source Large Language Models (LLMs) your hardware can comfortably run. llmfit inspects your CPU, system RAM, GPU(s), VRAM, and accelerator configuration to recommend models across popular quantizations.

📊 New: benchmark & share — real numbers from your machine, better estimates for everyone. Download a model, serve it, and measure real tok/s on your hardware — then contribute the results back to the project as a PR, straight from the TUI. No gh CLI, no third-party account. Every run is saved locally first, your own measurements replace estimates in the fit table, and each merged submission ships in the next release: anyone on identical hardware gets measured ✓ numbers before they ever run a benchmark. Follow the step-by-step benchmarking guide →

Previously: llmfit 1.0 — the release where the numbers became verifiable →

Features

A terminal tool that right-sizes LLM models to your system's RAM, CPU, and GPU. Detects your hardware, scores each model across quality, speed, fit, and context dimensions, and tells you which ones will actually run well on your machine.

Ships with an interactive TUI (default) and a classic CLI mode. Supports multi-GPU setups, MoE architectures, dynamic quantization selection, speed estimation, and local runtime providers (Ollama, llama.cpp, MLX, Docker Model Runner, LM Studio).


Sister projects

demo


Documentation

Get started Install · Usage · How it works
Guides TUI guide · Benchmarking step-by-step · CLI & automation · Runtime providers · OpenClaw integration
Reference How it works (full) · Platform & GPU support · Custom models · Development
Project Contributing · Alternatives · Code signing · License

Install

Windows

scoop install llmfit

If Scoop is not installed, follow the Scoop installation guide.

macOS / Linux

Homebrew

Prebuilt binary (recommended, works on all macOS/Linux versions):

brew install AlexsJones/llmfit/llmfit

Or from the homebrew-core formula, which builds from source on macOS versions without a bottle:

brew install llmfit

MacPorts

port install llmfit

Quick install

curl -fsSL https://llmfit.axjns.dev/install.sh | sh

Downloads the latest release binary from GitHub and installs it to /usr/local/bin (or ~/.local/bin if no sudo).

Install to ~/.local/bin without sudo:

curl -fsSL https://llmfit.axjns.dev/install.sh | sh -s -- --local

uv / pip

To install or update llmfit:

uv tool install -U llmfit

To run without installing:

uvx llmfit

You can also install llmfit as a Python package in the normal way with tools such as pip or uv.

Pre-built Binaries

Download signed release binaries for Linux, macOS, and Windows directly from the GitHub Releases page.


Container Deployment

llmfit provides a multi-architecture Docker image (ghcr.io/alexsjones/llmfit) supporting both interactive CLI/TUI and headless Web UI / API server modes.

Interactive TUI

To launch the interactive TUI instead, pass the global --tui flag:

docker run -it --rm ghcr.io/alexsjones/llmfit --tui

Non-Interactive

This prints JSON from llmfit recommend command.

docker run ghcr.io/alexsjones/llmfit

This prints JSON from llmfit recommend command. The JSON could be further queried with jq.

podman run ghcr.io/alexsjones/llmfit recommend --use-case coding | jq '.models[].name'

To launch the interactive TUI instead, pass the global --tui flag:

docker run --rm -it ghcr.io/alexsjones/llmfit --tui

From source

git clone https://github.com/AlexsJones/llmfit.git
cd llmfit
cargo build --release
# binary is at target/release/llmfit

Usage

Terminal Interface (TUI)

Launch llmfit in your terminal without flags to start the interactive browser:

llmfit          # interactive TUI: your hardware, every model, ranked

The TUI shows your detected specs at the top and every model scored for fit, speed, quality, and context. See the TUI guide for navigation, planning, simulation, downloads, the community leaderboard, and benchmarking.

Keybindings inside the TUI:

Command Line Options

# Print hardware telemetry and recommended models to standard output
llmfit recommend

# Output system profile and recommendations in raw JSON format
llmfit recommend --json

# Start the native HTTP API server
llmfit serve --host 0.0.0.0 --port 8787

Web UI & API Server

docker run -d -p 8787:8787 ghcr.io/alexsjones/llmfit serve

Docker Compose

---
services:
  llmfit:
    image: ghcr.io/alexsjones/llmfit:latest
    container_name: llmfit
    restart: unless-stopped
    command: ["serve", "--host", "0.0.0.0", "--port", "8787"]
    ports:
      - "8787:8787"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8787/health"]
      interval: 15s
      timeout: 5s
      retries: 3
      start_period: 10s

For scripts, agents, and classic terminal output:

llmfit fit                    # table of all models ranked by fit
llmfit recommend --json       # top picks as JSON (agent/script consumption)
llmfit info "<model>"         # one model: fit analysis, estimate basis, verify commands
llmfit bench                  # measure real tok/s/TTFT against your running provider
llmfit doctor                 # hardware detection report for bug reports
llmfit serve                  # start the api and web user interface

Full reference: CLI & automation.


Community & Benchmarks

llmfit includes hardware detection and performance benchmarks contributed by the community. You can share your hardware benchmark results using:

llmfit bench --share

How it works

llmfit detects your hardware (RAM, CPU, GPU/VRAM, backend), then scores every model in its catalog across four dimensions: memory fit, estimated speed, quality, and context. Speed estimates come from a memory-bandwidth model grounded in runtime sampling and real community measurements — and every estimate ships its inputs, so llmfit info shows exactly what a number assumes and how to verify it on your machine.

Full detail, including the estimation formulas and the model database: How llmfit works.


Contributing

Contributions are welcome, especially new models.

Before submitting a PR

Please run cargo fmt before pushing your changes. Most CI check failures are caused by unformatted code:

cargo fmt

Guides for adding models — locally (no rebuild) or to the built-in catalog: Custom models.


Alternatives

If you're looking for a different approach, check out llm-checker -- a Node.js CLI tool with Ollama integration that can pull and benchmark models directly. It takes a more hands-on approach by actually running models on your hardware via Ollama, rather than estimating from specs. Good if you already have Ollama installed and want to test real-world performance. Note that it doesn't support MoE (Mixture-of-Experts) architectures -- all models are treated as dense, so memory estimates for models like Mixtral or DeepSeek-V3 will reflect total parameter count rather than the smaller active subset.


Code signing

llmfit's Windows release binaries are digitally signed (Authenticode) via SignPath.io, with a free code signing certificate provided by the SignPath Foundation.

Signing happens automatically in the release pipeline: only artifacts built by GitHub Actions from this repository are submitted for signing, and signing requests are approved by the project maintainer (@AlexsJones).

Code signing policy: see the SignPath Foundation code signing policy and terms.

Privacy: this program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. llmfit only contacts external services when you explicitly use the corresponding feature (e.g. model downloads, runtime provider queries, or the community leaderboard).


License

MIT

llmfit (AlexsJones/llmfit)

Searching Database…

38.1K ·GitHub
Что это такое?llmfit проверяет ваш процессор (CPU), оперативную память (RAM), видеокарты (GPU), видеопамять (VRAM) и настройку ускорителей, а затем сообщает, какие открытые LLM-модели и варианты их квантизации реально хорошо заработают на вашем компьютере.
Это CLI-утилита или есть ещё и GUI?По умолчанию это интерактивный TUI с классическим CLI-режимом, а также необязательная веб-панель и REST API (/api/v1/system, /api/v1/models) для скриптов и дашбордов.
Как установить и запустить?Установка через Homebrew или MacPorts на macOS/Linux, Scoop на Windows, uv/pip как Python-пакет, подписанный бинарный файл из GitHub Releases или Docker-образ ghcr.io/alexsjones/llmfit. Запуск llmfit без флагов открывает интерактивный TUI.
Нужно ли мне заранее установить Ollama или llama.cpp, чтобы пользоваться этим?Нет, llmfit работает автономно: он определяет ваше железо и оценивает модели. При желании он подключается к локальным провайдерам среды выполнения, таким как Ollama, llama.cpp, MLX, Docker Model Runner и LM Studio, если они у вас есть.
Точны ли показанные цифры о том, подойдёт ли модель и насколько быстро она будет работать?Нет, сначала это оценки на основе модели пропускной способности памяти. Вы можете запустить встроенный бенчмарк на своём компьютере и отправить реальные результаты в tok/s через PR. Измеренные значения заменяют оценки для всех, у кого такое же железо.
Нужна ли мне видеокарта NVIDIA или он работает и на компьютерах только с процессором, и на Apple Silicon?Он сам определяет всё, что у вас есть: NVIDIA CUDA, Apple Silicon, AMD ROCm или Intel OneAPI, на macOS, Linux (x86_64/ARM64) и Windows (x86_64).
Отправляет ли он данные о моём железе куда-нибудь?Нет, данные остаются на вашем компьютере, если вы сами не запустите сетевую функцию: загрузку модели, запрос к провайдеру среды выполнения или отправку результатов бенчмарка в публичный рейтинг сообщества.
Какие форматы моделей и архитектуры он понимает?Он анализирует количество параметров, длину контекста и форматы квантизации, включая GGUF, AWQ, GPTQ и EXL2. Кроме того, он явно поддерживает конфигурации с несколькими GPU и архитектуры MoE (Mixture-of-Experts).
Что такое llmfit-gui?Это отдельный родственный проект: нативное графическое приложение для Windows, написанное на PowerShell и WinForms. Оно позволяет просматривать рекомендации llmfit, загружать модели в LM Studio или Ollama и запускать бенчмарк кликами мыши, а не через терминал.
Чем это отличается от llm-checker?llm-checker реально скачивает и запускает модели через Ollama, чтобы измерить настоящую производительность, но считает все модели плотными (без поддержки MoE). llmfit же оценивает подходимость и скорость по характеристикам железа и не требует предварительной установки среды выполнения.
Есть ли другие связанные инструменты от того же автора?Да: sympozium для управления агентами в Kubernetes, llmserve как TUI для выбора и запуска локальной модели или бэкенда, и llama-panel, нативное приложение для macOS для управления локальными экземплярами llama-server.
Creator
AlexsJones
Size
32.4 MB
Stars
38.1K
Age
8mo
Commits · 90 Days