selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
ggrun logo

Self-host ggrun

v3.2.12

Local LLM launcher with automatic GPU memory placement

ReleaseOpen SourceMIT
Updated9 hours ago
LanguageGo
Setup difficultyModerate
Stars
282
Port
8081 (OpenAI-compatible API and Anthropic-compatible endpoint)
Install with Docker
ggrun screenshot 1

What is ggrun?

ggrun (from "gguf run") is a launcher for running local large language models on your own hardware. It provides a terminal UI for model discovery, downloads from Hugging Face, backend selection (llama.cpp, ik_llama.cpp, Vulkan), and automatic memory placement across GPUs and system RAM — especially for large MoE models. The tool builds a launch plan from the GGUF metadata and your hardware, checks that the plan fits in available VRAM/RAM, starts the inference server, and provides an OpenAI-compatible /v1 API alongside an Anthropic-compatible endpoint for Claude Code workflows. It supports speculative decoding, AI-assisted tuning of launch flags, and measured performance caching. Installation options include a one-line script, native Windows installer, Docker images (CPU, CUDA, Vulkan), and release bundles for Linux, macOS, and Windows.

Should you self-host ggrun?

ggrun scores 50/100 on selfhost.directory (how scoring works) and ranks #18 of 25 in LLM Inference. It has 282 GitHub stars.

It shipped 11 stable releases in the past year. The latest, v3.2.12, came out on 18 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is AnythingLLM (88/100, 67 666 stars). It scores higher overall, so compare the two before you pick. See ggrun vs AnythingLLM side by side.

Features

  • AI-assisted launch tuning
  • Anthropic-compatible endpoint for Claude Code
  • Benchmark mode
  • Dry Run Mode
  • Memory probing and validation
  • Model discovery and recommendations
  • Model download from Hugging Face
  • Model Management
  • Multi-GPU and CPU memory placement
  • NVIDIA bandwidth measurement
  • OpenAI Compatible API
  • Prompt caching for agent workflows
  • Speculative Decoding
  • Terminal UI (TUI)
  • Vision model support

ggrun README

How to install ggrun

Install ggrun with Docker

Docker
Environment variables
LLM_HOST=0.0.0.0, LLM_PORT=8081, LLM_MODEL_DIR=/models, LLM_CACHE_DIR=/cache

docker build -f docker/Dockerfile.cpu -t ggrun:cpu . docker run --rm -p 8081:8081 -v ~/ai_models:/models ggrun:cpu /models/model.gguf

CPU-only image, no GPU required

How to configure ggrun

  • LLAMA_SERVER/opt/ggrun/.bin/llama-serverPath to llama-server binary

    Path to llama-server binary

  • LLM_APP_HOME~/ggrunApp home directory path

    App home directory path

  • LLM_BACKENDautoBackend to use: auto, llama, ik_llama, vulkan

    Backend to use: auto, llama, ik_llama, vulkan

    values: auto, llama, ik_llama, vulkan

  • LLM_CACHE_DIR/cacheCache directory for AI Tune and model index

    Cache directory for AI Tune and model index

  • LLM_HOST0.0.0.0Host address for the server

    Host address for the server

  • LLM_INSTALL_BACKENDBackend to install or skip

    Backend to install or skip

    values: skip, cpu, cuda, vulkan

  • LLM_INSTALL_MODEInstaller mode: release or build

    Installer mode: release or build

    values: release, build

  • LLM_INSTALL_NONINTERACTIVERun installer non-interactively

    Run installer non-interactively

    values: 1

  • LLM_MODEL_DIR/modelsDirectory for GGUF models

    Directory for GGUF models

  • LLM_PORT8081Port for the server

    Port for the server

ggrun releases & version history

More in LLM Inference

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…