Find a file
Aleksander Grygier fdf4c64604
ui: Stores consolidation refactor (#27238)
* ui: Remove dead code from stores

- persisted() helper was exported but never used
- messageUpdateCallback / registerMessageUpdateCallback were never wired up
- conversationsStore.initialize() alias, single caller moved to init()

* ui: Merge device, theme and viewport into a single deviceStore

All three are reactive browser-environment signals, now exposed as one
class store: deviceStore.isMobile, deviceStore.isIOSDevice / isIOSSafari
/ isWKWebView / isStandalone and deviceStore.systemTheme.isDark. The
systemTheme name disambiguates the OS preference from the user theme
preference in settingsStore. Drops the unused viewport export (only
isMobile was consumed).

* ui: Merge build info into version store

One VersionStore class with build (llama.cpp build number from
build.json) and frontend (PWA version from _app/version.json),
matching the class pattern of the other stores.

* ui: Colocate context gauge popup state with its components

The gauge popup state is local UI state shared only by the
ChatFormContextGauge subtree, so it lives next to its consumers
instead of the app-scope stores barrel.
2026-08-18 16:37:26 +02:00
.devops ci : Update OpenVINO to 2026.3, skip nemotron-h rollback test (#27292) 2026-08-18 12:02:22 +02:00
.gemini contributing: tighten AI usage policy (#18388) 2025-12-29 16:01:32 +01:00
.github ci : Update OpenVINO to 2026.3, skip nemotron-h rollback test (#27292) 2026-08-18 12:02:22 +02:00
.pi/gg ci : reduce builds in build-xcframework.sh (#27252) 2026-08-17 14:53:21 +03:00
app cmake : introduce semantic versioning (#26839) 2026-08-12 14:15:03 +02:00
benches benches : add Nemotron 3 Nano on DGX Spark (#20652) 2026-03-16 21:50:43 +02:00
ci ci : Update OpenVINO to 2026.3, skip nemotron-h rollback test (#27292) 2026-08-18 12:02:22 +02:00
cmake cmake : introduce semantic versioning (#26839) 2026-08-12 14:15:03 +02:00
common common: share thread pools when n_threads differ (#27138) 2026-08-18 16:23:43 +02:00
conversion model: support speculators-format checkpoints for DSpark (#26275) 2026-08-17 13:51:06 +02:00
docs ci : Update OpenVINO to 2026.3, skip nemotron-h rollback test (#27292) 2026-08-18 12:02:22 +02:00
examples build : fix xcframework + cmake clean-up (#27304) 2026-08-18 11:16:51 +03:00
ggml sycl: honor GGML_HINT_SRC0_IS_HADAMARD (#27298) 2026-08-18 21:21:25 +08:00
gguf-py model: support speculators-format checkpoints for DSpark (#26275) 2026-08-17 13:51:06 +02:00
grammars docs : fix typos in CUDA-FEDORA.md and grammars/README.md (#24459) 2026-06-15 01:33:38 +08:00
include cmake : introduce semantic versioning (#26839) 2026-08-12 14:15:03 +02:00
licenses refactor : remove libcurl, use OpenSSL when available (#18828) 2026-01-14 18:02:47 +01:00
media media : add transparent icon svg and png [no ci] (#15891) 2025-09-10 14:51:28 +03:00
models model: add Kimi-K3 text model (#26185) 2026-08-15 17:11:05 +02:00
pocs libs : rename libcommon -> libllama-common (#21936) 2026-04-17 11:11:46 +03:00
requirements requirements: use stable torch packages on s390x (#26864) 2026-08-11 21:58:53 +08:00
scripts sync : ggml 2026-08-18 11:30:03 +03:00
skills fix: check gguf array type before reading (#27075) 2026-08-15 11:45:30 +02:00
src quant : Optimise memory usage by evicting weights after processing each layer (#22877) 2026-08-18 16:22:32 +02:00
tests unicode : include '~' in collapsed symbol class (#26972) 2026-08-18 15:15:22 +02:00
tools ui: Stores consolidation refactor (#27238) 2026-08-18 16:37:26 +02:00
vendor build : fix xcframework + cmake clean-up (#27304) 2026-08-18 11:16:51 +03:00
.clang-format fix: apply clang-format to CUDA macros (#16017) 2025-09-16 08:59:19 +02:00
.clang-tidy clang-tidy : disable warning about performance enum size (#16127) 2025-09-22 19:57:46 +02:00
.dockerignore docker : prebuild web UI for s390x build [no release] (#24829) 2026-06-20 05:54:42 -05:00
.ecrc common : Update stb_image.h to latest version (#9161) 2024-08-27 08:58:50 +03:00
.editorconfig ui: Restructure repo to use tools/ui folder and ui / UI / llama-ui / LLAMA_UI naming (#23064) 2026-05-16 02:02:40 +02:00
.flake8 llama : move end-user examples to tools directory (#13249) 2025-05-02 20:27:13 +02:00
.gitignore ui: PWA support (#23871) 2026-06-12 15:53:26 +02:00
.gitmodules ggml : remove kompute backend (#14501) 2025-07-03 07:48:32 +03:00
.pre-commit-config.yaml convert.py : add python logging instead of print() (#6511) 2024-05-03 22:36:41 +03:00
AGENTS.md agents: clarify comment style and jinja knowledge (#26405) 2026-08-01 18:45:46 +02:00
AUTHORS readme : update status badges + regen AUTHORS (#27317) 2026-08-18 14:35:04 +03:00
build-xcframework.sh build : fix xcframework + cmake clean-up (#27304) 2026-08-18 11:16:51 +03:00
CLAUDE.md contributing: tighten AI usage policy (#18388) 2025-12-29 16:01:32 +01:00
CMakeLists.txt build : fix xcframework + cmake clean-up (#27304) 2026-08-18 11:16:51 +03:00
CMakePresets.json cmake : Add CMake presets for Linux and GCC (#14656) 2025-07-13 08:12:36 +03:00
CODEOWNERS HIP: remove rocWMMA FlashAttention (#26046) 2026-07-24 17:53:54 +02:00
CONTRIBUTING.md contrib : add guideline about the "merge ready" label (#26178) 2026-07-28 08:41:04 +03:00
convert_hf_to_gguf.py convert: add option to create separate dspark GGUF (#26452) 2026-08-02 23:16:31 +08:00
convert_hf_to_gguf_update.py Add support for Laguna XS.2 & M.1 (#25165) 2026-07-22 09:54:08 +08:00
convert_llama_ggml_to_gguf.py ci : switch from pyright to ty (#20826) 2026-03-21 08:54:34 +01:00
convert_lora_to_gguf.py convert : fix lora base model arch retrieval (#24621) 2026-06-15 00:55:26 +02:00
flake.nix fix(nix): remove non-functional llama-cpp cachix cache from flake.nix (#15295) 2025-08-13 11:21:31 -07:00
LICENSE docs : Minor cleanups (#19252) 2026-02-02 08:38:55 +02:00
Makefile make : remove make in favor of CMake (#15449) 2025-08-20 13:31:16 +03:00
mypy.ini convert : partially revert PR #4818 (#5041) 2024-01-20 18:14:18 -05:00
pyproject.toml model: add Mellum architecture (#23966) 2026-06-02 22:11:12 +03:00
pyrightconfig.json ci : switch from pyright to ty (#20826) 2026-03-21 08:54:34 +01:00
README.md readme : update status badges + regen AUTHORS (#27317) 2026-08-18 14:35:04 +03:00
requirements.txt tool-call: fix Qwen 2.5 Coder support, add micro benchmarks, support trigger patterns for lazy grammars (#12034) 2025-03-05 13:05:13 +00:00
SECURITY.md security : clarify about AI-generated reports (#26579) 2026-08-05 13:27:06 +02:00
ty.toml mtmd : DeepSeek-OCR image processing fixes, img_tool::resize padding refactor (#23345) 2026-05-20 17:37:10 +02:00

llama.cpp

llama

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.

  • Plain C/C++ implementation without any dependencies
  • Apple silicon is a first-class citizen - optimized via ARM NEON, Accelerate and Metal frameworks
  • AVX, AVX2, AVX512 and AMX support for x86 architectures
  • RVV, ZVFH, ZFH, ZICBOP and ZIHINTPAUSE support for RISC-V architectures
  • 1.5-bit, 2-bit, 3-bit, 4-bit, 5-bit, 6-bit, and 8-bit integer quantization for faster inference and reduced memory use
  • Custom CUDA kernels for running LLMs on NVIDIA GPUs (support for AMD GPUs via HIP and Moore Threads GPUs via MUSA)
  • Vulkan and SYCL backend support
  • CPU+GPU hybrid inference to partially accelerate models larger than the total VRAM capacity

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 [In Progress] 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

  • Contributors can open PRs
  • Collaborators will be invited based on contributions
  • Maintainers can push to branches in the llama.cpp repo and merge PRs into the master branch
  • Any help with managing issues, PRs and projects is very appreciated!
  • Read the CONTRIBUTING.md for more information

Acknowledgements

  • yhirose/cpp-httplib - Single-header HTTP server, used by llama-server - MIT license
  • nothings/stb - Single-header image format decoder, used by multimodal subsystem - Public domain
  • nlohmann/json - Single-header JSON library, used by various tools/examples - MIT License
  • mackron/miniaudio - Single-header audio format decoder, used by multimodal subsystem - Public domain
  • sheredom/subprocess.h - Single-header process launching solution for C and C++ - Public domain