Voltar ao guia
RUNTIME / EASY

KoboldCpp

One-file GGUF chat on Windows, macOS or Linux with no Python install

Fonte primária
Check which models this runtime can serve on your hardwarePick a device or GPU to see only the models this runtime can serve there.
DifficultyEasySetup profile
Platforms5cpu · nvidia · amd · intel · apple
APIOpenAI + Ollama + KoboldCpp-compatible:5001
01 / INSTALL & RUN

Installation depends on your OS. These commands are examples or templates: replace placeholders and verify quantization, file format, drivers and runtime support. Memory fit does not guarantee deployment.

  1. 1
    InstallDownload the single-file release binary from the official GitHub releases (koboldcpp.exe on Windows)
  2. 2
    Start a modelkoboldcpp --model <downloaded-model.gguf> --usevulkan
  3. 3
    Connect your app

    OpenAI + Ollama + KoboldCpp-compatible · :5001. Keep the service bound to localhost unless you add authentication and network controls.

Atenção

The project warns that koboldcpp.com is an impersonation; since v1.123.1 (2026-10-13) the official community site is koboldcpp.net, while executable downloads remain only on the GitHub release page. GPU flags are not interchangeable: the portable command uses --usevulkan, which covers AMD, Intel and NVIDIA GPUs; --usecuda is NVIDIA-only, and macOS needs a Metal build rather than a flag; you can only use the accelerator libraries the release bundles. Since v1.122.1 (2026-09-26) the release also bundles its own agent harness (--agent) with MCP tool loading; its release notes ask for at least 28k context, an 8k generation budget and about 12 GB of VRAM, which is above what the small-memory lanes on this site can give it.

02 / COMPATIBLE MODELS

Modelos open-weight representativos

Alibaba Qwen

Qwen3.6 27B

27BQ4 / NVFP4 estimate
Memória estimada
~18.5 GB
Contexto
262K native
Alibaba Qwen

Qwen3.8 27B

27BQ4 estimate
Memória estimada
~19.5 GB
Contexto
262K native
Alibaba Qwen

Qwen3.6 35B-A3B

35B3B active · Q4 / NVFP4 MoE
Memória estimada
~25 GB
Contexto
262K native
DeepSeek

DeepSeek V4 Flash

284B13B active · Official FP4 + FP8 mixed
Memória estimada
~176 GB
Contexto
1M native
Google

Gemma 3 1B

1BINT4 / GGUF Q4
Memória estimada
~1.4 GB
Contexto
32K
Meta

Llama 3.2 3B

3BGGUF Q4
Memória estimada
~2.8 GB
Contexto
128K