whatisgithub

What is gguf_inference?

mann-e/gguf_inference — explained in plain English

Analysis updated 2026-05-18

5Jupyter NotebookAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A command line and notebook tool for running GGUF quantized image generation models like Flux 2 Klein from a terminal or remote server.

Mindmap

mindmap
  root((gguf inference))
    What it does
      Runs GGUF image models
      Terminal or notebook use
      Meta inspection flag
    Tech stack
      Python
      PyTorch
      GGUF format
    Use cases
      Remote server generation
      Notebook based generation
      Check quantization info
    Audience
      Developers
      GPU tinkerers

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

Generate images from GGUF quantized Flux 2 Klein or Flux 2 Dev models on a remote server or notebook without a GPU desktop app.

USE CASE 2

Inspect a GGUF model file's quantization details before running it using the meta only flag.

USE CASE 3

Run image generation from the terminal on services like RunPod or Google Colab that only expose a shell or notebook.

What is it built with?

PythonPyTorchJupyter NotebookGGUF

How does it compare?

mann-e/gguf_inferenceanil-matcha/face-aging-and-race-change-with-conditional-cycle-gankrishnaik06/testforestfires
Stars566
LanguageJupyter NotebookJupyter NotebookJupyter Notebook
Last pushed2019-10-122023-03-15
MaintenanceDormantDormant
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperresearchervibe coder

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a CUDA GPU with at least 8GB VRAM and a manually downloaded GGUF model file.

So what is it?

This project is a standalone command line and notebook tool for running image generation models that have been quantized into the GGUF file format, built on top of the ComfyUI GGUF node. It is meant as an alternative to running a full interface like AUTOMATIC1111 or ComfyUI when you only have access to a terminal, a remote server, or a JupyterLab notebook environment. The team built it as part of their own inference engine to keep their infrastructure costs down while supporting more model types over time. The README is upfront that the project's code was planned by one AI model and written by another, with no autonomous agents involved, just a human directing chat based coding tools. To use it, you install PyTorch along with a handful of Python libraries such as transformers, accelerate, safetensors and bitsandbytes, then clone the repository and download a quantized model file, for example a Klein 4B model in one of its GGUF quantization levels. A meta only flag lets you inspect a model file's quantization details before running it. From there, a single command line call generates an image, letting you set the model type, VAE source, text encoder mode, prompt, guidance scale, step count, resolution and output file. Currently supported models are Flux 2 Klein in both its 4B and 9B sizes, and Flux 2 Dev, along with their fine tuned variants. The smallest supported model still needs at least 8GB of video memory to run. The README lists no other known issues at this time. Planned future work includes adding LoRA support, support for older Stable Diffusion model families, and further GPU usage optimizations.

Copy-paste prompts

Prompt 1
Help me install the dependencies and run gguf_inference.py on a Flux 2 Klein 4B model.
Prompt 2
Explain what the --te-mode and --vae-source flags do and which values I should pick for my GPU.
Prompt 3
Show me how to check a GGUF model's quantization info before downloading the full file.
Prompt 4
What is the minimum VRAM needed to run the smallest supported model in this project?

Frequently asked questions

What is gguf_inference?

A command line and notebook tool for running GGUF quantized image generation models like Flux 2 Klein from a terminal or remote server.

What language is gguf_inference written in?

Mainly Jupyter Notebook. The stack also includes Python, PyTorch, Jupyter Notebook.

How hard is gguf_inference to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gguf_inference for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.