whatisgithub

What is fluxinfer?

federicobarrosgiuffrida/fluxinfer — explained in plain English

Analysis updated 2026-05-18

1C++Audience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A command line tool that benchmarks your hardware and automatically finds the fastest settings for running AI models with llama.cpp.

Mindmap

mindmap
  root((FluxInfer))
    What it does
      Detects hardware
      Benchmarks configurations
      Saves reusable profiles
    Tech stack
      C++
      CMake
      llama.cpp
    Use cases
      Tune local model performance
      Compare GPU offload settings
      Launch tuned model servers
    Audience
      Developers
      Local AI hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find the fastest llama.cpp settings for a specific GPU and model automatically

USE CASE 2

Save and reuse a tuned performance profile instead of guessing settings

USE CASE 3

Compare CPU-only versus GPU-offloaded performance on your own hardware

What is it built with?

C++CMakellama.cppCLI11Catch2

How does it compare?

federicobarrosgiuffrida/fluxinferallentdan/shape_based_matchingamu2mod/radeonmon
Stars111
LanguageC++C++C++
Last pushed2019-03-01
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a working llama.cpp build already installed, plus a C++20 compiler and CMake to build FluxInfer itself.

Free to use for personal, research, hobby, or nonprofit purposes, but a separate paid license is required for commercial use.

So what is it?

FluxInfer is a command line tool that helps you get the best performance out of llama.cpp, a popular program for running AI language models on your own computer. Instead of guessing which settings will work well on your specific hardware, FluxInfer looks at your CPU, memory, and GPU, then automatically runs a small series of benchmark tests using a given model file to find the fastest working configuration. It saves that result as a reusable profile and can then launch the model for you using the settings it found. Importantly, FluxInfer does not build or modify llama.cpp itself. It only finds and runs the existing llama-bench, llama-cli, and llama-server programs that you have already built or installed separately, either through a folder you point it to, an environment variable, or your system's PATH. The tool reads real metadata directly from the model's GGUF file, such as how many layers it has, so its benchmark search is tailored to that specific model rather than using generic guesses. The project is explicitly labeled experimental. It has only been tested on one machine with two AI models and one graphics card so far, and the author is asking people with different hardware to share their results by opening an issue. Building it requires a C++20 compiler and CMake, with instructions given for both Windows and Linux, macOS is not yet supported. Most of its C++ dependencies are bundled directly in the project so a normal build does not need extra downloads. FluxInfer is released under the PolyForm Noncommercial License 1.0.0, which allows free use for personal, research, hobby, and nonprofit or educational purposes, but requires a separate paid license for any commercial use.

Copy-paste prompts

Prompt 1
Help me build FluxInfer from source on Windows using Visual Studio and CMake
Prompt 2
Explain what the fluxinfer tune command's staged benchmark search does
Prompt 3
Show me how to point FluxInfer at my existing llama.cpp build directory
Prompt 4
Walk me through reading the output of fluxinfer inspect for my hardware

Frequently asked questions

What is fluxinfer?

A command line tool that benchmarks your hardware and automatically finds the fastest settings for running AI models with llama.cpp.

What language is fluxinfer written in?

Mainly C++. The stack also includes C++, CMake, llama.cpp.

What license does fluxinfer use?

Free to use for personal, research, hobby, or nonprofit purposes, but a separate paid license is required for commercial use.

How hard is fluxinfer to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is fluxinfer for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.