llama.cpp README

The project's README from github.com/ggml-org/llama.cpp. As one markdown file: README.md.

llama.cpp

llama

LLM inference in C/C++

License: MIT Release Nightly Server Docker Winget

ggml / ops / maintainer PRs / dev stats / lib llama API / llama-server REST API

Quick start

A few options to get llama.cpp installed on your machine:

Once installed:

# Download and run a model directly from Hugging Face
llama cli -hf ggml-org/Qwen3.5-0.8B-GGUF

# Launch OpenAI-compatible API server
llama serve -hf ggml-org/Qwen3.5-0.8B-GGUF
VLM session with `llama cli` VLM session with llama cli Built-in web UI against `llama serve` running Qwen 3.6 Built-in web UI against llama serve

Description

The main goal of llama.cpp is to enable LLM (and VLM) inference with minimal setup and state-of-the-art performance on a wide range of hardware - locally and in the cloud.

The llama.cpp project is build on top of the ggml library.

Supported backends

Backend Target devices
BLAS All
BLIS All
CANN Ascend NPU
CUDA Nvidia GPU
HIP AMD GPU
Hexagon Snapdragon
IBM zDNN IBM Z & LinuxONE
MUSA Moore Threads GPU
Metal Apple Silicon
OpenCL Adreno GPU
OpenVINO [In Progress] Intel CPUs, GPUs, and NPUs
RPC All
SYCL Intel GPU
VirtGPU VirtGPU APIR
Vulkan GPU
WebGPU All
ZenDNN AMD CPU

Documentation

Tools

Development

Contributing

Acknowledgements

llama.cpp (ggml-org/llama.cpp)

c
Searching Database…

131.5K ·GitHub
What is this?llama.cpp is a plain C/C++ implementation for running LLM (and VLM) inference with minimal setup and state-of-the-art performance, either locally or in the cloud.
Is this a library or a ready-to-use tool?Both: it is a C/C++ library (libllama) you can embed in your own code, and it also ships ready-made CLI tools like 'llama-cli' and 'llama-server' built on top of that library.
How do I get it running?You can download pre-built binaries from the releases page, run it with Docker, or build it from source by cloning the repository and following the build guide.
Is every backend fully finished and ready to use?Most backends (CUDA, Metal, Vulkan, HIP, SYCL, CANN, etc.) are production-ready, but the OpenVINO backend is still marked as in-progress.
What range of hardware does it actually run on?It covers x86 (AVX/AVX2/AVX512/AMX), Apple Silicon and ARM (NEON, Accelerate, Metal), RISC-V, and GPUs from NVIDIA, AMD, Intel, Moore Threads and Qualcomm Adreno.
What is ggml?ggml is the underlying tensor and compute library that llama.cpp is built on top of, providing the low-level math and hardware backends.
Does it support quantized models?Yes, it supports 1.5-bit through 8-bit integer quantization to cut memory use and speed up inference on constrained hardware.
Can I chat with it through a web UI instead of the terminal?Yes, 'llama-server' includes a built-in web UI alongside its REST API, so you can use it like a local ChatGPT-style app.
Can it handle more than just text models?Yes, newer builds support VLM (vision-language model) sessions directly through the 'llama' CLI.
Creator
ggml-org
Size
448.9 MB
Stars
131.5K
Age
3y
Commits · 90 Days