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)

Searching Database…

131.5K ·GitHub
这是什么?llama.cpp 是一个纯 C/C++ 实现,用于运行 LLM(以及 VLM)推理,配置简单,性能达到业界领先水平,可在本地或云端使用。
这是一个库还是可以直接用的工具?两者都是:它是一个 C/C++ 库(libllama),可以嵌入到你自己的代码中;同时它也提供基于该库构建的现成命令行工具,例如 'llama-cli' 和 'llama-server'。
我该如何让它运行起来?你可以从发布页面下载预编译的二进制文件,使用 Docker 运行,或者克隆仓库后按照构建指南从源代码编译。
所有后端都已经完全成熟、可以直接使用了吗?大多数后端(CUDA、Metal、Vulkan、HIP、SYCL、CANN 等)已经可以投入生产使用,但 OpenVINO 后端仍被标记为开发中。
它实际能在哪些硬件上运行?它支持 x86(AVX/AVX2/AVX512/AMX)、Apple Silicon 和 ARM(NEON、Accelerate、Metal)、RISC-V,以及 NVIDIA、AMD、Intel、摩尔线程和高通 Adreno 的 GPU。
什么是 ggml?ggml 是 llama.cpp 所基于的底层张量与计算库,提供底层数学运算和硬件后端支持。
它支持量化模型吗?支持,它可以使用 1.5 位到 8 位的整数量化,以减少内存占用,并在资源受限的硬件上加快推理速度。
我能通过网页界面而不是终端与它聊天吗?可以,'llama-server' 内置了网页界面,并提供 REST API,因此你可以像使用类似 ChatGPT 的本地应用一样使用它。
它能处理的不只是文本模型吗?可以,较新的版本支持直接通过 'llama' 命令行工具运行 VLM(视觉语言模型)会话。
Creator
ggml-org
Size
448.9 MB
Stars
131.5K
Age
3y
Commits · 90 Days