Skip to main content

Unified GUI + engine for GGUF models: local LLM server, image/video generation and GGUF editing/quantization, all on one bundled gguf.cpp engine

Project description

gguf-cpp

One package for working with GGUF models locally: an OpenAI-compatible LLM server, a diffusion image/video/audio generator and a GGUF metadata/tensor editor with a built-in quantizer — three panels on one GUI, powered by one unified gguf.cpp engine compiled in a single build with a shared set of ggml kernels.

Install

pip install gguf-cpp

The build compiles the bundled engine (CPU by default, Metal on macOS). GPU backends are opt-in at install time:

GGUF_CPP_CUDA=1 pip install gguf-cpp     # NVIDIA
GGUF_CPP_HIP=1 pip install gguf-cpp      # AMD ROCm
GGUF_CPP_VULKAN=1 pip install gguf-cpp   # Vulkan

Run

gguf-cpp                 # unified GUI — Server / Diffuser / Editor panels
python -m gguf_cpp       # same thing

screenshot

Each panel also runs on its own, exactly like the standalone gguf-server / gguf-diffusion / gguf-editor packages did:

gguf-cpp server          # LLM server GUI
gguf-cpp diffuser        # image generation GUI
gguf-cpp editor          # GGUF editor GUI

And the engines are directly scriptable from the CLI:

gguf-cpp server engine -- --model model.gguf --port 8888
gguf-cpp diffuser engine -- -m sd.gguf -p "a lighthouse at dusk" -o out.png
gguf-cpp editor quantize -m in.gguf -o out-q4_k.gguf --type q4_k
gguf-cpp editor devices

Layout

vendor/engine/           the unified gguf.cpp engine (one CMake build)
  kernels/               shared ggml kernels (CPU + optional GPU backends)
  src/ common/ mtmd/     GGUF LLM runtime
  app/                   the gguf-server HTTP server
  diffusion/             diffusion runtime + CLI
  quantizer/             quantizer shared library (shares the kernels above)
src/gguf_cpp/            the Python package
  server/ diffuser/ editor/   the three panels (backend + web frontend each)
  gui.py static/         the unified 3-panel GUI shell

screenshot

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gguf_cpp-0.0.6.tar.gz (32.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gguf_cpp-0.0.6-py3-none-win_amd64.whl (62.4 MB view details)

Uploaded Python 3Windows x86-64

File details

Details for the file gguf_cpp-0.0.6.tar.gz.

File metadata

  • Download URL: gguf_cpp-0.0.6.tar.gz
  • Upload date:
  • Size: 32.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for gguf_cpp-0.0.6.tar.gz
Algorithm Hash digest
SHA256 11d3728cbda0dcf59d2415cef013349837740451cf57226cff8928a16888dc91
MD5 61564e9416dcb016b8e174bb8a0e498a
BLAKE2b-256 05d2ec449d746cee3da29c10d7b9b0a068a4d13e3b1d01fa7d5d5ace9e1d07ba

See more details on using hashes here.

File details

Details for the file gguf_cpp-0.0.6-py3-none-win_amd64.whl.

File metadata

  • Download URL: gguf_cpp-0.0.6-py3-none-win_amd64.whl
  • Upload date:
  • Size: 62.4 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for gguf_cpp-0.0.6-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 fee1adc223a406f0e2e6ee1e2b1cbeed8cf5e242ceaa853c3e033d6b6c2b01e3
MD5 889233f008c3b7e331a621772e67f32e
BLAKE2b-256 f0ccc5e48848d6521312e2011860eb917c746d0cc804756cae0c58d33c59a9a9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page