Skip to content
kckoboldcpp.dev
  • What is KoboldCppWhat it does and what it does not
  • DownloadWhich of the seven files you need
  • RequirementsWhat hardware you need
  • First modelFrom download to first reply
  • LauncherEvery tab and field explained
  • Lite UIThe built-in web interface
Most readWhich file do I download?The picker that chooses for your PC
  • WindowsInstall and first run
  • LinuxBinary, drivers and services
  • MacApple Silicon and Metal
  • AndroidRun it in Termux
  • ColabFree cloud notebook
  • Cloud GPUsRunPod, Vast and others
  • DockerContainers and environment settings
  • Build from sourceCompile it yourself
Most readInstall on WindowsOur most-read install guide
  • Best modelsWhat fits your VRAM, tested
  • QuantizationWhat Q4_K_M and friends mean
  • Hugging FaceFind and download GGUF files
  • Chat templatesTemplates and thinking models
Most readBest models by VRAMRecommendations with measured memory
  • GPU layersHow many layers fit your VRAM
  • Context sizeContext, ContextShift, KV cache
  • SpeedMake it faster
  • BackendsCUDA, Vulkan, CPU, Metal
  • NVIDIAOld and new GPUs
  • AMDVulkan and ROCm
  • Multi-GPUSplitting across cards
  • SamplersGeneration settings
  • FlagsEvery command-line option
  • .kcpps filesSaved configs and templates
Most readGPU layers and VRAMThe setting most readers get wrong
  • APIEndpoint explorer
  • OpenAI APIOpenAI-compatible endpoints
  • KoboldAI APIThe native API
  • SillyTavernExact connection settings
  • Other appsJanitor AI, Open WebUI, editors
  • Remote accessPhone or another PC
  • AI HordeShare your model, or use others
  • ImagesImage, video and music
  • VisionLet the model see images
  • VoiceWhisper and text to speech
  • EmbeddingsTextDB, web search, MCP
Most readConnect SillyTavernSettings we verified in a real run
  • TroubleshootingDecision tree for any problem
  • ErrorsEvery error string explained
  • Will not startCloses immediately or crashes
  • Out of memoryCUDA, Vulkan and Metal
  • Not using the GPUHow to tell and how to fix
  • Model will not loadUnknown architecture, bad files
  • Is it safeAntivirus, hashes, fake sites
Most readPaste your logFind the problem in seconds
Tools
Start
  • What is KoboldCpp What it does and what it does not
  • Download Which of the seven files you need
  • Requirements What hardware you need
  • First model From download to first reply
  • Launcher Every tab and field explained
  • Lite UI The built-in web interface
Install
  • Windows Install and first run
  • Linux Binary, drivers and services
  • Mac Apple Silicon and Metal
  • Android Run it in Termux
  • Colab Free cloud notebook
  • Cloud GPUs RunPod, Vast and others
  • Docker Containers and environment settings
  • Build from source Compile it yourself
Models
  • Best models What fits your VRAM, tested
  • Quantization What Q4_K_M and friends mean
  • Hugging Face Find and download GGUF files
  • Chat templates Templates and thinking models
Tune
  • GPU layers How many layers fit your VRAM
  • Context size Context, ContextShift, KV cache
  • Speed Make it faster
  • Backends CUDA, Vulkan, CPU, Metal
  • NVIDIA Old and new GPUs
  • AMD Vulkan and ROCm
  • Multi-GPU Splitting across cards
  • Samplers Generation settings
  • Flags Every command-line option
  • .kcpps files Saved configs and templates
Connect
  • API Endpoint explorer
  • OpenAI API OpenAI-compatible endpoints
  • KoboldAI API The native API
  • SillyTavern Exact connection settings
  • Other apps Janitor AI, Open WebUI, editors
  • Remote access Phone or another PC
  • AI Horde Share your model, or use others
  • Images Image, video and music
  • Vision Let the model see images
  • Voice Whisper and text to speech
  • Embeddings TextDB, web search, MCP
Fix
  • Troubleshooting Decision tree for any problem
  • Errors Every error string explained
  • Will not start Closes immediately or crashes
  • Out of memory CUDA, Vulkan and Metal
  • Not using the GPU How to tell and how to fix
  • Model will not load Unknown architecture, bad files
  • Is it safe Antivirus, hashes, fake sites
Tools
  • VRAM calculator Will it fit?
  • Config builder Commands and .kcpps
  • Log analyzer Decode a log
  • API tester Test and get snippets
Compare
  • Alternatives
  • vs Ollama
  • vs LM Studio
  • vs llama.cpp
  • vs text-generation-webui
  1. Home
  2. Home
  3. Get in touch

Last updated 13 Nov 2026

Get in touch

Email

hello@koboldcpp.dev. There is no contact form. We answer as soon as we can and do not promise a reply time.

What to send us

  • A correction: the page address, what is wrong and your evidence.
  • A test result that differs from ours: the KoboldCpp version, your machine and the whole log, redacted with the log analyzer, which hides names, addresses and keys.
  • A tool bug: the tool’s share link (it holds your inputs, never a key) and your browser.
  • An error message that is missing from the error list.

Our corrections policy

We check every report, re-test when a tested claim is disputed, and fix factual errors. Every substantive correction goes on the corrections log with its date and reason. Typo fixes are not logged.

Not for us

  • KoboldCpp bugs and feature requests: the project’s GitHub issues. Search first.
  • Community help: the KoboldAI Discord at koboldai.org/discord and r/KoboldAI.
  • Never send API keys, passwords or unredacted logs, to us or in public.

See also troubleshooting for what to include when you ask for help.

Frequently asked questions

How do I report a mistake?

Email hello@koboldcpp.dev with the page address, what is wrong and, if you can, the evidence: a version number, a log or a link. We check every report and record substantive corrections in public.

Can you fix my KoboldCpp?

We cannot: we are not the project and we do not offer support. Search the troubleshooting pages first, then ask on the project's GitHub issues, its Discord or its subreddit, and include a redacted log.

Related

  • GuideCorrectionsHow we handle corrections.
  • Tools and compareLog analyzerRedact your log before you send it.

Start

  • What is KoboldCpp
  • Download
  • Requirements
  • First model
  • Launcher
  • Lite UI

Guides

  • Windows
  • Linux
  • Mac
  • Android
  • Colab
  • Cloud GPUs
  • Docker
  • Build from source
  • Best models

Connect

  • API
  • OpenAI API
  • KoboldAI API
  • SillyTavern
  • Other apps
  • Remote access
  • AI Horde
  • Images
  • Vision

Fix

  • Troubleshooting
  • Errors
  • Will not start
  • Out of memory
  • Not using the GPU
  • Model will not load
  • Is it safe

Project

  • About
  • How we test
  • Corrections
  • Contact
  • Privacy
  • Terms
  • FAQ
  • KoboldAI family
  • Releases
  • hello@koboldcpp.dev

koboldcpp.dev is an independent guide. KoboldCpp is developed by LostRuins (Concedo) and contributors at github.com/LostRuins/koboldcpp. The project's own site is koboldcpp.net. We are not affiliated, and we never host KoboldCpp or models: every download link goes to GitHub.

Checked against KoboldCpp 1.124.2 · 2026-11-13

    No results. Try the troubleshooting tree or paste your log into the log analyzer.