KoboldCpp
v1.120 open-sourceRun GGUF models easily with a KoboldAI UI. One File. Zero Install.
./koboldcpp-linux-x64 --model mymodel.gguf --usedirectio --gpulayers 40
koboldcpp --model mymodel.gguf --jinjathink
./koboldcpp-linux-x64 --model mymodel.gguf --jinjathink
koboldcpp --config mymodel.kcpps --allow-config-onready
curl http://localhost:5001/v1/audio/speech -H 'Content-Type: application/json' -d '{"model": "tts", "input": "Hello world", "response_format": "mp3"}' --output speech.mp3
koboldcpp-mac-arm64 --config mymodel.kcpps --failsafe
koboldcpp --model mymodel.gguf --sdmodel sdxl.gguf --sdvramlimit 6
koboldcpp --model gemma-4-26B-A4B-it-UD-Q4_K_M.gguf --draftmodel gemma-4-26b-A4B-it-assistant-Q4_0.gguf --debugmode
koboldcpp --model model.gguf --parallelrequests 4
koboldcpp --rpcmode host --rpcport 5551
koboldcpp --model model.gguf --rpcmode connect --rpctargets 192.168.1.50:5551
koboldcpp --usecuda --splitmode tensor --model my-model.gguf
koboldcpp --model my-model.gguf --reqtimeout 120
koboldcpp --model my-thinking-model.gguf --gendefaults '{"reasoning_effort":"minimal"}'
koboldcpp --model mymodel.gguf --quantkv q5_1
koboldcpp --model mymodel.gguf --baseconfig base_settings.json
koboldcpp --model gemma-4-26B-A4B-it-UD-Q4_K_S.gguf --mmproj mmproj-gemma4.gguf --useswa --jinja
koboldcpp --model qwen3-30b.gguf --jinja --chat-template-kwargs '{"enable_thinking":false}'
KCPP_ADMINPASSWORD=s3cr3tadmin KCPP_PASSWORD=s3cr3tuser koboldcpp --model mymodel.gguf
koboldcpp --model default.gguf --adminpassword mysecret --routermode
koboldcpp --model mymodel.gguf --sdlora ./loras/
koboldcpp --model Qwen3-TTS-12Hz-1.7B-Base-q8_0.gguf --ttsgpu
koboldcpp --musicllm ace-step-lm.gguf --musicdiffusion ace-step-diffusion.gguf --musicembeddings ace-step-embedder.gguf --musicvae ace-step-vae.gguf
curl http://localhost:5001/api/show -d '{"name": "my-model"}'
./koboldcpp --model https://example.com/model.gguf --downloaddir /mnt/models
./koboldcpp --model <flux2-model.gguf> --sdvaeauto
./koboldcpp-linux-x64 --model mymodel.gguf --device Vulkan0,Vulkan1
koboldcpp --model mymodel.gguf --gendefaults '{"temperature": 0.7, "top_k": 40}'
koboldcpp --model mymodel.gguf --sdmodel wan2.2.gguf --sdvaeauto
koboldcpp --model mymodel.gguf --smartcache --host 0.0.0.0 --port 5001
koboldcpp --model mymodel.gguf --autofit
curl http://localhost:5001/lcpp/v1/chat/completions -H 'Content-Type: application/json' -d '{"model": "koboldcpp", "messages": [{"role": "user", "content": "Tell me a story"}, {"role": "assistant", "content": "Once upon"}]}'
koboldcpp --model mymodel.gguf --jinja
koboldcpp --testmemory
koboldcpp --model mymodel.gguf --overridekv rope_freq_base=500000,rope_freq_scale=1.0
koboldcpp --sdmodel wan2.2-14b.gguf --sdvae wan_2.1_vae.safetensors --sdt5xxl umt5-xxl-q8_0.gguf --sdoffloadcpu --sdvaecpu
koboldcpp -m ./model.gguf -c 8192 -ngl 35 --flash-attn -fa --override-tensor -ot some_tensor=CPU
koboldcpp --model ./model.gguf --ratelimit 10
curl http://localhost:5001/v1/audio/voices
koboldcpp --model my-llm.gguf --sdmodel my-sd-model.gguf --sdquant 2 --sdflashattention
koboldcpp --model my-llm.gguf --overridenativecontext 4096
koboldcpp --model mixtral-8x7b.gguf --moecpu
koboldcpp --model mixtral-8x7b.gguf --moecpu 4 --gpulayers 32
koboldcpp --model Qwen2.5-Omni-3B-Q4_K_M.gguf --mmproj mmproj-Qwen2.5-Omni-3B-Q8_0.gguf --usecuda
koboldcpp --model main-model.gguf --embeddingsmodel embed-model.gguf --embeddingsmaxctx 512
koboldcpp --model mymodel.gguf --embeddingsmaxctx 2048
koboldcpp --model mymodel.gguf --singleinstance
koboldcpp.exe --model mymodel.gguf --useswa
koboldcpp.exe --model mymodel.gguf --enableguidance
koboldcpp.exe --model mymodel.gguf --mmproj myproj.gguf --mmprojcpu --gpulayers 999
koboldcpp.exe --model mymodel.gguf --blasbatchsize -1
koboldcpp.exe --model mymodel.gguf --overridekv llama.context_length=uint32:8192
koboldcpp.exe --model mymodel.gguf --overridetensors output=CPU
koboldcpp.exe --model mymodel.gguf --maxrequestsize 67108864
curl -X POST http://localhost:5001/api/extra/json_to_grammar -H 'Content-Type: application/json' -d '{"type":"object","properties":{"name":{"type":"string"},"age":{"type":"integer"}},"required":["name","age"]}'
koboldcpp --embeddingsmodel nomic-embed-text-v1.5.Q4_K_M.gguf
koboldcpp --model gemma-3-12b-it-Q4_K_M.gguf --cli
curl http://localhost:5001/v1/embeddings -H 'Content-Type: application/json' -d '{"input": "The quick brown fox", "model": "nomic-embed-text"}'
koboldcpp.exe --model mymodel.gguf --defaultgenamt 512
koboldcpp.exe --model gemma-3-4b-it-Q4_K_M.gguf --mmproj mmproj-gemma-3-4b-it.gguf
koboldcpp.exe --model mymodel.gguf --savedatafile stories.db --password mysecretkey
koboldcpp.exe --model mymodel.gguf --contextsize 4096 --gpulayers 32 --exportconfig myconfig.kcpps
koboldcpp --model https://example.com/model-part1.gguf https://example.com/model-part2.gguf
koboldcpp.exe --admin --admindir ./configs --adminpassword s3cret --model default.gguf
koboldcpp.exe --model mymodel.gguf --ttsmaxlen 1024 --visionmaxres 1024
koboldcpp.exe --model mymodel.gguf --ttsmodel outettsv03.gguf --ttswavtokenizer wavtokenizer.gguf --ttsgpu --ttsthreads 4
koboldcpp.exe --analyze mymodel.gguf
koboldcpp.exe --model mymodel.gguf --sdmodel sdmodel.gguf --sdvaeauto --sdnotile
koboldcpp.exe --model mymodel.gguf --websearch
koboldcpp --model main_model.gguf --draftmodel draft_model.gguf --draftgpulayers 20 --draftgpusplit 0.6,0.4
koboldcpp --model Qwen2-VL-7B-Instruct-Q4_K_M.gguf --mmproj mmproj-Qwen2-VL-7B.gguf --usecublas
koboldcpp.exe --model mymodel.gguf --multiplayer
curl -X POST http://localhost:5001/api/extra/detokenize -H 'Content-Type: application/json' -d '{"ids": [1, 4103, 338, 263, 1243]}'
koboldcpp.exe --model sd35-medium.safetensors --sdt5xxl t5xxl.safetensors --sdclipl clip_l.safetensors --sdclipg clip_g.safetensors
koboldcpp.exe --model mymodel.gguf --nofastforward
curl http://localhost:5001/api/extra/last_logprobs
curl -s http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Tell me a story.", "banned_strings": ["In the realm of", "suddenly", "little did he know"]}'
koboldcpp.exe --model mymodel.gguf --contextsize 8192 --showgui
koboldcpp.exe --model mymodel.gguf --usecpu
koboldcpp.exe --nomodel
./koboldcpp --model mymodel.gguf --prompt "Summarize the risks of prompt injection" --promptlimit 200
./koboldcpp --model mymodel.gguf --prompt "Once upon a time" --promptlimit 100 --benchmark
koboldcpp.exe --config https://huggingface.co/koboldcpp/kcppt/resolve/main/Llama-3.1-8B.kcppt
koboldcpp.exe --model mymodel.gguf --gpulayers -1
koboldcpp.exe --model mymodel.gguf --chatcompletionsadapter Llama-3.json
koboldcpp_oldcpu.exe --model mymodel.gguf --contextsize 4096
add_sd_prompt: "masterpiece, best quality"
add_sd_negative_prompt: "blurry, low quality, nsfw"
curl -s -X POST http://localhost:5001/api/extra/tokencount -H 'Content-Type: application/json' -d '{"prompt": "Hello world", "special": false}'
koboldcpp --model my-model.gguf --flashattention --quantkv 2
koboldcpp.exe --model mymodel.safetensors --sdlora my_lora.safetensors --sdloramult 0.5
koboldcpp.exe --model https://example.com/models/mistral-7b.gguf
koboldcpp.exe --model mysdxl.safetensors --sdvaeauto
koboldcpp.exe --model mymodel.gguf --sdmodel sd_v15.safetensors --sdthreads 4 --sdquant --sdclamped
koboldcpp.exe --model mymodel.gguf --hordekey YOUR_API_KEY --hordeworkername MyWorker --hordemodelname mistral-7b --hordemaxctx 4096 --hordegenlen 256
curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "max_length": 200, "bypass_eos": true}'
koboldcpp.exe --flashattention mymodel.gguf
curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "banned_tokens": [1234, 5678]}'
curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Hello", "render_special": true}'
koboldcpp.exe --model llama3.gguf --contextsize 131072
koboldcpp.exe --model my_model.gguf --chatcompletionsadapter my_adapter.json
koboldcpp.exe --model mistral-7b.gguf --mmproj mmproj-mistral-7b.gguf
koboldcpp.exe --model mistral-7b.gguf --password mysecretkey
koboldcpp.exe --model mistral-7b.gguf --lora optional-lora.bin --mmproj optional-mmproj.gguf --ignoremissing
koboldcpp.exe --model my7b_q4.gguf --sdconfig my_sd15_model.safetensors --lowvram
koboldcpp.exe --model my7b_q4.gguf --contextsize 24576
koboldcpp.exe --model my7b_q4.gguf --remotetunnel
koboldcpp.exe --model mymodel.gguf --nocertify
koboldcpp.exe --usecublas rowsplit --model <model_path>
koboldcpp.exe --model mymodel.gguf --usevulkan 0 2 3 --tensor_split 1 1 1
koboldcpp.exe --usevulkan 0 --model mymodel.gguf
curl -s http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "temperature": 0.4, "dynatemp_range": 0.1, "max_length": 200}'
curl -s http://localhost:5001/perf
curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "logit_bias": {"1234": 2.0, "5678": -100.0}}'
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 365 -config openssl.cnf -nodes
koboldcpp.exe --model my_model.gguf --ssl cert.pem key.pem
koboldcpp.exe --model mixtral-8x7b.gguf --blasbatchsize -1
koboldcpp.exe --model my_model.gguf --quiet
koboldcpp.exe --model my_model.gguf --multiuser 10
curl -X POST http://localhost:5001/v1/generate \
-H 'Content-Type: application/json' \
-d '{"prompt": "The adventurer enters the dungeon.", "memory": "You are a dungeon master. The setting is a dark fantasy world.", "max_length": 200}'
curl -X POST http://localhost:5001/v1/generate \
-H 'Content-Type: application/json' \
-d '{"prompt": "Once upon a time", "stop_sequence": ["###", "END"], "trim_stop": true, "max_length": 150}'
koboldcpp.exe --model my_model.gguf --preloadstory my_save.json
koboldcpp.exe --model my_model.gguf --contextsize 8192
# Context Shifting is on by default; to opt out:
koboldcpp.exe --model my_model.gguf --contextsize 8192 --noshift
koboldcpp.exe --model my_model.gguf --remotetunnel
koboldcpp.exe --model my_model.gguf --contextsize 65536
curl http://localhost:5001/v1/completions -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "max_tokens": 200}'
koboldcpp.exe --skiplauncher my_model.kcpps --foreground
koboldcpp.exe --model my_model.gguf --multiuser --onready "cloudflared tunnel run my-tunnel"
curl http://localhost:5001/api/extra/true_max_context_length
koboldcpp.exe --config mymodel.kcpps
curl http://localhost:5001/api/extra/perf
koboldcpp.exe --model <model_path> --blasbatchsize 2048
koboldcpp.exe --model <model_path> --usecublas mmq
koboldcpp.exe --model mymodel.gguf --hordeconfig 'MyHordeModel' 512 2048 'my-api-key-here' 'MyWorkerName'
curl http://localhost:5001/api/extra/perf
koboldcpp.exe --model llama2-7b.gguf --contextsize 4096 --ropeconfig 1.0 10000
koboldcpp.exe --model llama2-7b.gguf --contextsize 8192 --ropeconfig 0.5 10000
curl http://localhost:5001/api/extra/perf
koboldcpp.exe --model superhot-13b.gguf --linearrope --contextsize 8192
curl http://localhost:5001/api/extra/perf
koboldcpp.exe --model mymodel.ggml --contextsize 4096 --bantokens [ a ooo
koboldcpp.exe --model mymodel.ggml --usecublas lowvram 2 --contextsize 8192
curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "mirostat": 2, "mirostat_tau": 5.0, "mirostat_eta": 0.1, "sampler_order": [6,0,1,3,4,2,5]}'
koboldcpp.exe --usecublas lowvram --model <path-to-model.ggml>
koboldcpp.exe --usecublas --contextsize 3072 --model <path-to-model.ggml>
koboldcpp --debugmode --hordeconfig <api_key> <worker_name>
curl -X POST http://localhost:5001/api/extra/abort
koboldcpp --model my_model.gguf --lora my_adapter.bin my_base_model.gguf
koboldcpp.exe --model mymodel.ggml --hordeconfig 'MyHordeName' 512
koboldcpp.exe --renamemodel mymodel
koboldcpp.exe --model my_model.bin --debugmode
koboldcpp.exe --model my_model.bin --unbantokens
koboldcpp.exe --noavx2 --noblas --nommap --model <path-to-model>
curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "sampler_seed": 42}'
koboldcpp.exe --useclblast --gpulayers 20 <path-to-model.ggml>
koboldcpp.exe --contextsize 4096 my_model.bin
koboldcpp.exe --model mymodel.bin --usemirostat 2 5.0 0.1
koboldcpp.exe --model rogue_model.bin --forceversion 401
koboldcpp.exe --model mymodel.bin --threads 4 --blasthreads 8
koboldcpp.exe --model mymodel.bin --highpriority
koboldcpp.exe --model mymodel.bin --usemlock
koboldcpp.exe --unbantokens
koboldcpp.exe --model my_model.bin --debugmode
koboldcpp.exe --model my_model.bin --stream --skiplauncher
koboldcpp.exe --unbantokens mymodel.bin
make LLAMA_OPENBLAS=1 LLAMA_CLBLAST=1 && ./koboldcpp mymodel.bin --useclblast
koboldcpp.exe --stream --launch mymodel.bin
curl http://localhost:5001/api/extra/version
koboldcpp.exe --smartcontext <model_path>
koboldcpp.exe --noavx2 <model_path>
koboldcpp.exe --noavx2 --model <path-to-model>
koboldcpp.exe --useclblast 0 0 ggml_model.bin
koboldcpp.exe --noavx2 ggml_model.bin
koboldcpp.exe --nommap <model_path>
koboldcpp.exe --usemmap ggml_model.bin
koboldcpp.exe --threads 16 <model_path>
llamacpp-for-kobold.exe --stream
llamacpp-for-kobold.exe --noblas
llamacpp-for-kobold.exe --help Summary
KoboldCpp is an open-source local-llm-runtime that allows for local inference across text generation, image/video generation, speech processing, and music creation using GGML and GGUF models. It is entirely free and operates as a single binary executable, requiring no installation and running on CPU or GPU across Windows, MacOS, and Linux, with containerization support. It is designed for users interested in local AI operations, positioning itself as an alternative to existing web services by providing numerous compatible API endpoints for tools like OpenAI and Ollama. The project remains actively maintained with easily accessible releases on its official GitHub page.
Run GGUF models easily with a KoboldAI UI. One File. Zero Install.
What KoboldCpp answers
What types of generative tasks can it handle?
text generation, image/video generation, speech processing, and music creation
What external systems can it interface with?
OpenAI, Ollama, A1111Forge, ComfyUi, and WhisperTranscribe
What models can it run inference on?
all GGML and GGUF models
What kind of persistent data management does it support?
reading or exporting JSON savefiles and persistent stories
What different operating environments can it operate in?
Windows, MacOS, Linux, Colab, Docker, Android (via Termux), and Raspberry PI
Does it require specific setup beyond running the binary?
No external dependencies are needed, as it is a self-contained executable
Examples
Command line
No option matches that search.
| option | found in | since | description |
|---|
No option matches that search.
Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.
Release history
- v1.120
KoboldCpp v1.120 adds DirectIO model loading, new model support for Qwen3.8-Flash-Next and Ling-3.0-flash, and custom JS tools in Kobold Lite.
└──▷ GET THIS VERSION$ git clone --branch v1.120 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.120
└──▷ TRY ITLoad a large model with DirectIO to bypass OS page cache and reduce memory pressure on the host.$ ./koboldcpp-linux-x64 --model mymodel.gguf --usedirectio --gpulayers 40
- ›Adds
--usedirectioflag to enable DirectIO model load mode, and allowsmlockandmmapto be combined simultaneously. - ›Adds support for Qwen3.8-Flash-Next and Ling-3.0-flash model architectures.
- ›Adds custom user-configurable JavaScript tools in Kobold Lite, compatible with standard tool calling.
- ›Adds
- v1.119
KoboldCpp v1.119 adds video generation with Minimax H3, I2V, image editing API, and expands LoRA and attachment limits.
└──▷ GET THIS VERSION$ git clone --branch v1.119 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.119
- ›Adds support for the OpenAI Image editing API at
/v1/images/edits, enabling image-to-image editing workflows through the OpenAI-compatible endpoint. - ›Adds video generation and image-to-video (I2V) support via Minimax H3 (requires 4 model files; a
.kcpptquick-setup template is available on HuggingFace). - ›Adds support for DSpark and Dflash speculative decoding backends.
- ›Adds support for Mistral reasoning budget control.
- ›Adds image generation progress previews so users can monitor generation in real time.
+4 moreshow less
- ›Adds support for Muse Glimmer models, including jinja template and tool-calling support; also adds full support for Qwen 3.8.
- ›Increases maximum runtime image LoRAs from 4 to 10.
- ›Increases maximum images and audio attachments per request from the previous limit to 64.
- ›Adds Autoswap support for the OpenAI image endpoint.
- ›Adds support for the OpenAI Image editing API at
- v1.119
KoboldCpp v1.119 adds Minimax H3 video/I2V generation, Muse Glimmer support, DSpark/Dflash speculative decoding, and the OpenAI image edits endpoint.
└──▷ GET THIS VERSION$ git clone --branch v1.119 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.119
- ›Adds support for the OpenAI Image Editing API at
/v1/images/edits, plus Autoswap support for the OpenAI image endpoint. - ›Adds video generation and image-to-video (I2V) support via Minimax H3, using a 4-file model setup (quickstart
.kcppttemplate available on HuggingFace). - ›Adds support for DSpark and Dflash speculative decoding modes.
- ›Adds support for Mistral reasoning budget (Mistral3 arch
[THINK]/[/THINK]thinking format). - ›Increases maximum runtime image LoRAs from 4 to 10.
+4 moreshow less
- ›Increases maximum images and audio attachments supported per request to 64.
- ›Adds image generation progress and preview support during generation.
- ›Adds support for Muse Glimmer, including jinja templates and tool calling.
- ›Adds full support for Qwen 3.8.
- ›Adds support for the OpenAI Image Editing API at
- v1.118.1
KoboldCpp v1.118.1 adds image-gen abort support, multi-language Qwen3TTS,
--jinjathinkflag, and int8 convrot image model loading.└──▷ GET THIS VERSION$ git clone --branch v1.118.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.118.1
└──▷ TRY ITEnable Jinja templating automatically when using a thinking-capable model, without a separate Jinja flag.$ koboldcpp --model mymodel.gguf --jinjathink
- ›New
--jinjathinkflag automatically enables Jinja templating when specified. - ›Image generation can now be aborted mid-generation by closing the connection; disable this behavior per-request with the
keep_image_gen_on_disconnectrequest field. - ›Adds support for loading int8 convrot image models (z-image models are excluded from image reference support).
- ›Adds multiple language support for Qwen3TTS voices, available via the XTTS endpoint.
- ›Adds support for Qwen3TTS aliases for all voices.
+1 moreshow less
- ›RPC behavior updated to match upstream llama.cpp, making llama.cpp RPC server and clients interchangeable with KoboldCpp ones.
└──▷ BREAKING ON UPGRADE- !Row Split has been removed; selecting it will now default to tensor split.
- !Rocwmma has been removed, matching upstream behavior.
- !RPC protocol updated to match upstream llama.cpp behavior — existing RPC setups using prior KoboldCpp RPC wire format will need to upgrade both server and client.
- ›New
- v1.118.1
KoboldCpp v1.118.1 adds image-gen abort support, multi-language Qwen3TTS,
--jinjathinkauto-Jinja, and int8 convrot image model loading.└──▷ GET THIS VERSION$ git clone --branch v1.118.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.118.1
└──▷ TRY ITEnable Jinja templating automatically when you want think-block support without separately passing a Jinja flag.$ ./koboldcpp-linux-x64 --model mymodel.gguf --jinjathink
- ›Adds
--jinjathinkflag that automatically enables Jinja templating when set. - ›Adds
keep_image_gen_on_disconnectrequest field to control whether in-progress image generation is aborted when the client connection closes (abort-on-disconnect is now the default; set this field to retain the old behavior). - ›Adds support for loading int8 convrot image models; excludes z-image from models that support image references.
- ›Adds multiple language support for Qwen3TTS, usable via the XTTS endpoint.
- ›Adds qwen3tts aliases for all voices.
+2 moreshow less
- ›Increases default server thread counts, raising capacity for parallel HTTP requests.
- ›Adds more diagnostic information when running in batched (parallel requests) mode.
└──▷ BREAKING ON UPGRADE- !RPC tensor name size limit is reduced from 128 to 64 characters to match upstream llama.cpp behavior; existing RPC setups using longer tensor names will break, but llama.cpp RPC servers and clients are now interchangeable with KoboldCpp ones.
- !Row Split option is removed; selecting it now silently falls back to tensor split.
- ›Adds
- v1.117.1
KoboldCpp v1.117.1 adds full Ollama API compatibility, inline multimodal image insertion, and a 32k default generation limit.
└──▷ GET THIS VERSION$ git clone --branch v1.117.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.117.1
- ›Adds Ollama-compatible embeddings endpoint, enabling drop-in use with any Ollama-compatible client by pointing it at KoboldCpp's port.
- ›Adds Ollama-compatible streaming and tool-calling support — setting the port to
11434makes KoboldCpp fully compatible with all Ollama-using software out of the box. - ›Multimodal images are now inserted inline in context rather than at the top, improving vision coherence and quality on most models.
- ›Adds ability to save and display Image LoRA information when generating an image with a pre-loaded LoRA.
- ›Merges stable-diffusion.cpp image generation updates.
+2 moreshow less
- ›Adds Group Chat rework in Kobold Lite with multi-character avatar and memory management.
- ›Disables llama.cpp UI mic input by default (now toggled in settings).
└──▷ BREAKING ON UPGRADE- !The
--splitmode rowoption for CUDA is removed in the next release; users must migrate to tensor split or layer split before upgrading beyond v1.117.1.
- v1.116.1
KoboldCpp v1.116.1 adds Krea 2 Turbo, Ideogram 4, Boogu Edit image models, MCP server support, and new CLI flags.
└──▷ GET THIS VERSION$ git clone --branch v1.116.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.116.1
└──▷ TRY ITAllow--onreadycommands to fire when hot-swapping model configs via the API or Web UI on a terminal-launched instance.$ koboldcpp --config mymodel.kcpps --allow-config-onready
Save TTS output as an MP3 file via the OpenAI-compatible TTS API endpoint.$ curl http://localhost:5001/v1/audio/speech -H 'Content-Type: application/json' -d '{"model": "tts", "input": "Hello world", "response_format": "mp3"}' --output speech.mp3
Run KoboldCpp on macOS without Metal when GPU acceleration causes issues, falling back to Accelerate only.$ koboldcpp-mac-arm64 --config mymodel.kcpps --failsafe
- ›Adds
--allow-config-onreadyCLI flag, which re-enables--onreadycommands from config files when swapping.kcppsconfigs via API or Web UI; must be triggered directly from the terminal and cannot be saved. - ›Adds
--failsafeCLI flag for macOS builds to use Accelerate only, bypassing Metal. - ›Adds
response_format: mp3support to the TTS API endpoint for saving TTS outputs as MP3, following the OpenAI API spec. - ›Adds MCP server support to the built-in llama.cpp Web UI.
- ›Adds Krea 2 Turbo image generation model support (recommended: 8 steps at 1.0 guidance CFG); template available as
Krea2Turbo.kcppt.
+6 moreshow less
- ›Adds Ideogram 4 image generation model support with JSON-format prompting; template available as
Ideogram4.kcppt. - ›Adds Boogu Edit image editing model support; template available as
BooguEdit.kcppt. - ›Adds experimental reference audio upload support for LTX2.3 Audio-To-Video generation.
- ›Adds Jinja toggle to the Quick Tab in the Web UI.
- ›Increases image generation prompt length limit to 3000 characters.
- ›Switches to llama.cpp Jinja tool call response parser as the default, improving out-of-box support for new tool calling models.
- ›Adds
- v1.115.2
KoboldCpp v1.115.2 adds Anthropic
/v1/messagesAPI,--sdvramlimitfor image/video VRAM capping, and MTP/Gemma4 model support.└──▷ GET THIS VERSION$ git clone --branch v1.115.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.115.2
└──▷ TRY ITCap GPU VRAM used by image/video generation so large models load on low-VRAM systems by splitting the compute graph.$ koboldcpp --model mymodel.gguf --sdmodel sdxl.gguf --sdvramlimit 6
Enable MTP speculative drafting with a Gemma4 assistant drafter to boost token throughput and verify hitrate.$ koboldcpp --model gemma-4-26B-A4B-it-UD-Q4_K_M.gguf --draftmodel gemma-4-26b-A4B-it-assistant-Q4_0.gguf --debugmode
- ›Adds full support for the Anthropic
/v1/messagesAPI, including multimodal and tool calling. - ›New
--sdvramlimitflag limits VRAM usage for image and video generation by splitting the compute graph, enabling any image gen model to load on constrained hardware. - ›New
--usemtpflag (and GUI toggle) enables Multi-Token Prediction drafting when built into the model; alternatively, pass a MTP drafter via--draftmodel. - ›New
--reasoningeffortflag (and GUI toggle) sets the default reasoning effort, using--gendefaultsunder the hood to apply API defaults. - ›Use
--debugmodeto inspect MTP drafting hitrate during inference.
+6 moreshow less
- ›Adds support for Gemma4 UV (12B) models, their vision/audio mmprojs, and Gemma assistant models.
- ›Music generation now falls back to a loaded text LLM when no
--musicllmis specified. - ›Video generation in SDUI overhauled: supports selecting a specific end frame in Img2Img, specifying both start and end frames via two reference images in txt2img, up to 32 FPS with extended limits enabled, and a lower default VAE tiling threshold of 640.
- ›Adds new chat templates for LFM2.5 and Cohere2Moe (hotfix 1.115.2).
- ›Launcher context size default increased to 16k; max prompt length for image generation increased.
- ›Accepts additional SSL file extensions for HTTPS configuration.
- ›Adds full support for the Anthropic
- v1.114.1
KoboldCpp v1.114.1 adds parallel text generation, distributed RPC GPU sharing, LTX2.3 video gen, and new image models.
└──▷ GET THIS VERSION$ git clone --branch v1.114.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.114.1
└──▷ TRY ITHost a KoboldCpp instance that handles up to 4 simultaneous text generation requests — useful for multi-user or Horde deployments.$ koboldcpp --model model.gguf --parallelrequests 4
Share your local GPU over the network for distributed inference across multiple machines.$ koboldcpp --rpcmode host --rpcport 5551
Connect to a remote shared GPU for distributed inference, specifying the RPC host target.$ koboldcpp --model model.gguf --rpcmode connect --rpctargets 192.168.1.50:5551
- ›Adds
--parallelrequests Xflag to enable experimental continuous batching, allowing X simultaneous text generation requests instead of queuing — useful for multi-user hosting or Horde deployments. - ›Adds
--rpcmode(connectorhost) and--rpctargetsflags plus--rpcport(default5551) for RPC backend support, enabling distributed inference across multiple GPUs over the network. - ›Adds
--jinjathink [default/true/false]flag (and GUI dropdown) to toggle model thinking mode, which internally sets thethinking_enabledjinja kwarg. - ›Adds
chat_template_kwargsfield to the API for passing jinja kwargs objects directly via API calls. - ›Adds
--sdtiledvae 1flag (hotfix) to enable VAE tiling for video generation.
+9 moreshow less
- ›Adds
--noswaflag to disable Sliding Window Attention, which is now on by default for all models that support it. - ›Adds support for LTX2.3 video generation (txt2vid and img2vid) via the SDUI at
http://localhost:5001/sdui, including AVI download with audio. - ›Adds support for Microsoft Lens, HiDream o1, LongCat, and Ernie image generation models.
- ›Adds support for setting individual devices for CLIP and VAE in image generation.
- ›Adds support for loading custom TAE (Tiny Auto Encoder) image VAEs via the VAE file selector.
- ›Adds multithreaded MP3 generation for AceStep with a new default bitrate of 192kbps.
- ›Adds FPS controls, increased max frame limit, and option to continue video generation from the final frame.
- ›Adds Sampler and Scheduler settings for ComfyUI remote endpoints and A1111-compatible endpoints in Kobold Lite.
- ›Adds BotBooru support to the Import Character from Website URL feature in Kobold Lite.
└──▷ BREAKING ON UPGRADE- !The GPU ID list in the GUI launcher is now 0-based index (0,1,2,3) instead of 1-based (1,2,3,4); existing GUI configurations referencing GPU IDs by 1-based index will target the wrong device.
- !SWA (Sliding Window Attention) is now enabled by default on all models that support it (was off by default); use
--noswaor uncheck the SWA checkbox in the GUI launcher to restore previous behavior.
- ›Adds
- v1.113.2
KoboldCpp v1.113.2 adds
--splitmode,--reqtimeout, image LoRA directory selection, and customizable multiuser queue limits.└──▷ GET THIS VERSION$ git clone --branch v1.113.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.113.2
└──▷ TRY ITRun KoboldCpp on multiple GPUs using the new independent split-mode flag with experimental tensor splitting.$ koboldcpp --usecuda --splitmode tensor --model my-model.gguf
Set a custom request timeout for router mode to avoid hanging requests in multi-user deployments.$ koboldcpp --model my-model.gguf --reqtimeout 120
- ›Adds
--splitmode(layer/row/tensor) flag to control GPU split mode independently, including experimental tensor split support (replaces the old combined--usecuda rowsplitsyntax). - ›Adds
--reqtimeoutflag to specify request timeouts for router mode and similar requests. - ›Adds
--musiclowvramflag to allow Ace Step VAE decoding to fall back gracefully when the larger chunk size does not fit in VRAM. - ›Adds runtime image LoRA directory selection, enabling all image-gen LoRAs in a chosen directory to be loaded via the
<lora:filename:weight>prompt syntax. - ›Allows customizing the multiuser queue limit via the GUI.
+4 moreshow less
- ›Supports loading MTP models (speculative decoding pass not yet enabled).
- ›Speeds up Ace Step VAE decoding by increasing chunk size.
- ›Switches wav output from ulaw encoding to pcm16.
- ›Delivers Qwen3TTS inference speedups by switching back to original precision.
└──▷ BREAKING ON UPGRADE- !Split mode is no longer set as an argument to
--usecuda; it must now be specified separately with--splitmode(layer/row/tensor). The old syntax--usecuda rowsplitwill no longer work.
- ›Adds
- v1.112.2
KoboldCpp v1.112.2 adds AceStep XL music models, reasoning effort control, SWA padding, q5_1 KV cache, and base config preloading.
└──▷ GET THIS VERSION$ git clone --branch v1.112.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.112.2
└──▷ TRY ITCap reasoning token budget for a thinking model at inference time to control cost and latency.$ koboldcpp --model my-thinking-model.gguf --gendefaults '{"reasoning_effort":"minimal"}'
Use q5_1 KV cache quantization to reduce VRAM usage while retaining more precision than q4_0.$ koboldcpp --model mymodel.gguf --quantkv q5_1
Preload a shared base config on every model swap so common settings (context size, threads, etc.) are always applied without repeating them in every per-model config.$ koboldcpp --model mymodel.gguf --baseconfig base_settings.json
- ›Adds
reasoning_effortAPI field for thinking models, accepting valueshigh,medium,low,minimal, ornone; also settable via--gendefaults '{"reasoning_effort":"minimal"}'or in KoboldAI Lite under Settings > Tokens > Thinking > Reasoning Effort. - ›Adds
--swapaddingparameter to extend the SWA (Sliding Window Attention) context window by a specified number of tokens while keeping KV memory footprint small. - ›Adds
--quantkvflag replacing the old single-digit values for KV cache quantization; supportsf16,bf16,q8_0,q5_1, andq4_0as named values (e.g.--quantkv q5_1). - ›Adds
--baseconfigflag to pre-load a base config file on every model swap, merged with the target config; overridable viabaseconfigparameter on the/api/admin/reload_configAPI endpoint. - ›Adds
--jinjatemplate/--chat-template-fileflags to replace a model's built-in Jinja template with a custom one.
+6 moreshow less
- ›Adds
--image-min-tokensand--image-max-tokensflags for controlling min/max vision token counts, similar to llama.cpp behavior. - ›Adds support for AceStep XL music generation models (same AceStep LM, Embedder, and VAE as AceStep 1.5).
- ›Enables streaming alongside Jinja tool calling when using
--jinjatools. - ›Gemma4 E4B and E2B models now support audio inputs.
- ›Extends
/api/extra/tokencountto accept OpenAI-style messages as input (not only raw prompts), returning the compiled prompt. - ›Increases the default multiuser connection limit from 7 to 10.
└──▷ BREAKING ON UPGRADE- !The old single-digit
--quantkvvalues are deprecated;--quantkvnow requires a named cache type string (f16,bf16,q8_0,q5_1,q4_0) — configs or scripts using numeric values must be updated.
- ›Adds
- v1.111.2
KoboldCpp v1.111.2 adds Gemma 4 and Qwen3 TTS voice design,
/v1/responsesAPI, BF16 KV,--autoswap, and env-var credentials.└──▷ GET THIS VERSION$ git clone --branch v1.111.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.111.2
└──▷ TRY ITRun Gemma 4 with SWA enabled for lower VRAM usage and correct instruct formatting enforced via Jinja.$ koboldcpp --model gemma-4-26B-A4B-it-UD-Q4_K_S.gguf --mmproj mmproj-gemma4.gguf --useswa --jinja
Disable chain-of-thought thinking output via Jinja kwargs so responses skip the reasoning block.$ koboldcpp --model qwen3-30b.gguf --jinja --chat-template-kwargs '{"enable_thinking":false}'
Launch with admin and user passwords set via environment variables instead of command-line flags to avoid credentials appearing in process listings.$ KCPP_ADMINPASSWORD=s3cr3tadmin KCPP_PASSWORD=s3cr3tuser koboldcpp --model mymodel.gguf
- ›Adds
--useswaflag to optionally enable Sliding Window Attention for Gemma 4, reducing VRAM usage significantly. - ›Adds
--jinjaflag support for Gemma 4 to enforce correct chat completions format and avoid bad outputs from wrong templates. - ›Adds
--jinjatoolsflag to enable Jinja-based tool calling for broader model compatibility; falls back to universal tool calling when not set. - ›Adds
--jinja-kwargs/--chat-template-kwargsflags (matching llama.cpp syntax) to pass Jinja chat template kwargs, e.g.--chat-template-kwargs '{"enable_thinking":false}'. - ›Adds
--quantkv 3option (also selectable in the GUI launcher) to enable BF16 KV cache type.
+16 moreshow less
- ›Adds
--autoswapflag that, in router mode, swaps loaded features (Text/Images/Music) on and off per request type to save VRAM when running multi-feature configs. - ›Adds
--sdmaingpuflag allowing image generation models to be independently placed on any GPU. - ›Adds support for credentials supplied via environment variables
KCPP_ADMINPASSWORDandKCPP_PASSWORDat launch. - ›Adds basic
/v1/responsesand/v1/messagescompatibility API endpoints. - ›Adds
encapsulate_thinkingrequest field (set tofalseto disable) controlling whether detected thinking content is sent viareasoning_contentin chat completions. - ›Adds Qwen3 TTS CustomVoice and VoiceDesign support, enabling narration with voice instructions in square brackets at the start of a TTS prompt (e.g.
[A depressed woman is crying] I want to go home!). - ›Adds config overwriting for admin mode: two config files (base and target) can now be specified on admin API reload and KoboldCpp will merge them before switching.
- ›Adds planner mode in Music Gen that uses the main LLM to generate better lyrics, toggled in the MusicUI advanced settings.
- ›Adds API key support for Music Gen.
- ›Adds ESRGAN passthrough for image gen, enabling upscale-only mode via img2img with denoise 0.0 and 1 step.
- ›Image gen now returns metadata alongside generated images.
- ›Doubles the logical batch size (while physical batch size is unchanged) when using pipeline parallel, improving throughput on multi-GPU setups.
- ›Adds a popular community models section in the help button menu, driven by
.kcppttemplate files. - ›Supports Gemma 4 models including vision, with AutoGuess non-thinking template applied by default.
- ›TTS embedded Music UI now supports both music and TTS generation across two tabs.
- ›Increases the max vision image limit and the GUI launcher max context size slider limit.
└──▷ BREAKING ON UPGRADE- !Detected thinking content is now sent via
reasoning_contentinstead ofcontentin chat completions API responses. Setencapsulate_thinkingtofalsein your request to restore the previous behavior.
- ›Adds
- v1.110
KoboldCpp v1.110 adds OpenAI-compatible router mode, auto-unload timeout, Qwen3TTS 1.7B, and runtime multi-LoRA loading.
└──▷ GET THIS VERSION$ git clone --branch v1.110 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.110
└──▷ TRY ITEnable router mode so clients can hot-swap models via the OpenAI-compatible API without restarting the server.$ koboldcpp --model default.gguf --adminpassword mysecret --routermode
Load LoRAs from a directory so users can apply any of them at runtime using prompt syntax, without restarting.$ koboldcpp --model mymodel.gguf --sdlora ./loras/
Run Qwen3TTS 1.7B with GPU acceleration enabled for faster voice synthesis.$ koboldcpp --model Qwen3-TTS-12Hz-1.7B-Base-q8_0.gguf --ttsgpu
- ›Adds
--routermodeflag to enable OpenAI-compatible Router Mode, allowing full config-reloads and automatic model hotswapping via reverse proxy within existing requests and responses; requires admin mode enabled, streaming supported. - ›Adds
initial_modeloption to model swapping to reference the originally loaded model when using router mode. - ›Adds Auto Unload Timeout feature to unload all models after a specified number of seconds, designed to pair with
--routermodefor automatic reload workflows. - ›Adds
--ttsgputoggle for Qwen3TTS GPU acceleration, with Vulkan speed improvements. - ›Extends
--sdlorato accept directories, enabling all image LoRAs in the directory to be loaded at runtime via<lora:filename:multiplier>syntax in image generation prompts.
+6 moreshow less
- ›Supports the Qwen3TTS 1.7B model for text-to-speech with improved voice quality and voice cloning.
- ›AceStep 1.5 music generation now supports Reference Audio uploads, MP3 output, and defaults to stereo output.
- ›Improved Ollama emulation now buffers responses for endpoints that only support streaming.
- ›MCP now supports notifications and can handle simultaneous STDIO requests and requests with multiple parts.
- ›OpenAI-compatible endpoints now return dynamic IDs and accurate token usage in responses.
- ›Adds Nemotron model support and Qwen3.5 improvements via upstream merge.
- ›Adds
- v1.109.2
KoboldCpp v1.109.2 adds native music generation via Ace Step and Qwen3-TTS voice cloning with new CLI flags.
└──▷ GET THIS VERSION$ git clone --branch v1.109.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.109.2
└──▷ TRY ITGenerate music natively using the Ace Step backend with a 6 GB VRAM budget.$ koboldcpp --musicllm ace-step-lm.gguf --musicdiffusion ace-step-diffusion.gguf --musicembeddings ace-step-embedder.gguf --musicvae ace-step-vae.gguf
- ›Adds music generation via Ace Step with CLI flags
--musicllm,--musicdiffusion,--musicembeddings,--musicvae, and--musiclowvram; runs in as little as 4 GB of VRAM. - ›Adds a music generation UI at
http://localhost:5001/musicuiwhen music model files are loaded. - ›Adds Qwen3-TTS support for high-quality voice cloning; specify a directory of
.mp3or.wavvoice samples with--ttsdirto enable voice selection during TTS narration. - ›Adds support for importing SillyTavern JSONL exports.
- ›Adds ComfyUI auth token support.
+2 moreshow less
- ›
--admindirnow indexes subdirectories up to 1 level deep. - ›SmartCache is now automatically enabled for RNN/hybrid models (e.g., Qwen 3.5) unless fast forwarding is disabled.
- ›Adds music generation via Ace Step with CLI flags
- v1.108.2
KoboldCpp v1.108.2 adds Ollama
/api/showemulation, image gen up to 2048x2048, multiple image LoRA support, and autofit improvements.└──▷ GET THIS VERSION$ git clone --branch v1.108.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.108.2
└──▷ TRY ITQuery model metadata from KoboldCpp using an Ollama-compatible client or script that calls/api/show.$ curl http://localhost:5001/api/show -d '{"name": "my-model"}'
- ›Adds Ollama
/api/showendpoint emulation, extending API compatibility for tools that expect an Ollama-compatible server. - ›Autofit is now triggered when
-1gpulayers (the default) is selected and no tensor splits or tensor overrides are set; setting explicit GPU layers overrides this behavior. - ›
--autofitmode now hides the GUI layers selector to reduce confusion when autofit is active. - ›Autofit toggle is now accessible from the Quick Launch menu.
- ›Allows the Image Gen soft limit to be overridden up to 2048x2048 resolution when the user explicitly chooses to do so.
+3 moreshow less
- ›Adds support for loading multiple image LoRAs.
- ›Improved MCP behavior with multipart content.
- ›Adds a toggle in SDUI to send img2img as a reference image.
- ›Adds Ollama
- v1.107.3
KoboldCpp v1.107.3 adds SDXS image gen, ESRGAN upscaling, Flux Klein, and Step 3.5 Flash/Kimi Linear model support.
└──▷ GET THIS VERSION$ git clone --branch v1.107.3 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.107.3
└──▷ TRY ITStore downloaded models in a specific directory when loading models via URL reference.$ ./koboldcpp --model https://example.com/model.gguf --downloaddir /mnt/models
Enable TAE SD (fast VAE) for Flux2 image generation to speed up decoding without a separate VAE file.$ ./koboldcpp --model <flux2-model.gguf> --sdvaeauto
- ›Adds
--nopipelineparallelflag to disable pipeline parallel, which is now on by default in CLI. - ›Adds
--noflashattentionflag to disable flash attention, which is now on by default in CLI. - ›Adds
--downloaddiroption to specify where model downloads are stored when using URL references. - ›Adds
--sdvaeautoflag to enable TAE SD support for Flux2. - ›Adds Vulkan (Older PC) GPU support in
oldpcbuilds, providing Vulkan acceleration without AVX2 or AVX CPU intrinsics.
+11 moreshow less
- ›Adds support for SDXS, a fast Stable Diffusion image generation model capable of generating images on CPU in under 10 seconds on a Raspberry Pi, or under half a second on GPU.
- ›Adds support for ESRGAN 4x upscaler (RealESRGAN), loadable as an upscaler model to upscale generated images.
- ›Adds Flux Klein image model support (requires separate image model, VAE, and text encoder).
- ›Increases image generation hard total resolution limit from 1 megapixel to 1.6 megapixels.
- ›Adds upstream model support for Step 3.5 Flash and Kimi Linear.
- ›Adds GLM4.7-NoThink adapter template for GLM 4.7 Flash.
- ›Adds experimental TTS chunked streaming mode in Kobold Lite, compatible with all TTS APIs.
- ›Adds customizable sampler presets in Kobold Lite.
- ›Adds
erroras a possible stop reason (e.g. when the backend fails to generate). - ›Adds Vulkan speedup via occam's coopmat1 optimization, benefiting AMD GPUs with matrixcores such as 7000 and 9000 series.
- ›Reworks the newbie help menu with simple starter configs.
└──▷ BREAKING ON UPGRADE- !Pipeline parallel is now enabled by default in CLI; existing setups relying on it being off must explicitly add
--nopipelineparallel. - !Flash attention is now enabled by default in CLI; existing setups relying on it being off must explicitly add
--noflashattention. - !The CLBlast backend has been fully removed; users requiring CLBlast must use an earlier version.
- ›Adds
- v1.106.2
KoboldCpp v1.106.2 adds MCP server/client bridge, a Kobold Lite UI overhaul, and new GPU device override controls.
└──▷ GET THIS VERSION$ git clone --branch v1.106.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.106.2
└──▷ TRY ITOverride which Vulkan GPU(s) KoboldCpp uses at launch, useful when the GUI selects the wrong device on a multi-GPU system.$ ./koboldcpp-linux-x64 --model mymodel.gguf --device Vulkan0,Vulkan1
- ›Adds
--deviceflag (e.g.--device Vulkan0,Vulkan1) to directly override selected GPU devices from the command line. - ›Adds
GGML_VK_VISIBLE_DEVICESenvironment variable support that always overrides any Vulkan device settings configured inside KoboldCpp. - ›Adds MCP (Model Context Protocol) bridge: KoboldCpp can now act as a drop-in replacement for Claude Desktop, connecting to any HTTP or STDIO MCP server using a
mcp.jsonconfig format compatible with Claude Desktop. - ›Supports multiple simultaneous MCP servers, automatically combining their tools and dispatching requests appropriately.
- ›Enables the
continue_assistant_turnAPI field by default in all chat completions (assistant prefill).
+6 moreshow less
- ›Increases logprobs limit from 5 to 10.
- ›Flash Attention is now enabled by default when launching via the GUI launcher.
- ›Increases the maximum length for interrogate image inputs.
- ›New full settings UI overhaul in Kobold Lite (by @Rose22), with a cleaner and more organized settings menu.
- ›Adds 4 new OLED themes to Kobold Lite.
- ›Adds browser-side MCP client implementation to Kobold Lite.
- ›Adds
- v1.105.4
KoboldCpp v1.105.4 adds
--gendefaultsfor API payload overrides, a new Adaptive-P sampler, and expanded image/video model support.└──▷ GET THIS VERSION$ git clone --branch v1.105.4 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.105.4
└──▷ TRY ITForce a specific temperature and top_k on every incoming API request to correct a frontend that sends bad defaults.$ koboldcpp --model mymodel.gguf --gendefaults '{"temperature": 0.7, "top_k": 40}'
Save VRAM when running Wan2.2 video or Qwen Image generation by enabling the TAEHV approximator instead of the full VAE decoder.$ koboldcpp --model mymodel.gguf --sdmodel wan2.2.gguf --sdvaeauto
- ›Adds
--gendefaultsflag, accepting a JSON dictionary to append or overwrite any API fields (e.g. temperature, top_k, step count) on all incoming API payloads — useful for correcting misbehaving frontends; supersedes and absorbs the now-deprecated--sdgendefaults. - ›Adds support for the 'Adaptive-P' sampler, which allows selecting lower-probability tokens; configure via adaptive target and adaptive decay parameters, recommended for use alongside min-P.
- ›Adds support for Ovis Image and Qwen Image Edit model types.
- ›Adds TAEHV support for WAN VAE (compatible with Wan2.2 videos, Qwen Image, and Qwen Image Edit), enabling large memory savings; activate via the 'TAE SD' checkbox or
--sdvaeauto. - ›Adds support for using remote HTTP MCP servers for tool calling in Kobold Lite.
+3 moreshow less
- ›Extends
--autofitto allocate extra space when multiple models are loaded simultaneously (e.g. image generation, embeddings). - ›Allows configuring the number of
--smartcacheslots (added in hotfix 1.105.1) and improves snapshotting logic for RNN models. - ›StableUI SDUI adds support for requesting AVI-formatted video output (must be enabled in settings first).
└──▷ BREAKING ON UPGRADE- !
--sdgendefaultshas been deprecated and merged into--gendefaults; existing configurations using--sdgendefaultsshould be migrated to--gendefaults.
- ›Adds
- v1.104
KoboldCpp v1.104 adds
--smartcachedynamic KV snapshotting,--autofitGPU layer fitting, and pipeline-parallel opt-in via--pipelineparallel.└──▷ GET THIS VERSION$ git clone --branch v1.104 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.104
└──▷ TRY ITSpeed up context swaps on a shared or AI Horde instance by enabling automatic KV state snapshotting.$ koboldcpp --model mymodel.gguf --smartcache --host 0.0.0.0 --port 5001
Let KoboldCpp automatically find the best GPU layer split without manually tuning layer counts.$ koboldcpp --model mymodel.gguf --autofit
- ›Adds
--smartcacheflag: a dynamic KV state snapshot system that automatically saves and reuses KV states, accelerating context-swap scenarios (e.g. AI Horde, shared instances) and supporting RNN/Hybrid models such as Qwen3Next and RWKV; max KV states increased to 6. - ›Adds
--autofitflag: enables upstream llama.cpp automatic GPU layer fitting (-fit), overwriting manual layer configs and tensor overrides to find a better GPU fit automatically. - ›Adds
--pipelineparallelflag to opt into pipeline parallelism on multi-GPU setups (previously the default); trades higher memory usage for faster speed. - ›Adds
remove_limitspayload/--sdgendefaultsoverride to bypass the newcfg_scalecap of 3.0 for Z-Image. - ›Adds support for GLM4.6V and GLM4.6V Flash multimodal models.
+3 moreshow less
- ›Adds support for GLM ASR Nano audio model (works best with short audio clips).
- ›Increases default generation token amount from 768 to 896.
- ›Adds indentation to
.kcppsconfig files for improved readability.
└──▷ BREAKING ON UPGRADE- !Pipeline parallelism is no longer enabled by default on multi-GPU setups; existing users relying on it must add
--pipelineparallelto restore the previous behaviour. - !
--forceversionflag is deprecated and may no longer function as expected. - !cc7.0 is removed as a CUDA build target; Volta (V100) GPUs now fall back to PTX from cc6.1, which may affect performance.
- ›Adds
- v1.103
KoboldCpp v1.103 adds Flux2 and Z-Image Turbo image generation, Mistral 3 model support, and a Linux auxiliary terminal UI.
└──▷ GET THIS VERSION$ git clone --branch v1.103 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.103
└──▷ TRY ITUse the lcpp-specific chat completions endpoint to leverage prefill/Assistant Continue in a frontend that supports partial-turn continuation.$ curl http://localhost:5001/lcpp/v1/chat/completions -H 'Content-Type: application/json' -d '{"model": "koboldcpp", "messages": [{"role": "user", "content": "Tell me a story"}, {"role": "assistant", "content": "Once upon"}]}'
- ›Adds prefill support to chat completions via the
/lcpp/v1/chat/completionsendpoint (distinct from the OpenAI-compatible/v1/chat/completions), enabling 'Assistant Continue' partial-turn continuation for frontends that support it. - ›Adds support for the Flux2 image generation model, loadable in GGUF format with a separate VAE (
flux2vae.safetensors) and a Clip 1 text encoder. - ›Adds support for Z-Image Turbo image generation, a lightweight alternative to Flux2, using
z_image_turbo-Q4_0.ggufwith the Flux1 VAE and a Qwen3-4B text encoder as Clip 1; a.kcppttemplate is available to auto-download all three components. - ›Adds Mistral and Ministral 3 model support, merged from upstream llama.cpp.
- ›Adds a secondary terminal UI on Linux to view console logging, launchable from the Extras tab even when not started from CLI.
- ›Adds prefill support to chat completions via the
- v1.102.3
KoboldCpp v1.102.3 adds llama.cpp UI, jinja2 template modes, Qwen3Next support, and universal tool-calling improvements.
└──▷ GET THIS VERSION$ git clone --branch v1.102.3 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.102.3
└──▷ TRY ITUse a GGUF model's built-in jinja2 chat template for normal messages while keeping KoboldCpp's universal tool-calling module active.$ koboldcpp --model mymodel.gguf --jinja
Inspect what GPU memory values auto-detection retrieves before committing to a layer-offload configuration.$ koboldcpp --testmemory
- ›Adds
--jinjaflag to use jinja2 templates from GGUF in/v1/chat/completionsfor normal messages while retaining the KoboldCpp universal tool-calling module. - ›Adds
--jinja_toolsflag to use jinja2 templates from GGUF for all messages and tool calls in/v1/chat/completions, giving the model and frontend full responsibility for compatibility. - ›Adds
--testmemorydebug flag to inspect values retrieved by automatic GPU detection. - ›Adds sampler support for smoothing curve.
- ›Bundles the llama.cpp UI as an extra interface accessible at
http://localhost:5001/lcpp, supporting document imports (.pdf) alongside the existing KoboldAI Lite UI.
+8 moreshow less
- ›Massively improves universal tool calling, enabling sequential multi-tool use automatically with all tool-calling-capable frontends (OpenWebUI, SillyTavern, etc.) in chat completions mode, including on models that do not natively support tool calling.
- ›Merges Qwen3Next model support (batch size 512 or less required).
- ›Adds Vulkan support for Whisper audio transcription.
- ›Syncs Image Generation to latest stable-diffusion.cpp.
- ›Serves KoboldAI Lite UI gzip-compressed to supporting browsers for faster loading.
- ›Adds case-insensitive filename search when selecting chat completion adapters.
- ›Adds a Scenario Library in Kobold Lite for saving and loading custom scenarios (stories without most settings).
- ›Enables single-turn deletion and editing in Kobold Lite classic theme instruct mode.
└──▷ BREAKING ON UPGRADE- !The
mirostatsampler hadtauandetaparameters swapped due to an old bug now fixed; to reproduce previous behavior, swap your configured values fortauandeta.
- ›Adds
- v1.101.1
KoboldCpp v1.101.1 adds Qwen3-VL vision support, Qwen Image/Image-Edit generation, logprobs streaming, VITS API endpoint, and Kobold Lite branching.
└──▷ GET THIS VERSION$ git clone --branch v1.101.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.101.1
└──▷ TRY ITPass multiple key-value overrides in one launch command to fine-tune model behavior without repeating the flag.$ koboldcpp --model mymodel.gguf --overridekv rope_freq_base=500000,rope_freq_scale=1.0
- ›Adds support for multiple
--overridekvvalues split by commas in a single invocation. - ›Renames
--blasbatchsizeto--batchsize(old name remains functional as an alias). - ›Adds aliases for OpenAI-compatible endpoints without the
/v1/prefix. - ›Adds logprobs streaming for the OpenAI chat completions API (values sent at end of stream).
- ›Adds a VITS API server compatibility endpoint.
+10 moreshow less
- ›Adds an image generation scheduler selection option in SDUI.
- ›Supports Qwen3-VL multimodal vision-language models (load model + mmproj as usual).
- ›Adds Qwen Image and Qwen Image Edit generation support: load the Qwen Image Edit model as the image gen model, the Qwen Image VAE as VAE, Qwen2.5-VL-7B-Instruct as Clip-1, and its mmproj as Clip-2; image editing available via
http://localhost:5001/sduiby uploading a reference image. - ›Adds Horde worker job stats.
- ›Adds branching support in Kobold Lite, allowing multiple story branches (create, delete, and swap between branches) within a single save file.
- ›Adds ccv3 tavern card support in Kobold Lite.
- ›Upgrades bundled ROCm library in the ROCm Linux binary to 7.1, enabling AMD Radeon 9000-series GPU support on Linux without compiling from source.
- ›Adds experimental fractional scaling support in the GUI launcher for Wayland on GNOME.
- ›Adds right-click copy on the SDUI image preview.
- ›Makes GPU layer count preview in the GUI more accurate (removes the previous +2 layer offset).
- ›Adds support for multiple
- v1.100.1
KoboldCpp v1.100.1 adds WAN video generation, new GPU/CPU offload flags, and GLM4.6 & Granite 4 model support.
└──▷ GET THIS VERSION$ git clone --branch v1.100.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.100.1
└──▷ TRY ITGenerate a short WAN video on a system with limited VRAM by offloading both the model weights and VAE to CPU.$ koboldcpp --sdmodel wan2.2-14b.gguf --sdvae wan_2.1_vae.safetensors --sdt5xxl umt5-xxl-q8_0.gguf --sdoffloadcpu --sdvaecpu
- ›Adds
--sdoffloadcpuflag to dynamically load/unload image generation weights to RAM when not in use (e.g. during VAE decoding). - ›Adds
--sdvaecpuflag to perform VAE decoding on CPU using RAM instead of VRAM. - ›Adds
--sdclipcpuflag to perform CLIP/T5 decoding on CPU (new default behavior). - ›Adds
--sdgendefaultsflag to set default image generation parameters. - ›Adds
--lowvramflag (equivalent to-nkvo) to avoid offloading the KV cache, now usable in both CUDA and Vulkan (replaces the formerlowvramCUDA-only option).
+7 moreshow less
- ›Renames
--sdcliplto--sdclip1and--sdclipgto--sdclip2; these flags now apply to any vision encoder (e.g. WAN clip_vision). - ›Adds WAN video generation: generate short videos in KoboldCpp using WAN models, loaded via
--sdvae,--sdmodel, and--sdt5xxl, accessible through the SDUI athttp://localhost:5001/sdui. - ›Updates StableUI to support animations and video output, including Image-To-Video (I2V) via the txt2img panel.
- ›Adds
dry_penalty_last_nparameter to Kobold Lite, decoupling DRY range from repetition penalty range. - ›Adds support for GLM4.6 and Granite 4 models, including a new Granite 4 chat template.
- ›Moves all
.embdresource files into a separate directory and extracts image generation vocabs into their own files. - ›Enables building for CUDA13 in CMake (untested, no binaries provided).
└──▷ BREAKING ON UPGRADE- !
--sdcliplis renamed to--sdclip1and--sdclipgis renamed to--sdclip2; any launch scripts or configs using the old flag names will break. - !The
lowvramCUDA option is moved to a new--lowvramflag; existing setups relying on the old CUDA-specificlowvramoption must switch to the flag.
- ›Adds
- v1.99.4
KoboldCpp v1.99.4 adds llama.cpp flag aliases, per-IP rate limiting, a new audio voices endpoint, and a UI design overhaul.
└──▷ GET THIS VERSION$ git clone --branch v1.99.4 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.99.4
└──▷ TRY ITDrop-in replacement for a llama.cpp launch command when switching to KoboldCpp, reusing familiar flags without rewriting your script.$ koboldcpp -m ./model.gguf -c 8192 -ngl 35 --flash-attn -fa --override-tensor -ot some_tensor=CPU
Limit how aggressively public users can hammer a shared KoboldCpp instance by enabling per-IP rate limiting.$ koboldcpp --model ./model.gguf --ratelimit 10
Retrieve available TTS voices from a running KoboldCpp instance via the new audio voices endpoint.$ curl http://localhost:5001/v1/audio/voices- ›Adds aliases for llama.cpp command-line flags so llama.cpp users can pass familiar arguments directly:
-m,-t,--ctx-size,-c,--gpu-layers,--n-gpu-layers,-ngl,--tensor-split,-ts,--main-gpu,-mg,--batch-size,-b,--threads-batch,--no-context-shift,--mlock,-p,--no-mmproj-offload,--model-draft,-md,--draft-max,--draft-n,--gpu-layers-draft,--n-gpu-layers-draft,-ngld,--flash-attn,-fa,--n-cpu-moe,-ncmoe,--override-kv,--override-tensor,-ot,--no-mmap. - ›Adds new
--ratelimitflag for per-IP rate limiting to help prevent abuse of public instances. - ›Adds
/v1/audio/voicesAPI endpoint for listing available TTS voices. - ›Renames
--promptlimitto--genlimit; the renamed flag now also applies to API requests and is configurable in the UI launcher. - ›Adds a KoboldAI Lite UI design overhaul with a new default color scheme; the previous scheme remains available as 'Nostalgia' in advanced settings, and several new custom color schemes have been added.
+4 moreshow less
- ›Adds a popup in Kobold Lite to enable TTS or image generation when those features are available but currently disabled.
- ›Adds Think/NoThink instruct tags to the best-practices recommendation in Kobold Lite, providing per-instruct-sequence reasoning control instead of relying on
<think>prefill injection. - ›Adds new 'Aletheia' scenario to Kobold Lite.
- ›Smarter automatic 'Enter Sends' default detection based on platform in Kobold Lite; the toggle is now located in advanced settings.
└──▷ BREAKING ON UPGRADE- !The
--promptlimitflag has been renamed to--genlimit; any scripts or configs using--promptlimitmust be updated.
- ›Adds aliases for llama.cpp command-line flags so llama.cpp users can pass familiar arguments directly:
- v1.98.1
KoboldCpp v1.98.1 adds TTS.cpp-powered text-to-speech (Kokoro, Parler, Dia), new SD flags, and
--overridenativecontext.└──▷ GET THIS VERSION$ git clone --branch v1.98.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.98.1
└──▷ TRY ITEnable q8 quantization for image generation with flash attention for improved quality on supported hardware.$ koboldcpp --model my-llm.gguf --sdmodel my-sd-model.gguf --sdquant 2 --sdflashattention
Override a model's trained context length to control automatic RoPE scaling when the model metadata is incorrect.$ koboldcpp --model my-llm.gguf --overridenativecontext 4096
- ›Adds
--sdflashattentionand--sdconvdirectflags to toggle flash attention and conv2d independently for image generation. - ›Extends
--sdquantto accept a parameter[0/1/2]for three quantization levels (adds q8 support alongside existing q4) for image generation models. - ›Adds
--overridenativecontextflag to override a model's expected trained context when computing automatic RoPE scaling. - ›Adds
--embeddingsmaxctxflag to override the default embedding model max context (which now defaults to the lower of current model max context and trained context). - ›Adds
4096as a valid value for--blasbatchsize.
+10 moreshow less
- ›Adds an alias for
--tensorsplit. - ›Integrates TTS.cpp into KoboldCpp, supporting three new Text-To-Speech models — Kokoro (Q4 GGUF, ~2x realtime), Parler (Q5 GGUF, ~0.5x realtime), and Dia (Q5 GGUF, ~0.1x realtime) — loaded via the 'Audio' tab; WavTokenizer is not required.
- ›Kokoro TTS supports 28 named speaker voices including
af_alloy,af_bella,af_heart,am_adam,am_michael,bf_emma,bm_george, and others for English speech. - ›Adds Seed-OSS model support with instruct templates for thinking and non-thinking modes.
- ›Termux
android_install.shscript can now launch existing downloaded models. - ›KoboldAI Lite scenario picker can now load any adventure or chat scenario in Instruct mode.
- ›KoboldAI Lite adds a setting to embed generated TTS audio into the context as part of the AI's turn.
- ›KoboldAI Lite adds Vision and Auditory support indicators for inline multimodal media content.
- ›KoboldAI Lite adds Seed-OSS instruct templates (thinking regex must be set manually by changing the think tag).
- ›KoboldAI Lite overhauls the narration and media adding system, allowing TTS to be manually added with 'Add File'.
- ›Adds
- v1.97.4
KoboldCpp v1.97.4 adds GLM4.5 and GPT-OSS model support, a
--moecpuflag for CPU-bound MoE layers, and a/pingendpoint for Runpod serverless.└──▷ GET THIS VERSION$ git clone --branch v1.97.4 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.97.4
└──▷ TRY ITRun a large MoE model while keeping all mixture-of-experts layers on CPU to avoid GPU VRAM exhaustion.$ koboldcpp --model mixtral-8x7b.gguf --moecpu
Keep only the first 4 MoE layers on CPU and offload the rest to GPU for a balanced split on a mid-range card.$ koboldcpp --model mixtral-8x7b.gguf --moecpu 4 --gpulayers 32
- ›Adds
--moecpu(layercount) flag to keep MoE layers on CPU; omitting the count keeps all MoE layers on CPU, enabling large MoE models on memory-constrained GPU setups. - ›Adds
/pingstub endpoint to enable KoboldCpp as a Runpod serverless worker. - ›Adds support for GLM4.5 family of models.
- ›Adds support for GPT-OSS models, including a GPT-OSS Harmony instruct template in Kobold Lite.
- ›Adds support for Voxtral audio models (Voxtral Small 24B and Voxtral Mini 3B).
+7 moreshow less
- ›Allows multiple tool calls to be chained and triggered by any role.
- ›Adds two additional save slots in Kobold Lite.
- ›Adds a (+/-) modifier field for Adventure mode rolls in Kobold Lite.
- ›Adds a button to insert a textDB separator in Kobold Lite.
- ›Adds clearer per-modality indication of Vision/Audio multimodal support.
- ›Increases max length of terminal prints in debug mode.
- ›Disables context shifting for all mrope models.
- ›Adds
- v1.96.2
KoboldCpp v1.96.2 adds audio input support, OpenAI image-generation endpoint emulation, and raises default context to 8k.
└──▷ GET THIS VERSION$ git clone --branch v1.96.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.96.2
└──▷ TRY ITAsk questions about an audio file using the new Qwen 2.5 Omni 3B multimodal model — load both the base model and the mmproj file at launch.$ koboldcpp --model Qwen2.5-Omni-3B-Q4_K_M.gguf --mmproj mmproj-Qwen2.5-Omni-3B-Q8_0.gguf --usecuda
- ›Renames
--usecublasflag to--usecuda(old name still accepted for backwards compatibility). - ›Emulates the OpenAI
/v1/images/generationsendpoint, enabling image-generation API calls against KoboldCpp. - ›Adds audio input support for multimodal models, enabling
.wav,.mp3, and.flacfiles on all audio endpoints (Whisper transcribe and multimodal audio) via the miniaudio library. - ›Adds support for Qwen 2.5 Omni 3B as the first audio-capable multimodal model (load base model + mmproj, same workflow as vision models).
- ›Raises default context size to 8k (up from 4k); existing
.kcppsconfig files are unaffected.
+11 moreshow less
- ›Adds AutoGuess prompt templates for Kimi K2, Jamba, and Dots models.
- ›Adds ExaOne 4 model support (via hotfix 1.96.1).
- ›Automatically resumes incomplete model downloads when aria2c is used.
- ›Applies nsigma masking to sampling.
- ›Allows flash attention to be used with image generation.
- ›Prints system information to terminal on startup to aid debugging.
- ›Adds microphone audio capture in Kobold Lite UI for embedding audio directly into stories.
- ›Adds lamejs MP3 encoder to Kobold Lite for audio compression and allows uploading audio files embedded into saved stories.
- ›Adds experimental flags in Kobold Lite to control audio compression, autoguess tags, and unsaved file warnings.
- ›Allows connecting to OpenAI endpoints without an API key in Kobold Lite.
- ›Adds a shortcut in Kobold Lite for inserting instructions into memory.
└──▷ BREAKING ON UPGRADE- !Attached image and audio data in Kobold Lite save files is no longer stored inline in the story but as metadata — saves created in v1.96.2 that contain new media will not have that media accessible when re-opened in older versions of the UI.
- ›Renames
- v1.95.1
KoboldCpp v1.95.1 adds Flux Kontext image editing, multi-reference Photomaker, and Gemma3n/ERNIE model support.
└──▷ GET THIS VERSION$ git clone --branch v1.95.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.95.1
└──▷ HOW TO FIND ITAfter loading Flux Kontext, open StableUI in a browser, supply a prompt and reference image, and generate the edited result.📍In StableUI at http://localhost:5001/sdui: upload a reference image, enter your editing prompt (e.g. 'replace the background with a sunset'), then click Generate.- ›Adds support for Flux Kontext, a natural-language image editing model (background replacement, text editing, object insertion) loadable via a
.kcppttemplate; accessible through StableUI athttp://localhost:5001/sduiwith prompt and reference image inputs. - ›Photomaker now accepts up to 4 reference images, matching the multi-image input capability added for Flux Kontext.
- ›Adds AutoGuess template support for Gemma3n (text-only) and ERNIE models.
- ›Further grammar sampling speedups via caching.
- ›Adds support for Flux Kontext, a natural-language image editing model (background replacement, text editing, object insertion) loadable via a
- v1.94.2
KoboldCpp v1.94.2 adds Chroma image generation, PhotoMaker face cloning, and several new CLI flags for GPU and embedding control.
└──▷ GET THIS VERSION$ git clone --branch v1.94.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.94.2
└──▷ TRY ITLimit embedding model context to reduce memory pressure when running large embedding models alongside a main LLM.$ koboldcpp --model main-model.gguf --embeddingsmodel embed-model.gguf --embeddingsmaxctx 512
- ›Adds
--sdphotomakerflag to load PhotoMaker for face cloning alongside any SDXL-based model, available in text2img, img2img, and inpaint modes via the SDUI athttp://localhost:5001/sdui. - ›Adds
--sdclampedsoftflag for soft total resolution clamping (e.g. a value of 640 allows 640x640, 512x768, and 768x512 images), combinable with the existing--sdclampedhard-clamp flag. - ›Adds
--sdtiledvaeflag to specify a resolution threshold beyond which VAE tiling is applied, replacing the previous--sdnotile. - ›Adds
--embeddingsmaxctxflag to cap the max context length for embedding models, reducing memory usage. - ›Adds
--embeddingsgpuflag to offload embedding model layers to GPU.
+8 moreshow less
- ›Adds
--maingpuflag to select which GPU is treated as the main GPU in multi-GPU setups. - ›Adds Chroma image generation support — a new architecture based on Flux Schnell requiring a T5-XXL encoder and Flux VAE loaded alongside the Chroma GGUF model.
- ›ComfyUI emulation now covers the
/upload/imageendpoint, enabling img2img ComfyUI workflows with files stored temporarily in memory. - ›Adds a mini 5 MB PyInstaller launcher generated alongside an unpacked KoboldCpp directory, allowing launch without Python or other dependencies installed.
- ›Kobold Lite gains Word Frequency Search, webcam image import, WebSearch for corpo mode, ComfyUI img2img support, custom OpenAI endpoint for TextDB embedding model, and the ability to load usermods and CSS from file.
- ›Improves GNBF grammar performance by attempting culled grammar search first.
- ›Displays available RAM on startup and shows the version number in the terminal window title.
- ›Adds more performance stats for token speeds and timings.
└──▷ BREAKING ON UPGRADE- !
--sdnotileis replaced by--sdtiledvae; setups using--sdnotilemust switch to the new flag.
- ›Adds
- v1.93.2
KoboldCpp v1.93.2 adds Windows Shell integration for .gguf files, in-memory save/load session states, model unloading via admin API, and a new
--embeddingsmaxctxflag.└──▷ GET THIS VERSION$ git clone --branch v1.93.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.93.2
└──▷ TRY ITCap embeddings context to avoid OOM when running large embedding batches alongside a generation model.$ koboldcpp --model mymodel.gguf --embeddingsmaxctx 2048
Enable single-instance mode so double-clicking a .gguf in Windows Explorer replaces the running session via/api/extra/shutdown.$ koboldcpp --model mymodel.gguf --singleinstance
- ›Adds
--embeddingsmaxctxCLI option to control the maximum context size for the embeddings endpoint. - ›Adds
--singleinstanceflag awareness for Windows Shell integration: only instances started with this flag are replaced when a.gguffile is double-clicked to open in KoboldCpp. - ›Adds
add_sd_step_limitadapter flag to cap the maximum number of steps in image generation. - ›Adds
/api/extra/shutdownAPI endpoint (localhost-only) to power Windows Shell integration, allowing a running instance to be replaced when a new.ggufis launched. - ›Adds Windows Shell integration allowing
.gguffiles to be associated with KoboldCpp; double-clicking a.ggufopens it directly, replacing any existing local instance on the same port. Installable/uninstallable from the 'Extras' tab.
+11 moreshow less
- ›Adds Save and Load States (session snapshots) via the admin API, storing context snapshots entirely in memory across 3 available slots (4 including the current session), enabling seamless swap between chats with no reprocessing.
- ›Adds model unload option to the admin API, freeing memory while keeping the server running so a different model can be loaded via the admin panel in Lite.
- ›Raises the maximum allowed temperature for Function/Tool calling to 1.0.
- ›Adds more Ollama compatibility endpoints.
- ›Adds support for embeddings models in Kobold Lite's TextDB.
- ›Adds 'Smart' Image Autogeneration mode in Kobold Lite, letting the AI decide when to generate images and create image prompts automatically.
- ›Adds support for saving and loading world info files independently in Kobold Lite.
- ›Adds support for importing character cards from character-tavern.com in Kobold Lite.
- ›Adds a toggle to make a usermod permanent in Kobold Lite.
- ›Adds support for welcome messages in corpo mode in Kobold Lite.
- ›Adds a text LoRA scale option (the previously available text LoRA base option is removed; if provided it will be silently ignored).
└──▷ BREAKING ON UPGRADE- !Linux binary
koboldcpp-linux-x64-cuda1210is renamed tokoboldcpp-linux-x64; automated scripts using the old name will break when the old filename is removed. - !Linux binary
koboldcpp-linux-x64-cuda1150is renamed tokoboldcpp-linux-x64-oldpc; automated scripts using the old name will break when the old filename is removed. - !Windows binary
koboldcpp_cu12.exeis renamed tokoboldcpp.exe; automated scripts using the old name will break when the old filename is removed. - !Windows binary
koboldcpp_oldcpu.exeis renamed tokoboldcpp-oldpc.exe; automated scripts using the old name will break when the old filename is removed. - !Windows binary
koboldcpp_nocuda.exeis renamed tokoboldcpp-nocuda.exe; automated scripts using the old name will break when the old filename is removed. - !The text LoRA base option has been removed; any scripts or configs passing it will have the value silently ignored rather than applied.
- ›Adds
- v1.92.1
KoboldCpp v1.92.1 adds SWA KV-cache mode, DDIM image sampler, Llama4 vision, and broad Kobold Lite enhancements.
└──▷ GET THIS VERSION$ git clone --branch v1.92.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.92.1
└──▷ TRY ITRun KoboldCpp with SWA mode to reduce KV cache memory on large context loads, useful when VRAM is a bottleneck.$ koboldcpp.exe --model mymodel.gguf --useswa
Share a Kobold Lite story as a single URL so collaborators can load it instantly without file transfers.📍In Kobold Lite, go to Save/Load › Share › Export Share as Web URL to generate adPaste.org-hosted link.- ›Adds
--useswaflag to enable Sliding Window Attention (SWA) mode, which significantly reduces KV cache memory usage — note: incompatible with ContextShifting and may degrade output with FastForwarding. - ›Disables
--showguiautomatically when--skiplauncheris used. - ›Adds DDIM sampler for image generation.
- ›Merges Vision support for Llama4 models.
- ›Adds integrated
dPaste.org(open-source pastebin) support in Kobold Lite for sharing save files as a single URL viaSave/Load > Share > Export Share as Web URL; self-hosted instances supported by changing the endpoint URL.
+14 moreshow less
- ›Adds support for RisuAI V3 character cards (
.charxarchive format) in Kobold Lite. - ›Adds TTS option via Pollinations API (routing through OpenAI TTS models) in Kobold Lite.
- ›Adds ST-based randomizer macros such as
{{roll:3d6}}in Kobold Lite. - ›SSE streaming is now the default for all cases in Kobold Lite, with an opt-out in Advanced Settings.
- ›Enables threadpools, delivering a speedup for Qwen3MoE inference.
- ›Greatly improved tool calling by enforcing grammar on output field names and performing automatic tool selection as a separate pass.
- ›Adds model size information display in the HF Huggingface Search and download menu.
- ›Adds a simple optional Python requirements install script in
launch.cmdfor launching from unpacked directories. - ›Adds an option for horizontal stacking of multiple images in one row in Kobold Lite.
- ›Adds a new Immortal sampler preset in Kobold Lite.
- ›Adds a debug option to change the connected API at runtime in Kobold Lite.
- ›In polled streaming mode, Kobold Lite can now fetch the last generated text if a request fails halfway.
- ›
clip_skipvalue is now stored inside image metadata; actual random seed number is also displayed. - ›AI Horde default advertised context now matches the main max context by default.
- ›Adds
- v1.91
KoboldCpp v1.91 adds a Hugging Face model browser, embedded aria2c downloader, CFG support via
--enableguidance, and expanded Corpo mode.└──▷ GET THIS VERSION$ git clone --branch v1.91 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.91
└──▷ TRY ITEnable CFG to steer generation away from unwanted content by supplying a negative prompt and scale at the CLI.$ koboldcpp.exe --model mymodel.gguf --enableguidance
- ›Adds
--enableguidanceflag (or Enable Guidance checkbox in UI) to enable Classifier-Free Guidance (CFG); configure a negative prompt and CFG scale via the lite tokens menu — note CFG doubles KV usage and halves generation speed. - ›New Hugging Face Model Search Tool lets users search, browse, and download GGUF models directly from Hugging Face within KoboldCpp before launch.
- ›Embeds aria2c downloader in Windows builds for high-speed model downloads when using provided URLs.
- ›Adds CUDA compute capability 3.5 target, potentially enabling GPU acceleration on K6000, GTX 780, and K80 hardware.
- ›Removes flash attention limits and warnings for Vulkan backends.
+5 moreshow less
- ›Improved ComfyUI emulation now adapts to any workflow containing a KSampler node connected to a text prompt.
- ›Corpo mode in Kobold Lite now supports Text mode and Adventure mode in addition to existing modes, making it available across all 4 modes.
- ›Adds quick save and delete buttons for Corpo mode in Kobold Lite.
- ›Adds Pollinations.ai as an optional online service for TTS and Image Generation in Kobold Lite.
- ›Adds a new built-in scenario: Nemesis, in Kobold Lite.
└──▷ BREAKING ON UPGRADE- !
KoboldCppAutoreplaces the previous default instruct preset in Kobold Lite; existing users relying on the old default instruct format may see different instruct tags applied automatically — switch manually to a preferred format (e.g. Alpaca) if needed. - !Chat 'match any name' is no longer enabled by default in Kobold Lite.
- ›Adds
- v1.90.2
KoboldCpp v1.90.2 adds Android Termux auto-install, HuggingFace model search, Pixtral vision support, and OpenAI Structured Outputs in the chat completions API.
└──▷ GET THIS VERSION$ git clone --branch v1.90.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.90.2
└──▷ TRY ITRun a multimodal model with the vision projector offloaded to CPU while the main LLM stays on GPU, useful when VRAM is tight.$ koboldcpp.exe --model mymodel.gguf --mmproj myproj.gguf --mmprojcpu --gpulayers 999
Force a prompt-processing batch size of 1 to debug coherence issues or replicate minimal-batch behavior on a constrained GPU.$ koboldcpp.exe --model mymodel.gguf --blasbatchsize -1
- ›Adds
--mmprojcpuflag to load and run the multimodal projector on CPU while keeping the main model on GPU. - ›Adds
--blasbatchsize -1mode that exclusively uses a batch size of 1 when processing prompts; also formally permits--blasbatchsize 16to replicate the old non-GEMM batch-of-16 behavior. - ›Adds OpenAI Structured Outputs support in the chat completions API, including accepting a JSON schema sent as a stringified JSON object in the
grammarfield, enabling enforced structured JSON outputs. - ›Adds Android Termux auto-installer: a single command installs, downloads, compiles, and configures KoboldCpp with a Gemma3-1B model on Android via Termux (from F-Droid).
- ›Adds a HuggingFace model search tool allowing users to find, browse, and download models directly from within KoboldCpp.
+7 moreshow less
- ›Adds Qwen3 model support, including automatic
--nobostokentriggering when model metadata explicitly indicates no BOS token. - ›Adds functioning Pixtral vision model support; note Pixtral is token-heavy (~4000 tokens per 1024px image);
--contextsizeor--visionmaxrescan be tuned accordingly. - ›Merged overhaul to Qwen2.5VL projector, supporting both HimariO and ngxson multimodal projector versions with backwards compatibility.
- ›Adds automatic handling of multipart GGUF file downloading, supporting up to 9 parts.
- ›Adds ComfyUI compatibility improvements via rudimentary WebSocket spoof.
- ›Improved auto GPU layer assignment when loading multi-part GGUF models on a single GPU, with tightened memory estimation and quantized KV cache accounting.
- ›Kobold Lite adds a toggle to disable LaTeX rendering while keeping Markdown enabled, and adds ChatGLM-4 and Qwen3 (ChatML think/nothinking) presets.
└──▷ BREAKING ON UPGRADE- !
--onreadyshell commands can no longer be embedded into a.kcpptor.kcppsfile; they remain available only as a CLI parameter. - !ChatML (No Thinking) preset is removed from Kobold Lite; thinking control is now handled globally via Settings > Tokens > CoT.
- ›Adds
- v1.89
KoboldCpp v1.89 adds NoScript chat/image gen, new
--overridekv/--overridetensorsflags, and Vulkan coopmat2 support.└──▷ GET THIS VERSION$ git clone --branch v1.89 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.89
└──▷ TRY ITForce a model's context length metadata to a specific value at load time without editing the model file.$ koboldcpp.exe --model mymodel.gguf --overridekv llama.context_length=uint32:8192
Offload only the output tensor to CPU while keeping everything else on GPU, useful for VRAM-constrained setups.$ koboldcpp.exe --model mymodel.gguf --overridetensors output=CPU
- ›Adds
--overridekvlauncher flag to overwrite a single model metadata property at runtime; input format iskeyname=type:value. - ›Adds
--overridetensorslauncher flag to place tensors matching a pattern onto a specific backend; input format istensornamepattern=buffertype. - ›Enables Vulkan coopmat2 (CM2) support for Nvidia GPUs with Game Ready Driver 576.02 or later, adding flash attention and overall speed improvements; OldCPU Vulkan binaries now exclude coopmat, coopmat2, and DP4A.
- ›Improved NoScript mode at
/noscriptnow supports chat mode and image generation without JavaScript, compatible with browsers as old as Internet Explorer 5 and Netscape Navigator 4. - ›Enables Image Generation LoRAs for use with quantized diffusion models (LoRA itself should remain unquantized).
+7 moreshow less
- ›Displays available GPU memory when estimating layer counts.
- ›Makes YAD the default filepicker, replacing Zenity; Legacy TK filepicker remains available in the extras page.
- ›Increases Kobold Lite save slots to 10 local and 10 remote.
- ›Relocates Tokens Tab and WebSearch Tab into the Settings Panel; regex and token sequence configs now persist in settings rather than per-story.
- ›Adds Retain History toggle in Kobold Lite WebSearch to carry over prior search results into subsequent queries.
- ›Adds an editable Template for the Kobold Lite character creator.
- ›Reworks thinking-tag handling in Kobold Lite, separating display and submit regex behaviors across three modes each.
└──▷ BREAKING ON UPGRADE- !Kobold Lite regex and token sequence configs are now stored in settings rather than in the story, so existing per-story values will not automatically migrate.
- ›Adds
- v1.88
KoboldCpp v1.88 adds image inpainting, a JSON-to-GBNF grammar endpoint,
--maxrequestsizeflag, and Llama 4 model support.└──▷ GET THIS VERSION$ git clone --branch v1.88 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.88
└──▷ TRY ITLimit accepted HTTP payload size to 64 MB to prevent oversized requests from reaching the server.$ koboldcpp.exe --model mymodel.gguf --maxrequestsize 67108864
Convert a JSON schema to GBNF grammar on the fly for structured-output constrained generation.$ curl -X POST http://localhost:5001/api/extra/json_to_grammar -H 'Content-Type: application/json' -d '{"type":"object","properties":{"name":{"type":"string"},"age":{"type":"integer"}},"required":["name","age"]}'
- ›Adds
--maxrequestsizeflag to configure the server's maximum HTTP request payload size before dropping a request (default: 32 MB). - ›Adds new API endpoint
POST /api/extra/json_to_grammarto convert a JSON schema into GBNF grammar. - ›Adds Image Inpainting support to StableUI, including a masking UI for Img2Img editing (similar to A1111) with updated API docs.
- ›Adds a clip-skip slider to StableUI.
- ›Adds Zenity and YAD support for native file picker dialogs on Linux; falls back to the previous TKinter picker via 'Use Classic FilePicker' in the extras tab.
+4 moreshow less
- ›Adds GPU memory estimation via
vulkaninfowhennvidia-smiis unavailable. - ›Merges Llama 4 support from upstream llama.cpp, with Qwen3 also included.
- ›Adds Llama 4 prompt format to Kobold Lite.
- ›Adds warnings in GUI and terminal when FlashAttention is used with the Vulkan backend due to performance concerns.
- ›Adds
- v1.87.4
KoboldCpp v1.87.4 adds embeddings endpoint, voice cloning, Qwen2.5VL, auto tool calling, and a CLI chat mode.
└──▷ GET THIS VERSION$ git clone --branch v1.87.4 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.87.4
└──▷ TRY ITEncode text for storage in a vector database using a dedicated GGUF embedding model.$ koboldcpp --embeddingsmodel nomic-embed-text-v1.5.Q4_K_M.gguf
Run a fully interactive terminal chat session without launching the web UI.$ koboldcpp --model gemma-3-12b-it-Q4_K_M.gguf --cli
Query the embeddings endpoint directly to get a vector representation of a text string.$ curl http://localhost:5001/v1/embeddings -H 'Content-Type: application/json' -d '{"input": "The quick brown fox", "model": "nomic-embed-text"}'
- ›Adds
--embeddingsmodelflag to load GGUF embedding models, exposed via/v1/embeddingsand/api/extra/embeddingsfor text encoding into vector databases. - ›Adds
--cliflag to run KoboldCpp in a fully headless terminal chat mode, with no GUI required. - ›Adds
--quantkvsupport without flash attention — when used without it, only quantized-K is applied (quantized-V is skipped). - ›Adds OuteTTS voice cloning support: Speaker JSON files representing a cloned voice can now be uploaded via the TTS API.
- ›Adds automatic (auto) mode for function/tool calling, allowing the model to decide whether and which tool to invoke; the detection template is customizable via
custom_tools_promptin the chat completions adapter.
+6 moreshow less
- ›Merges Qwen2.5VL vision-language model support, with GGUF weights and mmproj projectors available for 7B and 32B variants.
- ›Adds World Info Groups in Kobold Lite UI: categorize world info entries by group, toggle groups on/off with a single click, and import/export each group as JSON.
- ›Adds a menu in Kobold Lite to upload a cloned speaker JSON for OuteTTS voice cloning.
- ›Adds a toggle in Kobold Lite to allow uploading images as a new turn in a conversation.
- ›Increases maximum resolution of uploaded images used with vision models in Kobold Lite.
- ›Adds localtunnel as a fallback tunneling option in the Colab environment when Cloudflare tunnels are blocked.
- ›Adds
- v1.86.2
KoboldCpp v1.86.2 adds Gemma3 vision support, quantized KV with context shift, and new CLI flags
--defaultgenamtand--nobostoken.└──▷ GET THIS VERSION$ git clone --branch v1.86.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.86.2
└──▷ TRY ITCap default token output for third-party clients that omit a generation length, preventing runaway generation in API-driven workflows.$ koboldcpp.exe --model mymodel.gguf --defaultgenamt 512
Run Gemma3 with vision support by loading the base GGUF and its mmproj projection file together.$ koboldcpp.exe --model gemma-3-4b-it-Q4_K_M.gguf --mmproj mmproj-gemma-3-4b-it.gguf
- ›Adds
--defaultgenamtoption to control the maximum number of tokens generated by default when a third-party client (e.g. via chat completions API) does not specify a value. - ›Adds
--nobostokenoption to prevent BOS tokens from being automatically prepended at generation start. - ›Allows
--quantkv(quantized KV cache) to be used together with context shift — the only remaining requirement is flash attention enabled. - ›Exposes speculative decoding success rate information in the
/api/extra/perf/endpoint. - ›Adds instruct preset
KoboldCppAutomaticin Kobold Lite, which automatically retrieves the instruct template from KoboldCpp.
+6 moreshow less
- ›Integrates Gemma3 support including vision (mmproj) — load a Gemma3 GGUF alongside its mmproj file; inline images work via the Chat Completions API (e.g. in SillyTavern).
- ›Allows admin mode to runtime-swap between GGUF model files in addition to swapping between
.kcppsconfigs, with automatic GPU layer selection. - ›Adds support for downloading Image Generation LoRAs from URL via launch arguments.
- ›Embeds Image Generation parameter metadata into generated images.
- ›Re-enables CUDA compute capability 3.7 (K80) support.
- ›Adds option to save stories to Google Drive when running in Colab.
- ›Adds
- v1.85.1
KoboldCpp v1.85.1 adds networked save slots, Top-N Sigma sampling, and CLI config export flags.
└──▷ GET THIS VERSION$ git clone --branch v1.85.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.85.1
└──▷ TRY ITHost a persistent story server so any connected device can save and load stories, protected by an API key.$ koboldcpp.exe --model mymodel.gguf --savedatafile stories.db --password mysecretkey
Snapshot your current launch configuration to a reusable.kcppsfile for later use or admin-mode model switching.$ koboldcpp.exe --model mymodel.gguf --contextsize 4096 --gpulayers 32 --exportconfig myconfig.kcpps
- ›Adds
--savedatafile <path>flag to enable server-sided networked save slots, allowing persistent story save/load over the network from any browser or device; combine with--passwordto require an API key for save/load access. - ›Adds
--exportconfigand--exporttemplateCLI flags to export any set of launch arguments as a.kcppsor.kcpptconfig file from the command line, usable for model switching in admin mode. - ›Adds Top-N Sigma sampler (combinable with Top-K, Temperature, and XTC only) with UI support in Kobold Lite.
- ›Adds Side Panel Mode for KoboldAI Lite.
- ›Adds improved thinking support in Kobold Lite, including display, forced injection of
<think>tokens in AI replies, and filtering of old thoughts in subsequent generations.
+3 moreshow less
- ›Adds customization options for assistant jailbreak prompt in Kobold Lite.
- ›Reworks load/save UI in Kobold Lite with 2 extra local slots and 8 extra remote save slots.
- ›Adds Granite model support and Vulkan/CUDA enhancements via upstream merge.
- ›Adds
- v1.84.2
KoboldCpp v1.84.2 adds aria2c/wget model downloading and multi-URL multipart model loading via CLI.
└──▷ GET THIS VERSION$ git clone --branch v1.84.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.84.2
└──▷ TRY ITDownload and load a multipart model directly from multiple URLs without manual file management.$ koboldcpp --model https://example.com/model-part1.gguf https://example.com/model-part2.gguf
- ›Supports specifying multiple download URLs for multipart models via
--model [url1] [url2]...(CLI only), enabling KoboldCpp to download multi-file models directly. - ›Adds support for using
aria2candwgetas model download backends when detected on the system. - ›Adds automatic config rollback in admin mode when switching to a faulty config fails, restoring the last known-good state.
- ›Supports specifying multiple download URLs for multipart models via
- v1.83.1
KoboldCpp v1.83.1 adds runtime model/config swapping via
--admin, new vision and TTS limits, and multi-pass web search in Lite.└──▷ GET THIS VERSION$ git clone --branch v1.83.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.83.1
└──▷ TRY ITEnable runtime model swapping so an operator can hot-swap between different model configs from the Lite Admin panel without restarting the server.$ koboldcpp.exe --admin --admindir ./configs --adminpassword s3cret --model default.gguf
Cap TTS output length and vision input resolution to stay within memory budgets when running multimodal and TTS workloads simultaneously.$ koboldcpp.exe --model mymodel.gguf --ttsmaxlen 1024 --visionmaxres 1024
- ›Adds
--adminflag to enable runtime model, settings, and config switching (including remote model swapping) via a new Admin panel in Kobold Lite. - ›Adds
--admindirflag pointing to a directory of.kcppslaunch configs, allowing hot-swap between different models, layers, and backends without restarting manually. - ›Adds
--adminpasswordflag to password-protect the admin panel and remote model-swap functions. - ›Adds
--visionmaxresflag to cap the maximum resolution accepted by vision mmprojs; images exceeding the limit are automatically downscaled before processing. - ›Adds
--ttsmaxlenflag to set a token limit (range 512–4096) on TTS generation; approximately 75 tokens per second of audio.
+7 moreshow less
- ›Adds new CLBlast backend options for avx2, avx, and noavx (Regular, OldCPU, OlderCPU) to provide GPU-accelerated alternatives across a wider range of CPU generations.
- ›Kobold Lite now supports individual start and end instruct tags independently, toggled via Settings > Toggle End Tags.
- ›Kobold Lite adds a deepseek instruct template and reasoning/thinking template tag support, configurable under Context > Tokens > Thinking.
- ›Kobold Lite adds multi-pass web search with a configurable query-generation template.
- ›CLIP vision embeddings are now reused across multiple requests when images have not changed, reducing redundant reprocessing.
- ›TTS audio output can now be downloaded as a file from the Lite test interface instead of only playing back in-browser.
- ›Adds cloudflared tunnel download support for aarch64, and allows SSL combined with remote tunnels.
└──▷ BREAKING ON UPGRADE- !Chat completions adapter now defaults to AutoGuess instead of Alpaca; existing setups relying on the implicit Alpaca default must explicitly set the adapter to 'Alpaca'.
- ›Adds
- v1.82.4
KoboldCpp v1.82.4 adds OuteTTS text-to-speech with OpenAI Speech/XTTS API compatibility, a GGUF file analyzer, and multilingual Whisper support.
└──▷ GET THIS VERSION$ git clone --branch v1.82.4 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.82.4
└──▷ TRY ITRun KoboldCpp with OuteTTS enabled on GPU to serve OpenAI Speech and XTTS API endpoints for TTS frontends.$ koboldcpp.exe --model mymodel.gguf --ttsmodel outettsv03.gguf --ttswavtokenizer wavtokenizer.gguf --ttsgpu --ttsthreads 4
Inspect an unknown GGUF file to review its metadata and tensor layout before loading it.$ koboldcpp.exe --analyze mymodel.gguf
Disable VAE tiling to eliminate bleeding graphical artifacts on image generation with certain GPUs.$ koboldcpp.exe --model mymodel.gguf --sdmodel sdmodel.gguf --sdvaeauto --sdnotile
- ›Adds OuteTTS text-to-speech via
--ttsmodel(OuteTTS GGUF) and--ttswavtokenizer(WavTokenizer GGUF) flags;--ttsgpuoffloads models to GPU and--ttsthreadssets a custom thread count. - ›Adds
--analyzeCLI flag (also in the GUI Extras tab) to inspect any GGUF file, displaying metadata, tensor names, dimensions, and types. - ›Adds
--sdnotileflag to disable VAE tiling for image generation, eliminating bleeding graphical artifacts on some GPUs. - ›Adds
--usemmapflag to opt in to memory-mapped loading;mmapis no longer enabled by default. - ›OuteTTS integration exposes OpenAI Speech API (
OpenAiSpeechApi) and XTTS API (XttsApi) compatibility endpoints for hooking KoboldCpp TTS into existing TTS frontends.
+6 moreshow less
- ›OuteTTS New Speaker Synthesis lets you generate unique voices by entering a random name; supports v0.2 and v0.3 models (500M and 1B).
- ›Extends TAESD (compressed to fp8, ~3 MB) to SD3 and Flux via
--sdvaeautoor 'AutoFix VAE' in the GUI. - ›Increases max supported images per API request for Multimodal Vision from the previous limit to 8.
- ›Enables multilingual Whisper (Voice Recognition) support with specific language codes, selectable via a 2-character code (e.g.
ja,fr) in Kobold Lite. - ›KoboldCpp now displays all enabled capabilities and API endpoints on launch, listing modules such as
TextToSpeech,VoiceRecognition,MultimodalVisionand APIs such asOpenAiSpeechApi,XttsApi,WhisperTranscribeApi. - ›CLBlast (Older CPU) build no longer requires AVX, extending GPU-assisted inference to very old or low-cost systems.
└──▷ BREAKING ON UPGRADE- !
mmapis no longer enabled by default; existing setups relying on memory-mapped model loading must now explicitly pass--usemmapor enable it in the GUI.
- ›Adds OuteTTS text-to-speech via
- v1.81.1
KoboldCpp v1.81.1 adds local WebSearch augmentation via DuckDuckGo, a heuristic chat-template guesser, and browser-based RAG via TextDB.
└──▷ GET THIS VERSION$ git clone --branch v1.81.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.81.1
└──▷ TRY ITStart KoboldCpp with web-search augmentation enabled so every generation request can be enriched with live DuckDuckGo results.$ koboldcpp.exe --model mymodel.gguf --websearch
Enable browser-based RAG for a long threat-intelligence document without needing an embedding model.📍In Kobold Lite, go to Context › TextDB tab, paste your threat-intel document, then send prompts normally — relevant chunks will be injected into context automatically.- ›Adds
--websearchCLI flag (and GUI toggle) to enable KoboldCpp as a local WebSearch proxy, powered by DuckDuckGo, augmenting model queries with live web results. - ›Adds
/api/extra/websearchendpoint for submitting web-search-augmented queries directly to the running KoboldCpp instance. - ›Adds TextDB Document Lookup in Kobold Lite (Context > TextDB tab), a browser-based RAG layer using lunr/minisearch to chunk, store, and retrieve relevant snippets from a pasted text document at inference time — no embedding model required.
- ›Switches Kobold Lite autosaves and save slots from localStorage to indexedDb, significantly increasing the maximum supported browser save size; existing localStorage data is auto-migrated on first launch.
- ›Expands supported resolutions and aspect ratios for generated and uploaded images, and improves multimodal image handling quality for larger, more detailed images.
└──▷ BREAKING ON UPGRADE- !Windows builds now require explicit target flags (e.g.
make LLAMA_PORTABLE=1 LLAMA_VULKAN=1 LLAMA_CLBLAST=1) where previously a baremakewas sufficient — existing Windows build scripts will break without updating. - !Kobold Lite save data written to indexedDb in v1.81.1 cannot be read by older versions of KoboldAI Lite.
- ›Adds
- v1.80.3
KoboldCpp v1.80.3 adds Qwen2-VL multimodal support, Vulkan coopmat1 acceleration, new CLI flags, and LaTeX rendering in Kobold Lite.
└──▷ GET THIS VERSION$ git clone --branch v1.80.3 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.80.3
└──▷ TRY ITOffload draft model layers to GPU for faster speculative decoding on a multi-GPU system.$ koboldcpp --model main_model.gguf --draftmodel draft_model.gguf --draftgpulayers 20 --draftgpusplit 0.6,0.4
Run KoboldCpp with Qwen2-VL multimodal support enabled using a vision projection model.$ koboldcpp --model Qwen2-VL-7B-Instruct-Q4_K_M.gguf --mmproj mmproj-Qwen2-VL-7B.gguf --usecublas
- ›Adds
--moeexpertsflag to overwrite the number of experts used in MoE models. - ›Adds
--failsafeflag to explicitly disable all CPU intrinsics and GPU usage. - ›Adds
--draftgpulayersflag to set the number of layers offloaded for a speculative decoding draft model. - ›Adds
--draftgpusplitflag to set GPU layer distribution ratio for the draft model across multiple GPUs (defaults to same as main model). - ›Adds
suppress_non_speechfield to the Whisper API, enabling suppression of noise annotation logits (e.g. barking, doorbell, chime, muzak).
+11 moreshow less
- ›Adds
qas a URL query alias forqueryin Kobold Lite (e.g.http://localhost:5001?q=what+is+love). - ›MMQ is now the default for CLI; use the
nommqflag to disable (e.g.--usecublas all nommq). - ›Adds multimodal image support for Qwen2-VL (2B and 7B) via mmproj; works on CUDA and CPU backends.
- ›Vulkan backend gains coopmat1 support, delivering significantly faster inference on modern Nvidia cards.
- ›Restores support for ARM quants (e.g.
Q4_0_4_4) in KoboldCpp. - ›Adds LaTeX rendering in Kobold Lite using standard
\[...\], \(...\), and$$...$$syntax alongside markdown. - ›Adds support for AllTalk v2 API in Kobold Lite (AllTalk v1 remains supported automatically).
- ›Adds support for Mantella XTTS (XTTS fork) in Kobold Lite.
- ›Kobold Lite gains manual audio file upload for transcription via settings.
- ›Handles additional generation parameters in Ollama API emulation.
- ›Default image generation sampler changed to Euler.
└──▷ BREAKING ON UPGRADE- !
trim_stopnow defaults totrue; setups that expected stop sequences to appear in output will no longer receive them without explicitly settingtrim_stoptofalse. - !MMQ is now the default for CLI; existing CLI invocations relying on non-MMQ behavior must add
nommq(e.g.--usecublas all nommq) to preserve prior behavior.
- ›Adds
- v1.79.1
KoboldCpp v1.79.1 adds multiplayer sessions, Ollama/ComfyUI API emulation, speculative decoding, and new tokenizer endpoints.
└──▷ GET THIS VERSION$ git clone --branch v1.79.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.79.1
└──▷ TRY ITHost a shared AI storytelling session so multiple users on your network can join and co-author in real time.$ koboldcpp.exe --model mymodel.gguf --multiplayer
Convert a list of token IDs back to a string — useful for debugging tokenization in prompts or outputs.$ curl -X POST http://localhost:5001/api/extra/detokenize -H 'Content-Type: application/json' -d '{"ids": [1, 4103, 338, 263, 1243]}'
- ›Adds
--multiplayerflag (also available in the GUI launcher Network tab) to enable real-time multiplayer sessions, exposing/api/extra/multiplayer/status,/api/extra/multiplayer/getstory, and/api/extra/multiplayer/setstoryendpoints for live story sync across multiple users and devices. - ›Adds Ollama-compatible endpoints
/api/chatand/api/generatefor basic Ollama API emulation, letting third-party tools that only speak Ollama point to KoboldCpp athttp://localhost:5001(or port11434for stricter tools); streaming is not supported. - ›Adds ComfyUI emulation via a new
/promptendpoint, supportingtxt2imgfor tools that require ComfyUI API but lack A1111 API support. - ›Adds
/api/extra/detokenizeendpoint, which converts an array of token IDs into a detokenized string. - ›Adds
/propsendpoint exposing instruction and chat template data from the loaded model.
+5 moreshow less
- ›Adds speculative decoding (drafting) support via a second lightweight draft model with the same vocabulary, offering inference speedups at low temperatures; not well supported on Vulkan.
- ›Adds a 'Dice Action' toggle in Kobold Lite Adventure mode, allowing the AI to roll a dice to determine action outcomes.
- ›Adds ability to disable sentence trimming in all Kobold Lite modes.
- ›Adds GGUF format text encoder support (clip/t5) for Flux and SD3.5 image models.
- ›Adds chunked encoding support.
- ›Adds
- v1.78
KoboldCpp v1.78 adds Flux and SD 3.5 image generation, new
--nofastforwardflag, and a/.well-known/serviceinfoidentity provider endpoint.└──▷ GET THIS VERSION$ git clone --branch v1.78 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.78
└──▷ TRY ITLoad SD 3.5 with individual component files for T5XXL, CLIP-L, and CLIP-G instead of a bundled model.$ koboldcpp.exe --model sd35-medium.safetensors --sdt5xxl t5xxl.safetensors --sdclipl clip_l.safetensors --sdclipg clip_g.safetensors
Force full prompt reprocessing on every request for reproducible outputs during automated or evaluation workloads.$ koboldcpp.exe --model mymodel.gguf --nofastforward
- ›Adds
--sdt5xxl,--sdclipl, and--sdclipgCLI flags to load individual T5XXL, CLIP-L, and CLIP-G components for Flux and SD 3.5 image generation (supports URL resources). - ›Adds
--nofastforwardflag to force full prompt reprocessing on every request, enabling more repeatable and consistent inference results. - ›Adds
/.well-known/serviceinfocommon identity provider endpoint, aligning with AI-Horde, Aphrodite, and TabbyAPI interoperability standards. - ›Supports Flux and Stable Diffusion 3.5 model architectures for image generation, accepting fp16 or fp8 safetensor models and GGUF models, including all-in-one bundled models.
- ›Adds VAE tiling for more consistent large image handling, enabling stable 1024x1024 generation with SDXL and Flux models.
+4 moreshow less
- ›Adds support for custom CSS styles in Kobold Lite UI.
- ›Adds 'BigSquare' option in Kobold Lite image gen settings to generate larger images.
- ›Adds Clip Skip support for local image generation in Kobold Lite.
- ›Debug mode now prints XTC penalties for inspection during inference.
└──▷ BREAKING ON UPGRADE- !CLBlast GPU offload now requires a duplicate copy of model layers in RAM (piggybacks off the CPU backend), increasing memory usage for existing CLBlast setups.
- ›Adds
- v1.77
KoboldCpp v1.77 adds token probability (logprobs) API endpoints, ComfyUI image-gen backend support, and in-chat image generation from instruct mode.
└──▷ GET THIS VERSION$ git clone --branch v1.77 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.77
└──▷ TRY ITRetrieve per-token log-probabilities after a completion to analyze model confidence on each token.$ curl http://localhost:5001/api/extra/last_logprobs- ›Adds logprobs support over the sync API and a new dedicated
/api/extra/last_logprobsendpoint for retrieving token probabilities after both streaming and non-streaming responses. - ›Response fields
prompt_tokens,completion_tokens, andtotal_tokensnow return accurate counts instead of placeholder values. - ›Adds experimental ComfyUI image generation backend support in KoboldAI Lite — requires ComfyUI launched with
--listen --enable-cors-header '*'; no workflow customization needed. - ›Enables image generation from instruct mode via natural language (e.g. 'Please generate an image of a bag of sand'); on by default when an image model is loaded, regex-driven, and toggleable in settings.
- ›Adds a Token Probability Viewer in KoboldAI Lite (disabled by default, enable in advanced settings) showing a table of alternative token probabilities per response.
+4 moreshow less
- ›Adds a new 'Interactive Storywriter' scenario in KoboldAI Lite — story-writing mode with support for hidden instruction prompts to steer the narrative.
- ›Adds support for Tavern 'V3' (Risu-augmented V2) character cards in KoboldAI Lite; metadata chunks are ignored but base V2 card functionality is fully operational.
- ›Enables CUDA graphs for the
koboldcpp_cu12.exe(CUDA 12) build, improving performance on supported Nvidia GPUs. - ›Clarifies the A1111/Forge/KoboldCpp image generation backend selector in KoboldAI Lite to reflect compatibility with all three backends.
- ›Adds logprobs support over the sync API and a new dedicated
- v1.76
KoboldCpp v1.76 adds Anti-Slop phrase banning via
banned_stringsand a new Roleplay Character Creator scenario in Kobold Lite.└──▷ GET THIS VERSION$ git clone --branch v1.76 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.76
└──▷ TRY ITBlock overused filler phrases from LLM output to reduce 'slop' — useful when running automated generation pipelines where clichéd phrases degrade quality.$ curl -s http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Tell me a story.", "banned_strings": ["In the realm of", "suddenly", "little did he know"]}'
- ›Adds Anti-Slop Sampling (Phrase Banning) via the
banned_stringsfield: up to 48 case-insensitive words or phrases can be blocked by backtracking and regenerating when they appear in output. - ›The
/api/extra/perf/endpoint now returns whether the instance was launched in quiet mode (terminal output suppression). - ›Adds timestamp information to each request start event.
- ›Adds a new Roleplay Character Creator scenario in Kobold Lite: a wizard-driven UI for building roleplay bots with the Aesthetic UI, with support for loading pre-existing Tavern Character Cards.
- ›Adds Anti-Slop Sampling (Phrase Banning) via the
- v1.75.2
KoboldCpp v1.75.2 auto-selects GPU backends by default, adds RWKV v6 support, new
--showguiflag, and OpenAI-compatible TTS in Kobold Lite.└──▷ GET THIS VERSION$ git clone --branch v1.75.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.75.2
└──▷ TRY ITLaunch KoboldCpp with a model while forcing the GUI open so you can review and tweak auto-imported CLI settings before starting.$ koboldcpp.exe --model mymodel.gguf --contextsize 8192 --showgui
Run KoboldCpp entirely on CPU (e.g. on a machine with no GPU or when benchmarking CPU throughput) using the new unified CPU mode flag.$ koboldcpp.exe --model mymodel.gguf --usecpu
- ›GPU backend is now auto-selected by default when no
--use...flag is specified; override with--usecpu,--usevulkan, or--usecublas. Dragging a GGUF model ontokoboldcpp.exenow launches with GPU and gpulayers auto-configured. - ›New
--showguiflag allows the GUI to be displayed even when command-line flags are used, importing those flags into the GUI for interactive modification; also works with.kcppsconfig files. - ›OpenBLAS backend removed and unified with NoBLAS into a single CPU mode; use
--usecputo enable CPU mode (the--noblasflag is now deprecated). - ›Adds support for RWKV v6 models (context shifting not supported).
- ›Adds support for OpenAI-compatible TTS endpoints in Kobold Lite.
+8 moreshow less
- ›Adds display-only regex replacement in Kobold Lite, hiding or replacing displayed text while keeping the original text in AI context.
- ›Adds a first-start welcome screen in Kobold Lite for selecting a starting UI theme.
- ›Adds a preview option for alternate greetings within V2 Tavern character cards in Kobold Lite.
- ›Adds a new Instruct scenario in Kobold Lite to mimic CoT Reflection (Thinking).
- ›Adds a toggle in Kobold Lite for chat name format matching, allowing matching any name or only predefined names.
- ›Adds a warning display when loading legacy GGML models.
- ›Embedded Horde workers now work with password-protected instances.
- ›Adds system role support for the Metharme instruct format in Kobold Lite.
└──▷ BREAKING ON UPGRADE- !The OpenBLAS backend has been removed;
--noblasis deprecated. CPU mode must now be specified with--usecpu. - !When no
--use...backend flag is provided, a GPU backend is now selected automatically if available, replacing the previous default of CPU/NoBLAS.
- ›GPU backend is now auto-selected by default when no
- v1.74
KoboldCpp v1.74 adds XTC sampler, a
--nomodelflag for external API providers, and SSL support for Horde workers.└──▷ GET THIS VERSION$ git clone --branch v1.74 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.74
└──▷ TRY ITLaunch the Lite WebUI without a local model so you can point it at an external provider like Gemini or OpenAI on the same machine.$ koboldcpp.exe --nomodel
- ›Adds
--nomodelflag to launch the Lite WebUI without loading a local model, enabling selection of external API providers such as Horde, Gemini, or OpenAI. - ›Adds
xtc_probabilityandxtc_thresholdsampling parameters for the new XTC (Exclude Top Choices) creative-writing sampler; recommended starting values arextc_threshold=0.15andxtc_probability=0.5. - ›Horde Worker now supports connecting to SSL-secured KoboldCpp instances (use
--nocertifyfor self-signed certificates) and enforces a 5-minute per-request timeout to prevent stalls. - ›Adds automatic image resizing and letterboxing for LLaVA/MiniCPM multimodal inputs to improve handling of non-standard image dimensions.
- ›MacOS now defaults to full GPU offload when
-1is passed togpulayers.
+1 moreshow less
- ›Adds support for the Llama-3.1-Minitron-4B-Width model architecture.
- ›Adds
- v1.73.1
KoboldCpp v1.73.1 adds IPv6 dual-stack support, macOS ARM binaries, and a new
--promptpure CLI mode.└──▷ GET THIS VERSION$ git clone --branch v1.73.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.73.1
└──▷ TRY ITRun a one-shot prompt from the terminal and capture the model's response to stdout — useful for scripting or quick tests without launching the GUI.$ ./koboldcpp --model mymodel.gguf --prompt "Summarize the risks of prompt injection" --promptlimit 200
Benchmark the model with a custom prompt to measure tokens/sec while also seeing the generated response.$ ./koboldcpp --model mymodel.gguf --prompt "Once upon a time" --promptlimit 100 --benchmark
- ›Adds
--promptflag for pure CLI mode: runs a single prompt entirely from the command line, suppressing all other console output and piping the response to stdout. - ›Adds
--promptlimitflag to control output length when using--promptCLI mode. - ›Combines
--promptand--promptlimitwith--benchmarkto enable benchmarking with a custom prompt and capturing the response. - ›
--multiusernow defaults to true; set--multiuser 0to disable multi-user mode. - ›Adds dual-stack IPv6 network support, allowing a single KoboldCpp instance to serve both IPv4 and IPv6 addresses automatically on the same port.
+5 moreshow less
- ›Adds official macOS PyInstaller binary builds (
koboldcpp-mac-arm64) for M1, M2, and M3 Macs, eliminating the need to self-compile. - ›Adds support for Minitron and MiniCPM multimodal models (including image input via mmproj file).
- ›Adds letterboxing mode for images in Kobold Lite.
- ›Pre-filters to the top 5,000 token candidates before sampling, improving sampling speed on models with large vocabularies.
- ›Moved chat completions adapter selection to the Model Files tab in the GUI.
└──▷ BREAKING ON UPGRADE- !
--multiusernow defaults to true; existing setups that relied on multi-user mode being disabled by default must explicitly set--multiuser 0.
- ›Adds
- v1.72
KoboldCpp v1.72 adds Vulkan-accelerated Stable Diffusion image generation and Gemma2 2B support.
└──▷ GET THIS VERSION$ git clone --branch v1.72 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.72
- ›Adds GPU-accelerated Stable Diffusion image generation on Vulkan backends.
- ›GPU layers now defaults to
-1in GUI mode, preserving existing layer counts instead of overwriting them, with predicted layer count shown as an overlay label. - ›Auto GPU layer estimation now accounts for loaded image and Whisper models when calculating VRAM headroom.
- ›Adds Gemma2 2B support via upstream merge.
- ›Kobold Lite now supports SSE streaming over the OpenAI API, enabling use with alternative backends.
- v1.71.1
KoboldCpp v1.71.1 adds shareable
.kcpptlaunch templates, automatic GPU layer guessing via--gpulayers -1, and Vulkaniq4_nlformat support.└──▷ GET THIS VERSION$ git clone --branch v1.71.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.71.1
└──▷ TRY ITLoad a fully pre-configured Llama 3.1-8B setup without manually choosing backend, threads, or GPU layers.$ koboldcpp.exe --config https://huggingface.co/koboldcpp/kcppt/resolve/main/Llama-3.1-8B.kcppt
Let KoboldCpp auto-detect the optimal number of GPU layers instead of hand-tuning the value.$ koboldcpp.exe --model mymodel.gguf --gpulayers -1
- ›Adds
--gpulayers -1to let KoboldCpp automatically estimate how many GPU layers to offload (experimental). - ›Adds KoboldCpp Launch Templates: shareable
.kcpptfiles that bundle model URLs, a preloaded story, a chat-completions adapter, and full backend/thread/GPU-layer configuration; load one via--config <url-or-path>. - ›Adds
iq4_nlquantization format support in the Vulkan backend. - ›Adds TTS narration speed setting in Kobold Lite.
- ›Adds support for selecting the greeting message in Character Cards that contain multiple greetings in Kobold Lite.
+2 moreshow less
- ›Adds Corpo UI theme availability for chat mode in Kobold Lite.
- ›Enables inject-chatnames in Corpo UI to replace the AI's displayed name when toggled on.
- ›Adds
- v1.70.1
KoboldCpp v1.70.1 adds Corpo Mode UI, DRY sampler,
--unpackself-extraction, OpenAI function calling, and raises default context to 4096.└──▷ GET THIS VERSION$ git clone --branch v1.70.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.70.1
└──▷ TRY ITUse a pre-bundled chat completions adapter template by filename instead of a full path.$ koboldcpp.exe --model mymodel.gguf --chatcompletionsadapter Llama-3.json
Run with a 4096-token context window (now the default) explicitly set, targeting an older CPU via the AVX1 binary.$ koboldcpp_oldcpu.exe --model mymodel.gguf --contextsize 4096
- ›Adds
--unpackflag enabling self-extraction of KoboldCpp PyInstaller binaries into an empty directory for easy file access and modification; also usable from the GUI launcher. - ›Adds
--chatcompletionsadapterselection by bundled template filename (e.g.Llama-3.json), allowing pre-bundled chat completion templates to be referenced without a full path. - ›Raises default
--contextsizefrom 2048 to 4096 and increases the default Chat Completions API output length. - ›Adds DRY dynamic N-gram anti-repetition sampler support.
- ›Adds experimental support for OpenAI tools and function calling API.
+5 moreshow less
- ›Ships official Windows binaries with AVX1 CUDA support as
koboldcpp_oldcpu.exefor older CPUs. - ›Introduces Corpo Mode, a new beginner-friendly ChatGPT-style UI theme for instruct mode in Kobold Lite.
- ›Adds support for importing character cards from aicharactercards.com in Kobold Lite.
- ›Adds dedicated System Tag and System Prompt support in Kobold Lite.
- ›Completely reworks the Kobold Lite settings menu into 4 distinct panels.
- ›Adds
- v1.69.1
KoboldCpp v1.69.1 adds premade Chat Completions adapters, SD prompt injection fields, Vulkan tensor-split UI, and multi-image LLaVA separator tokens.
└──▷ GET THIS VERSION$ git clone --branch v1.69.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.69.1
└──▷ USE ITInject a forced positive and negative prompt for every Stable Diffusion generation request via an adapter config.add_sd_prompt: "masterpiece, best quality" add_sd_negative_prompt: "blurry, low quality, nsfw"
- ›Adds
add_sd_promptandadd_sd_negative_promptfields in a loaded adapter to inject forced positive or negative prompts for Stable Diffusion generation. - ›Adds premade Chat Completions adapters selectable in the GUI launcher (via
--chatcompletionsadapter) to apply instruct templates for various models and formats when using third-party OpenAI-compatible frontends. - ›Adds a tensor split input field in the GUI launcher for Vulkan backends.
- ›Adds separator tokens between multiple images in LLaVA multi-image requests.
- ›Kobold Lite can now fall back to an alternative API or endpoint URL on connection failure, including retrying via the OpenAI API.
+2 moreshow less
- ›Merges upstream improvements including enhanced MMQ with int8 tensor core support and Gemma 2 features (including IQ MMVQ fixes).
- ›KoboldCpp Colab notebook switched to precompiled Linux binaries for faster startup.
- ›Adds
- v1.68
KoboldCpp v1.68 adds GradientAI RoPE scaling, Vulkan multi-GPU 'All' option, BOS-skip tokenization, and a plaintext export in Kobold Lite.
└──▷ GET THIS VERSION$ git clone --branch v1.68 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.68
└──▷ TRY ITCount tokens in a prompt without including the BOS token — useful for accurate context-budget accounting in pipelines that prepend BOS themselves.$ curl -s -X POST http://localhost:5001/api/extra/tokencount -H 'Content-Type: application/json' -d '{"prompt": "Hello world", "special": false}'
- ›Adds
special: falseparameter to the/api/extra/tokencounttokenize endpoint to skip BOS tokens when counting. - ›Adds an 'All' GPU option in the Vulkan GUI launcher for easy multi-GPU configuration, mirroring the existing CUDA behavior;
--usevulkannow defaults to the first dedicated GPU rather than the first GPU on the list. - ›Adds GradientAI automatic RoPE calculation for improved RoPE scaling at large context sizes.
- ›Preserves CLBlast support despite its removal upstream.
- ›Allows the SD StableUI to be launched even when no Stable Diffusion model is loaded.
+4 moreshow less
- ›Adds a plaintext export option to Kobold Lite.
- ›Increases Kobold Lite retry history stack to 3.
- ›Running a KCPP horde worker now automatically sets Whisper and SD to quiet mode.
- ›Allows PTT in Kobold Lite to trigger 'Generate More' when tapped, while still functioning as push-to-talk when held.
- ›Adds
- v1.67
KoboldCpp v1.67 adds Whisper.cpp speech-to-text with Push-To-Talk/VAD and quantized KV cache via
--quantkv.└──▷ GET THIS VERSION$ git clone --branch v1.67 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.67
└──▷ TRY ITReduce VRAM usage on a large context by enabling quantized KV cache at q4 precision alongside flash attention.$ koboldcpp --model my-model.gguf --flashattention --quantkv 2
- ›Adds
--quantkv [level]flag to enable Quantized KV Cache, wherelevelis0=f16,1=q8, or2=q4; requires--flashattentionand disables Context Shifting automatically. - ›Adds
/api/extra/transcribeendpoint for speech-to-text transcription, accepting payloads as.wavfiles (max 32 MB) or base64-encoded WAV data. - ›Adds
/v1/audio/transcriptionsas an OpenAI-compatible drop-in transcription endpoint, also accepting.wavor base64-encoded WAV payloads. - ›Integrates Whisper.cpp for local speech-to-text; whisper models can be sourced from the whisper.cpp repo or the mirrored HuggingFace collection at
koboldcpp/whisper. - ›Kobold Lite now supports Push-To-Talk (PTT) and automatic Voice Activity Detection (VAD) / Hands-Free Mode for speech-to-text, with all resampling and WAV conversion running locally in the browser.
+3 moreshow less
- ›Kobold Lite's Logit Bias editor now includes a built-in tokenizer for strings when connected to KoboldCpp.
- ›Kobold Lite now supports importing Tavern Cards in Instruct mode via the 'Show Advanced Load' option.
- ›New MOE (Mixture of Experts) support for Vulkan backend.
- ›Adds
- v1.66
KoboldCpp v1.66 adds SD LoRA/VAE support, URL-based model loading, TAE SD, and rep pen slope.
└──▷ GET THIS VERSION$ git clone --branch v1.66 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.66
└──▷ TRY ITApply a custom LoRA to a Stable Diffusion model at half strength for image generation.$ koboldcpp.exe --model mymodel.safetensors --sdlora my_lora.safetensors --sdloramult 0.5
Bootstrap a session by pointing KoboldCpp directly at a remote GGUF file instead of downloading it manually first.$ koboldcpp.exe --model https://example.com/models/mistral-7b.gguf
Use the built-in TAE SD to work around a broken VAE on an SDXL model without supplying an external VAE file.$ koboldcpp.exe --model mysdxl.safetensors --sdvaeauto
- ›Adds
--sdloraflag to specify a custom Stable Diffusion LoRA file, and--sdloramultto set its multiplier (requires 16-bit model; incompatible with--sdquant). - ›Adds
--sdvae [vae_file.safetensors]flag (and Image Gen tab GUI option) to specify a custom SD VAE file. - ›Adds built-in TAE SD support for SD1.5 and SDXL as a fast VAE replacement — enabled via the 'Fix Bad VAE' checkbox or the
--sdvaeautoflag. - ›Supports passing an http/https URL to a GGUF file via the
--modelparameter or model selector UI — KoboldCpp downloads the file to the current working directory and loads it automatically. - ›Adds experimental Rep Pen Slope support, applying a scaled reduction in repetition penalty for older tokens within the rep pen range (slope defaults to 1 for backward compatibility).
+2 moreshow less
- ›Adds viewport width controls in Kobold Lite settings, including horizontal fullscreen.
- ›Kobold Lite now attempts to function correctly when hosted on a subdirectory URL path (e.g. behind a reverse proxy), falling back to root URL on failure.
- ›Adds
- v1.65
KoboldCpp v1.65 adds a standalone Stable Diffusion UI, CUDA 12 binaries, a new
bypass_eosAPI field, and replaces three deprecated flags with granular replacements.└──▷ GET THIS VERSION$ git clone --branch v1.65 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.65
└──▷ TRY ITRun KoboldCpp with a Stable Diffusion model using the new granular flags, clamping resolution/steps for shared or public use.$ koboldcpp.exe --model mymodel.gguf --sdmodel sd_v15.safetensors --sdthreads 4 --sdquant --sdclamped
Register as an AI Horde worker with explicit named flags instead of the deprecated positional--hordeconfig.$ koboldcpp.exe --model mymodel.gguf --hordekey YOUR_API_KEY --hordeworkername MyWorker --hordemodelname mistral-7b --hordemaxctx 4096 --hordegenlen 256
Skip EOS tokens during generation via the API, useful for forcing the model to continue past natural stop points.$ curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "max_length": 200, "bypass_eos": true}'
- ›Adds
--sdmodel,--sdthreads,--sdquant, and--sdclampedflags to replace the deprecated--sdconfig, enabling per-parameter validation and easier extension of Stable Diffusion options. - ›Adds
--hordemodelname,--hordeworkername,--hordekey,--hordemaxctx, and--hordegenlenflags to replace the deprecated--hordeconfig, giving each AI Horde setting its own named flag. - ›Adds
bypass_eosfield to the API, allowing EOS tokens to be skipped during generation while still permitting them to appear in output. - ›Adds official CUDA 12 binary (
koboldcpp_cuda12.exe/koboldcpp_cu12.exe) for newer NVIDIA GPUs, providing increased inference speeds at the cost of a larger download. - ›Adds a standalone browser-based image generation UI (StableUI port, A1111-compatible) accessible at
http://localhost:5001/sdui/when a Stable Diffusion model is loaded.
+6 moreshow less
- ›Increases interrogate mode token limit by 30% and default chat completions token limit by 250%.
- ›Adds option to insert an Instruct System Prompt in Kobold Lite.
- ›Adds toggle to return special tokens in Kobold Lite.
- ›Adds Chat Names insertion for instruct mode in Kobold Lite.
- ›Adds button in Kobold Lite to launch the StableUI image generation interface.
- ›Adds option in Kobold Lite to bypass (skip) EOS tokens.
└──▷ BREAKING ON UPGRADE- !The
--smartcontext,--hordeconfig, and--sdconfigflags are deprecated and scheduled for removal; existing setups using them should migrate to the new named replacement flags (--hordemodelname,--hordeworkername,--hordekey,--hordemaxctx,--hordegenlen,--sdmodel,--sdthreads,--sdquant,--sdclamped).
- ›Adds
- v1.64.1
KoboldCpp v1.64.1 adds
--flashattention, dynamicbanned_tokens,render_special, and removes--bantokens.└──▷ GET THIS VERSION$ git clone --branch v1.64.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.64.1
└──▷ TRY ITEnable Flash Attention at launch to improve performance on compatible models.$ koboldcpp.exe --flashattention mymodel.gguf
Ban specific tokens dynamically per generation instead of using the removed--bantokensflag.$ curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "banned_tokens": [1234, 5678]}'
Render special tokens in generated output, e.g. to inspect raw model token boundaries.$ curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Hello", "render_special": true}'
- ›Adds
--flashattentionexperimental flag to enable Flash Attention for compatible models. - ›Adds
banned_tokensfield to the generate API, allowing per-generation token banning dynamically (replaces the removed--bantokensflag). - ›Adds
render_specialto the generate API, enabling rendering of special tokens such as<|start_header_id|>or<|eot_id|>. - ›Adds
trim_stopsupport in SSE streaming modes so stop sequences are hidden during streaming when enabled; Chat Completions endpoint automatically appliestrim_stopto instruct tag format for better compatibility with third-party clients like LibreChat. - ›Adds
finish_reasoncommunication in both sync and SSE streamed mode responses when generation stops due to EOS/EOT tokens.
+6 moreshow less
- ›Automatically detects and applies both EOS and EOT tokens, with EOT tokens correctly biased when EOS is banned.
- ›Adds additional debug information output when running with
--debugmode. - ›Adds a benchmark button in the GUI launcher;
--benchmarknow includes version and clearer exit instructions in console output. - ›Supports resizing the GUI launcher with auto-scaling GUI elements, useful for high-DPI screens.
- ›Kobold Lite adds token filter feature, enhanced regex replacement (including for submitted text), custom
{{placeholder}}tag support, inverted world info secondary keys (triggers when key is NOT present), and language customization for XTTS. - ›Improves speed of the repetition penalty sampler.
└──▷ BREAKING ON UPGRADE- !The
--bantokensflag has been removed; token banning must now be submitted dynamically via thebanned_tokensfield in the generate API.
- ›Adds
- v1.63
KoboldCpp v1.63 adds special-token stop sequences, Llama3 RoPE scaling, and Kobold Lite regex replacer and background color settings.
└──▷ GET THIS VERSION$ git clone --branch v1.63 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.63
└──▷ TRY ITRun a Llama3 model with an extended context window — RoPE scaling applies automatically.$ koboldcpp.exe --model llama3.gguf --contextsize 131072
- ›Adds support for special tokens in
stop_sequences: setting a token such as<|eot_id|>as a stop sequence now works as an EOS-like token when it maps to a single token, enabling multiple EOS-like stop tokens. - ›Reworks automatic RoPE scaling to support Llama3 — specifying
--contextsizeis now sufficient to trigger the correct scaling automatically. - ›Adds a Llama3 prompt template to Kobold Lite.
- ›Adds a regex replacer feature to Kobold Lite for transforming output text.
- ›Adds aesthetic background color settings to Kobold Lite.
+2 moreshow less
- ›Adds more save slots and usermod saving to Kobold Lite.
- ›Adds a console warning when the desired port is already in use by another program.
- ›Adds support for special tokens in
- v1.62.2
KoboldCpp v1.62.2 adds Img2Img via
/sdapi/v1/img2img, a--chatcompletionsadapterflag, and an embedded Horde Worker priority system.└──▷ GET THIS VERSION$ git clone --branch v1.62.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.62.2
└──▷ TRY ITLoad a model with a custom instruct adapter so any client using the OpenAI Chat Completions endpoint gets the correct prompt format.$ koboldcpp.exe --model my_model.gguf --chatcompletionsadapter my_adapter.json
- ›Adds
--chatcompletionsadapterCLI flag to specify OpenAI Chat Completions adapter files at load time, enabling any instruct tag format via the Chat Completions API. - ›Emulates the A1111-compatible
/sdapi/v1/img2imgendpoint, enabling image-to-image generation directly from KoboldCpp. - ›Expands
/api/extra/perf/with additional usage statistics. - ›Adds
/docsendpoint as an alias for/api, serving built-in API documentation. - ›Embedded Horde Workers now prioritise the local user, automatically pausing and resuming when a local client is active so local and horde workloads can coexist.
+2 moreshow less
- ›Kobold Lite UI gains Img2Img support — click an existing generated image to use it as the basis for a new generation.
- ›Kobold Lite adds API support for Cohere, Claude Haiku, and Gemini 1.5 as external provider targets.
- ›Adds
- v1.61.2
KoboldCpp v1.61.2 adds multimodal vision via
--mmproj, API key auth via--password, mamba model support, and a new--ignoremissingflag.└──▷ GET THIS VERSION$ git clone --branch v1.61.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.61.2
└──▷ TRY ITEnable vision on a compatible GGUF model by loading an mmproj file — the model can then receive and describe images sent via the emulated GPT-4V API.$ koboldcpp.exe --model mistral-7b.gguf --mmproj mmproj-mistral-7b.gguf
Lock down text generation endpoints with a Bearer token so only authorised clients can trigger inference.$ koboldcpp.exe --model mistral-7b.gguf --password mysecretkey
Start a session where an optional LoRA and mmproj are silently skipped if the files are absent, useful in scripted or automated deployments.$ koboldcpp.exe --model mistral-7b.gguf --lora optional-lora.bin --mmproj optional-mmproj.gguf --ignoremissing
- ›Adds
--mmprojflag to load a multimodal projector file, enabling vision capabilities (LLaVA-style) for any compatible model of matching size and architecture — not limited to LLaVA models. - ›Adds
--passwordflag to require Bearer token authentication on all text generation endpoints; image endpoints remain unsecured. - ›Adds
--ignoremissingflag to silently skip optional missing files passed via flags like--loraor--mmprojinstead of exiting. - ›Adds
clampedoption for--sdconfigto prevent generating overly large resolutions that could cause out-of-memory crashes. - ›Emulates a compatible OpenAI GPT-4V API endpoint, allowing GPT-4-Vision applications (e.g. SillyTavern in Chat Completions mode) to work out of the box; Kobold API and OpenAI Text-Completions API accept an array of base64-encoded
imagesin the submit payload.
+7 moreshow less
- ›Emulates an A1111-compatible
/sdapi/v1/interrogateendpoint for image captioning and interrogation frontends. - ›Supports passing up to 4 images per request (each consuming ~600 tokens of context for LLaVA 1.5), with token fast-forwarding and context-shifting working seamlessly so each image is processed only once.
- ›Adds CPU-only support for mamba models (note: mamba does not support context shifting).
- ›Increases
--benchmarkcontext limit to 16k. - ›Adds support for generating non-square images with correct aspect ratio scaling, including portrait and landscape in Kobold Lite.
- ›Adds aliases for image sampler names in txt2img generation.
- ›Kobold Lite gains ability to upload images for LLaVA usage with 4 selectable 'AI Vision' modes, paste images from clipboard, choose image samplers, and use API keys over the KoboldAI API.
- ›Adds
- v1.60.1
KoboldCpp v1.60.1 adds native local image generation via stable-diffusion.cpp with A1111-compatible txt2img and flexible context sizing.
└──▷ GET THIS VERSION$ git clone --branch v1.60.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.60.1
└──▷ TRY ITRun a 7B text model alongside an SD1.5 image model in hybrid mode for simultaneous text and image generation.$ koboldcpp.exe --model my7b_q4.gguf --sdconfig my_sd15_model.safetensors --lowvram
Set an arbitrary context size (e.g. 24576 tokens) instead of being limited to fixed preset values.$ koboldcpp.exe --model my7b_q4.gguf --contextsize 24576
Expose KoboldCpp to the internet via Cloudflare tunnel without port forwarding on a macOS amd64 machine.$ koboldcpp.exe --model my7b_q4.gguf --remotetunnel
- ›Adds
--sdconfigCLI flag to load a compatible SD1.5 or SDXL.safetensorsfp16 image model, enabling native local image generation via stable-diffusion.cpp with an A1111-compatibletxt2imgendpoint usable from Kobold Lite, SillyTavern, and other compatible frontends. - ›Adds
--remotetunnelflag for Cloudflare tunnel support on macOS (amd64 only; M1 not supported). - ›Enables LCM sampler support and allows loading GGUF-format SD models.
- ›Supports running KoboldCpp in text-gen-only, image-gen-only, or hybrid modes via launcher config, with a 'Compress Weights (quant)' option to reduce image model VRAM usage.
- ›Integrates AllTalk TTS support in Kobold Lite.
+5 moreshow less
- ›Adds 'Auto Jailbreak' option for instruct mode in Kobold Lite to assist with stubborn or censored models.
- ›Adds import and export of story via clipboard in Kobold Lite.
- ›Adds personal notes/comments field for stories in Kobold Lite.
- ›Auto-enables the image generation button in Kobold Lite when an image model is loaded.
- ›Adds new GGUF quantization types pulled from upstream.
- ›Adds
- v1.59.1
KoboldCpp v1.59.1 adds
--nocertifymode for Horde workers, Old CPU Vulkan build target, andIQ3_Squantization support.└──▷ GET THIS VERSION$ git clone --branch v1.59.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.59.1
└──▷ TRY ITRun a Horde worker on a network where SSL certificate validation fails, bypassing the error to stay connected.$ koboldcpp.exe --model mymodel.gguf --nocertify
- ›Adds
--nocertifyflag to disable SSL certificate checking on the embedded Horde worker, bypassing SSL certificate errors. - ›Adds a build target for Old CPU (NoAVX2) Vulkan support, enabling GPU acceleration on hardware without AVX2 instructions.
- ›Adds
IQ3_Squantization format support (merged in the 1.59.1 fix build). - ›Adds Google Gemma model support via upstream merges.
- ›Adds
- v1.58
KoboldCpp v1.58 adds row-split CUDA multi-GPU mode, AI Vision image interrogation in Lite, and Pygmalion.Chat character imports.
└──▷ GET THIS VERSION$ git clone --branch v1.58 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.58
└──▷ TRY ITRun KoboldCpp with CUDA multi-GPU in row-split mode when layer split causes VRAM imbalance across cards.$ koboldcpp.exe --usecublas rowsplit --model <model_path>
- ›Adds
rowsplitoption to--usecublasfor row-split mode with CUDA multi-GPU setups; layer split is now the default. - ›Integrates 'AI Vision' image interrogation in Kobold Lite, using AI Horde or a local A1111 endpoint to let the AI recognize and interpret uploaded or generated images as a multimodal alternative to LLaVA.
- ›Supports importing characters from Pygmalion.Chat in Kobold Lite via the scenarios selector.
- ›Adds an option to run Kobold Lite in the background using a dynamically generated silent audio sound to prevent browser tab hibernation.
- ›Adds an 'Auto' option for idle responses in Kobold Lite.
+2 moreshow less
- ›Allows importing images into the story from local disk in Kobold Lite.
- ›Upgrades CLBlast to the latest version for a modest prompt-processing speedup when using OpenCL.
└──▷ BREAKING ON UPGRADE- !The default CUDA multi-GPU split mode has changed from row split to layer split; users relying on row split must now explicitly add
rowsplitto--usecublas.
- ›Adds
- v1.57.1
KoboldCpp v1.57.1 adds
--benchmarkCSV output, Vulkan multi-GPU via--usevulkan, andsmoothing_factorsampling.└──▷ GET THIS VERSION$ git clone --branch v1.57.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.57.1
└──▷ TRY ITSpread inference across three Vulkan GPUs, with allocation controlled by tensor split ratios.$ koboldcpp.exe --model mymodel.gguf --usevulkan 0 2 3 --tensor_split 1 1 1
- ›Adds
--benchmarkflag to run an automated benchmark with current settings, reporting run parameters, timing, and coherence; supply a filename (e.g.--benchmark result.csv) to append results in CSV format. - ›Adds Vulkan multi-GPU support: specify multiple device IDs with
--usevulkan 0 2 3; allocation is controlled by the existing--tensor_splitflag (CLI only — GUI launcher does not support multiple Vulkan devices). - ›Adds temperature Quad-Sampling via the
smoothing_factorAPI parameter, also configurable in the Kobold Lite dynamic temperature panel. - ›Adds
--debugmodetiming output in llama.cpp style, measuring only specific eval functions (excluding overhead) alongside display of the seed used. - ›Adds 'AI Impersonate' feature for Instruct mode in Kobold Lite.
+6 moreshow less
- ›Adds a toggle in Kobold Lite to inject timestamps, enabling the AI to be aware of time passing.
- ›Adds a toggle in Kobold Lite for a printable view (unlocks vertical scrolling).
- ›Extends the Aesthetic UI in Kobold Lite to Story and Adventure modes.
- ›Adds option in Kobold Lite to request the A1111 backend to save generated images to disk.
- ›Persists API info for A1111 and XTTS in Kobold Lite; supports custom negative prompts for image generation and custom Horde keys in KCPP mode.
- ›Adds a 'narrate dialogue only' option for XTTS in Kobold Lite.
- ›Adds
- v1.56
KoboldCpp v1.56 adds Vulkan GPU backend, XTTS text-to-speech, and
dynatemp_exponentAPI support.└──▷ GET THIS VERSION$ git clone --branch v1.56 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.56
└──▷ TRY ITRun KoboldCpp using the new Vulkan GPU backend on a specific GPU to leverage GPU acceleration without CUDA.$ koboldcpp.exe --usevulkan 0 --model mymodel.gguf
- ›New
--usevulkan <gpu id>flag enables an early Vulkan GPU backend, now included in Windows and Linux prebuilt binaries (note: Mixtral on Vulkan not fully supported). - ›Adds
dynatemp_exponentparameter (previously hard-coded to 1.0), now configurable via API and in Kobold Lite. - ›Adds XTTS API Server support in Kobold Lite for local AI-powered text-to-speech.
- ›Adds Old CPU fallback build targets (NoAVX2 and Failsafe modes) to the Linux prebuilt binary and
koboldcpp.sh. - ›Adds HD image generation options in Kobold Lite.
+3 moreshow less
- ›Adds popup-on-complete browser notification options in Kobold Lite.
- ›Adds option in Kobold Lite to let the AI impersonate the user for a turn in chat.
- ›Merges the new GGML backend rework from upstream, preserving support for earlier non-GGUF models via a fossilized earlier version of the library.
- ›New
- v1.55.1
KoboldCpp v1.55.1 adds Dynamic Temperature sampling with
dynatemp_rangecontrol and exposes latest seed in the perf endpoint.└──▷ GET THIS VERSION$ git clone --branch v1.55.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.55.1
└──▷ TRY ITUse Dynamic Temperature to let the sampler vary between 0.3 and 0.5 per token, balancing creativity and coherence without manual tuning.$ curl -s http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "temperature": 0.4, "dynatemp_range": 0.1, "max_length": 200}'
Retrieve the most recently used seed from the perf endpoint to reproduce a specific generation.$ curl -s http://localhost:5001/perf
- ›Adds
dynatemp_rangeparameter enabling Dynamic Temperature (DynaTemp) sampling, where the actual temperature is automatically adjusted betweentemperature ± dynatemp_rangeat inference time (e.g.,temperature=0.4anddynatemp_range=0.1yields a 0.3–0.5 range). - ›Exposes the most recently used seed in the
/perfendpoint, making it easier to reproduce or audit generation runs. - ›Adds a min/max temperature UI in Lite for configuring DynaTemp directly, with both input styles auto-syncing to each other.
- ›Adds
- v1.54
KoboldCpp v1.54 adds
logit_biassupport for OpenAI and Kobold APIs, custom background images in Lite, and GUI launcher tooltips.└──▷ GET THIS VERSION$ git clone --branch v1.54 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.54
└──▷ TRY ITBias specific token IDs up or down during generation to steer or suppress output tokens — works with both the Kobold and OpenAI-compatible endpoints.$ curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "logit_bias": {"1234": 2.0, "5678": -100.0}}'
- ›Adds
logit_biasparameter to both the OpenAI and Kobold APIs, accepting a dictionary of token ID (int) to logit bias (float) pairs in the same object format as the official OpenAI implementation. - ›Adds support for custom background images in KoboldCpp Lite.
- ›Adds customizable
stepcountandcfgscalesettings for Horde/A1111 image generation in Lite. - ›Adds mouseover tooltips for all labels in the GUI launcher.
- ›Includes a prebuilt no-CUDA Linux binary.
- ›Adds
- v1.53
KoboldCpp v1.53 adds HTTPS/SSL support, presence penalty, and Phi model support with Mixtral speedups.
└──▷ GET THIS VERSION$ git clone --branch v1.53 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.53
└──▷ TRY ITServe KoboldCpp over HTTPS using a self-signed certificate so clients connect via an encrypted channel.$ openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 365 -config openssl.cnf -nodes koboldcpp.exe --model my_model.gguf --ssl cert.pem key.pem
- ›Adds
--ssl [cert.pem] [key.pem]flag to serve KoboldCpp over HTTPS using your own unencrypted PEM certificate and key files (also configurable via the GUI). - ›Adds presence penalty support over the KAI API and in Lite as an alternative repetition penalty mechanism.
- ›When presence penalty is set via the OpenAI API and
rep_penis not explicitly set,rep_pennow defaults to 1.0 instead of 1.1. - ›Adds upstream support for Phi models.
- ›Adds upstream performance speedups for Mixtral.
+1 moreshow less
- ›Increases the default non-blas batch size for GGUF models from 8 to 32, improving throughput on CPU inference.
└──▷ BREAKING ON UPGRADE- !When presence penalty is set over the OpenAI API and
rep_penis not set,rep_pennow defaults to 1.0 instead of 1.1 — any workflow relying on the old implicit 1.1 default will produce different outputs.
- ›Adds
- v1.52.2
KoboldCpp v1.52.2 adds a NoScript WebUI, per-layer KV offloading for CUDA, QWEN/Mixtral support, and richer API responses.
└──▷ GET THIS VERSION$ git clone --branch v1.52.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.52.2
└──▷ TRY ITRun Mixtral with large-batch prompt processing disabled to work around slow throughput.$ koboldcpp.exe --model mixtral-8x7b.gguf --blasbatchsize -1
- ›Adds a new NoScript WebUI at
/noscript(e.g.http://localhost:5001/noscript) — W3C HTML-compliant, works in text-based browsers like Lynx over SSH, requires no JavaScript. - ›The
--usecublas lowvramflag (equivalent to-nkvoin llama.cpp) disables per-layer KV offloading for CUDA when the reduced GPU layer budget is undesirable. - ›Merges partial per-layer KV offloading for CUDA, changing how GPU layer capacity is calculated — fully offloaded models are unaffected.
- ›The
/api/extra/tokencountendpoint now returns an array of token IDs in the response body alongside the token count. - ›Adds a new Horde Worker error-count field to the
/api/extra/perfendpoint for monitoring embedded Horde Worker health.
+5 moreshow less
- ›Merges support for QWEN and Mixtral model architectures from upstream;
--noblasor--blasbatchsize -1can mitigate slow batch prompt processing on Mixtral. - ›Selecting a
.kcppsconfig file in the GUI now loads the model specified inside that file directly. - ›Adds the Mamba Multitool shell script for Linux to set up all dependencies needed to build and run KoboldCpp.
- ›Improves embedded Horde Worker fault tolerance with exponential backoff and automatic recovery from up to 24 hours of Horde downtime.
- ›Adds Linux PyInstaller binaries.
└──▷ BREAKING ON UPGRADE- !Per-layer KV offloading is now applied for CUDA, meaning the number of layers that can be offloaded to GPU may be reduced compared to previous versions. Use
--usecublas lowvramto restore the old behaviour.
- ›Adds a new NoScript WebUI at
- v1.51.1
KoboldCpp v1.51.1 adds
--quietconsole suppression and extends--multiuserwith a concurrency queue limit.└──▷ GET THIS VERSION$ git clone --branch v1.51.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.51.1
└──▷ TRY ITRun KoboldCpp as a silent background service without cluttering the console with prompts or outputs.$ koboldcpp.exe --model my_model.gguf --quiet
Allow up to 10 concurrent requests to queue when running a shared multi-user instance.$ koboldcpp.exe --model my_model.gguf --multiuser 10
- ›Adds
--quietflag to suppress all input and output from appearing in the console. - ›Extends
--multiuserwith an optional integer parameter to set how many concurrent requests may queue (defaults to 5 when unset or set to 1). - ›API URL printouts on startup now include the tunnel URL when
--remotetunnelis in use. - ›Allocates ~80 tokens of reserved KV cache space on top of the specified
--contextsize(e.g.--contextsize 2048allocates 2128 internally) to reduce 'Failed to predict' errors caused by KV cache fragmentation during context shift. - ›Displays available KAI and OAI endpoint URLs in the terminal on startup.
+1 moreshow less
- ›Auto RoPE scaling is skipped when the model already overrides the RoPE freq scale with a value below 1.
- ›Adds
- v1.50.1
KoboldCpp v1.50.1 adds SSE streaming and unofficial Aphrodite sampler params to OpenAI-compatible endpoints, plus custom DALL-E proxy support.
└──▷ GET THIS VERSION$ git clone --branch v1.50.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.50.1
- ›Adds SSE streaming support for the OpenAI-compatible
/v1/completionsendpoint (tested working with SillyTavern). - ›Extends
/v1/completionswith unofficial Aphrodite sampler parameters: Min-P, Top-A, and Mirostat. - ›Adds support for custom DALL-E endpoints to enable use with OpenAI-compatible proxies.
- ›Improves automatic GPU layer selection in the CuBLAS GUI launcher to default to full GPU offload when sufficient VRAM is detected.
- ›Adds SSE streaming support for the OpenAI-compatible
- v1.49
KoboldCpp v1.49 adds Split Memory, trim_stop, and
--preloadstoryAPI features for richer generation control.└──▷ GET THIS VERSION$ git clone --branch v1.49 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.49
└──▷ TRY ITGuarantee a system memory block appears at the start of every generation, even when you cannot predict exact token counts.$ curl -X POST http://localhost:5001/v1/generate \ -H 'Content-Type: application/json' \ -d '{"prompt": "The adventurer enters the dungeon.", "memory": "You are a dungeon master. The setting is a dark fantasy world.", "max_length": 200}'
Strip stop sequences from the model output so downstream code receives clean text without sentinel tokens.$ curl -X POST http://localhost:5001/v1/generate \ -H 'Content-Type: application/json' \ -d '{"prompt": "Once upon a time", "stop_sequence": ["###", "END"], "trim_stop": true, "max_length": 150}'
Pre-seed the server with a saved story so connected frontends like Kobold Lite can resume it immediately on load.$ koboldcpp.exe --model my_model.gguf --preloadstory my_save.json
- ›Adds
memoryfield to the/v1/generateAPI payload: forcefully prepends a string to any submitted prompt, and if the context limit is exceeded, overwrites from the beginning of the mainpromptto make room — guaranteeing full memory insertion without needing exact token counts. - ›Adds
trim_stopboolean field to the generate API payload: whentrue, strips detected stop sequences from the output and truncates everything after them (note: incompatible with SSE streaming). - ›Adds
--preloadstoryCLI flag to specify a JSON story savefile at server launch, hosting it at the/api/extra/preloadstoryendpoint for frontends to consume over the API. - ›Adds
LLAMA_PORTABLE=1makefile flag for building portable binaries targeting Colab or Docker environments. - ›Expands Kobold Lite with World Info inject position support, Split Memory, preloaded stories, and optional image generation via DALL-E 3 (OpenAI API).
+1 moreshow less
- ›Extends Colab prebuilt GPU support to A100 and V100 in addition to T4.
- ›Adds
- v1.48.1
KoboldCpp v1.48.1 adds KV cache context shifting, Min-P sampler, remote tunneling, and GPU auto-configuration.
└──▷ GET THIS VERSION$ git clone --branch v1.48.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.48.1
└──▷ TRY ITRun KoboldCpp with a large model at max context without paying reprocessing costs between turns — and disable shifting only if you hit a bug.$ koboldcpp.exe --model my_model.gguf --contextsize 8192 # Context Shifting is on by default; to opt out: koboldcpp.exe --model my_model.gguf --contextsize 8192 --noshift
Expose a local KoboldCpp instance to the internet through a firewall-bypassing Cloudflare tunnel for remote access or sharing.$ koboldcpp.exe --model my_model.gguf --remotetunnel
- ›Adds
--noshiftflag to disable the new Context Shifting (EvenSmarterContext) feature, which uses KV cache shifting to remove old tokens and add new ones without reprocessing — enabled by default and overrides SmartContext when both are set. - ›Adds
--remotetunnelflag, which downloads Cloudflared and creates a TryCloudFlare tunnel so KoboldCpp is reachable over the internet even behind a firewall. - ›Adds Min-P sampler, now available via the API and configurable in Kobold Lite under the Advanced settings tab.
- ›Introduces a new build target
koboldcpp_clblast_noavx2('CLBlast NoAVX2 (Old CPU)') for Windows users without AVX2 intrinsics, enabling CLBlast GPU acceleration on older CPUs. - ›Changes MMQ/Tensor Core behavior: MMQ is always enabled until batch > 32, CuBLAS only activates for larger batches when the MMQ flag is explicitly disabled, and MMQ dimensions are set to 'FAVOR BIG' — diverging from upstream llama.cpp's approach.
+6 moreshow less
- ›Adds automatic GPU name display and GPU layer suggestion in the GUI using
clinfoandnvidia-smiqueries, based on available VRAM and model file size. - ›Adds Sampler Seeds support in Kobold Lite for deterministic generation.
- ›Includes Content-Length header in HTTP responses.
- ›Now accounts for
freq_base_trainwhen computing automatic RoPE scale. - ›Retains support for GGUFv1 (upstream has removed it).
- ›Improved KoboldCpp Colab notebook now ships prebuilt CUDA binaries, reducing post-launch load time to under one minute (excluding model downloads), with additional default model options and support for custom GGUF model URLs.
- ›Adds
- v1.47.2
KoboldCpp v1.47.2 adds an OpenAI Chat Completions adapter, SSE streaming, browser save slots, and AUTOMATIC1111 image generation.
└──▷ GET THIS VERSION$ git clone --branch v1.47.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.47.2
└──▷ HOW TO FIND ITEnable SSE streaming in Kobold Lite for lower-latency token-by-token output in the browser UI.📍In Kobold Lite, open Settings and toggle on SSE Streaming.- ›Adds a GUI input field for
tensor_splitconfiguration, allowing multi-GPU tensor splitting to be configured without CLI editing. - ›Adds an unofficial OpenAI v1 Chat Completions endpoint adapter that allows customization of instruct tags over the API.
- ›Adds SSE (Server-Sent Events) streaming support to Kobold Lite, toggled on in browser settings (requires a recent browser).
- ›Adds Browser Storage Save Slots in Kobold Lite for temporarily saving and swapping between multiple stories within a browser session.
- ›Adds AUTOMATIC1111 integration in Kobold Lite, enabling local image generation from an A1111 install as an alternative to Horde.
+5 moreshow less
- ›Adds World Info Search Depth setting in Kobold Lite.
- ›Adds a Group Chat Management Panel in Kobold Lite for temporarily toggling participants in a group chat.
- ›Adds auto-recovery pause timeout for the Embedded Horde Worker on repeated errors, instead of immediately halting; the worker still halts if total error count exceeds a high threshold.
- ›Pulls upstream support for ChatML added token merges (requires a correctly converted GGUF model).
- ›Improves server CORS and content-type handling.
- ›Adds a GUI input field for
- v1.46.1
KoboldCpp v1.46.1 adds OpenAI Chat Completions endpoint, 64k context support, parallel horde jobs, and full API docs.
└──▷ GET THIS VERSION$ git clone --branch v1.46.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.46.1
└──▷ TRY ITRun KoboldCpp with a GGUF model at full 64k context to support very long documents or conversations.$ koboldcpp.exe --model my_model.gguf --contextsize 65536
- ›Adds OpenAI Chat Completions-compatible endpoint at
/v1/chat/completions. - ›Adds interactive API documentation accessible at
/api(also hosted at https://lite.koboldai.net/koboldcpp_api). - ›Expands
--contextsizesupport up to 64k tokens (GGUF models only; remains 16k for other formats). - ›Embedded horde worker now executes job pulls and job submits in parallel, yielding approximately 20% faster horde request handling with additional session stats.
- ›
.kcppsconfig files can now be drag-and-dropped or opened via 'Open With' on Windows.
+1 moreshow less
- ›Changes the default model name reported via API from
concedo/koboldcpptokoboldcpp/[model_filename].
└──▷ BREAKING ON UPGRADE- !The
--psutil_set_threadscommand-line argument has been removed. - !The
--streamcommand-line argument has been removed; streaming is now a toggle saved inside Kobold Lite's settings. - !The
--unbantokenscommand-line argument has been removed; EOS unbans must now be set via the generate API using theuse_default_badwordsidsJSON field. - !The
--usemirostatcommand-line argument has been removed; Mirostat values must now be set via the generate API using themirostat,mirostat_tau, andmirostat_etaJSON fields. - !The original tkinter GUI has been removed; only the customtkinter GUI remains.
- !The default model name is changed from
concedo/koboldcpptokoboldcpp/[model_filename], which breaks connections from old KoboldAI-Client users connecting via the Kobold API.
- ›Adds OpenAI Chat Completions-compatible endpoint at
- v1.45.2
KoboldCpp v1.45.2 adds OpenAI-compatible
/v1/completions, grammar state persistence, 32k context, and a new--foregroundflag.└──▷ GET THIS VERSION$ git clone --branch v1.45.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.45.2
└──▷ TRY ITSend an OpenAI-compatible completion request to KoboldCpp for tooling that expects the standard OpenAI API.$ curl http://localhost:5001/v1/completions -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "max_tokens": 200}'
Launch KoboldCpp on Windows without the launcher GUI, jumping straight to a saved config, while keeping the terminal in the foreground during generation.$ koboldcpp.exe --skiplauncher my_model.kcpps --foreground
- ›Adds
grammar_retain_stateparameter to the grammar sampler API, allowing grammar state to persist across multiple requests. - ›Adds
--foregroundflag for Windows users to bring the console terminal to the foreground on each prompt generation, avoiding idle slowdown. - ›Increases maximum supported context via
--contextsizeto 32k for GGUF models (still limited to 16k for older model formats). - ›Adds OpenAI-compatible completions API endpoint at
/v1/completions. - ›Supports launching with a
.kcppssettings file via the file selector GUI combined with--skiplauncher(the settings file must already have a model selected).
+5 moreshow less
- ›Increases
stop_sequencelimit to 16. - ›Upgrades Lite polled-streaming to work in multiuser mode by issuing a unique key per request.
- ›Enhances
Remote-Link.cmdto run on Linux, creating a Cloudflare tunnel for remote access. - ›Adds Session Stats (Total Kudos Earned, EarnRate, Timings) to the embedded horde worker.
- ›Improves SSE streaming by batching pending tokens between events.
└──▷ BREAKING ON UPGRADE- !The
--psutil_set_threadsargument is deprecated and will be removed in a future version. - !The
--streamargument is deprecated and will be removed; streaming is now a toggle saved inside Lite's settings. - !The
--unbantokensargument is deprecated and will be removed; EOS unbans must now be set via the generate API using theuse_default_badwordsidsJSON field. - !The
--usemirostatargument is deprecated and will be removed; Mirostat values must now be set via the generate API using themirostat,mirostat_tau, andmirostat_etaJSON fields. - !The OpenAI completions endpoint moved from
/api/extra/oai/v1/completionsto/v1/completions.
- ›Adds
- v1.44.2
KoboldCpp v1.44.2 adds multi-user queuing,
--onreadyhooks, Grammar Sampling, a new context-length API endpoint, and a major Kobold Lite UI overhaul.└──▷ GET THIS VERSION$ git clone --branch v1.44.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.44.2
└──▷ TRY ITRun a shared KoboldCpp instance that queues up to 5 users and auto-starts a Cloudflare tunnel once the model is loaded.$ koboldcpp.exe --model my_model.gguf --multiuser --onready "cloudflared tunnel run my-tunnel"
Fetch the true maximum context length supported by the loaded model, independent of horde-reported limits.$ curl http://localhost:5001/api/extra/true_max_context_length- ›Adds
--multiuserflag enabling up to 5 concurrent incoming/generaterequests to be queued and processed in sequence instead of being rejected while busy. - ›Adds
--onreadylauncher argument to execute a terminal command (e.g. start a Python script or Cloudflare tunnel) as a subprocess after KoboldCpp finishes loading. - ›Adds
/api/extra/true_max_context_lengthAPI endpoint to fetch the true maximum context limit separately from the horde-friendly value. - ›Adds Grammar Sampling for all architectures, including older models, accessible via the web API and Kobold Lite; a BNDF grammar string can be specified in Lite settings.
- ›Extends GPU selection to a 4th GPU in both the UI and command line (previously capped at 3).
+9 moreshow less
- ›Adds a streaming toggle in the Kobold Lite settings panel to enable streaming without URL manipulation;
--streamflag is retained for compatibility. - ›Adds Mirostat UI configuration controls to the Kobold Lite settings panel.
- ›Adds Aesthetic UI for chat mode in Kobold Lite, automatically selected when importing Tavern cards, with easy switching between chat and instruct UIs from the settings panel.
- ›Adds support for importing characters from Chub.AI in Kobold Lite.
- ›Adds Instruct Tag Presets dropdown and instruct placeholder support (e.g.
{{[INPUT]}}and{{[OUTPUT]}}) in Kobold Lite for easy format switching, with a toggle for 'Raw Instruct Tags' as an alternative. - ›Adds 'Newline After Memory' and 'Show Rename Save File' toggles in Kobold Lite settings.
- ›Adds automatic expansion of the max context size slider limit in Kobold Lite when a larger context is detected.
- ›Makes Idle Responses a global setting available in all Kobold Lite modes.
- ›Adds smarter group chat behavior in Kobold Lite — mentioning a specific character name directs that character to respond instead of selecting randomly.
- ›Adds
- v1.43
KoboldCpp v1.43 adds automatic RoPE scale calculation, older GGML support, and thread-safe SSE streaming improvements.
└──▷ GET THIS VERSION$ git clone --branch v1.43 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.43
- ›Adds automatic RoPE scale calculation based on a model's training context (
n_ctx_train) when--ropeconfigis not explicitly set;--ropeconfigoverrides this behavior. - ›Tweaks
--unbantokensto push banned token logit values further down, reducing rare appearances while avoiding-infto preserve sampling compatibility. - ›Adds support for older GGML format (
ggjt_v3) for 34B LLaMA 2 models (note: may have issues whenn_gqais not 1; GGUF recommended in that case). - ›Adds mutex for thread-safe polled-streaming, enabling safer concurrent SSE stream consumption.
- ›Integrates SSE streaming improvements for more reliable server-sent event delivery.
+3 moreshow less
- ›HIP and CUDA visible devices are now scoped to a single GPU when a GPU number is provided and tensor split is not specified.
- ›Enables SSE3 flags for failsafe mode, restoring and improving Windows 7 compatibility in noavx2 and failsafe modes.
- ›Updates Kobold Lite to use placeholders for instruct tags that are swapped during generation.
- ›Adds automatic RoPE scale calculation based on a model's training context (
- v1.42.1
KoboldCpp v1.42.1 adds GGUFv2 model support, AMD HIPBLAS GPU builds, GGUF Falcon models, and API-level EOS token unbanning.
└──▷ GET THIS VERSION$ git clone --branch v1.42.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.42.1
- ›Supports unbanning EOS tokens via API, now also triggerable from Lite UI settings; the
--unbantokensCLI flag forces an override of API-set values. - ›Adds support for LLAMA GGUFv2 models, handled automatically with backward compatibility for older models.
- ›Adds AMD GPU build support via HIPBLAS (ROCm), offering faster inference than CLBlast for AMD hardware.
- ›Adds support for GGUF Falcon models; GPU layer offload works with CUDA but is unavailable with
--useclblast. - ›Adds tavern-style portraits in Kobold Lite's Aesthetic Instruct mode.
- ›Supports unbanning EOS tokens via API, now also triggerable from Lite UI settings; the
- v1.41
KoboldCpp v1.41 adds GGUF model support, a
--configflag for settings files, and a new/api/extra/tokencountendpoint.└──▷ GET THIS VERSION$ git clone --branch v1.41 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.41
└──▷ TRY ITLaunch KoboldCpp with a saved settings profile instead of re-specifying every flag each run.$ koboldcpp.exe --config mymodel.kcpps
- ›Adds
--configflag to load a.kcppssettings file at launch from the command line;.kcppsfiles can also be imported and exported from the GUI. - ›Adds new
/api/extra/tokencountendpoint to tokenize any string and accurately measure its token count. - ›Supports LLAMA GGUF model format, detected and handled automatically alongside all existing model formats.
- ›Adds
- v1.40.1a
KoboldCpp v1.40.1a adds an
idlefield to/api/extra/perfand an aesthetic instruct UI option in Lite.└──▷ GET THIS VERSION$ git clone --branch v1.40.1a https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.40.1a
└──▷ TRY ITPoll whether KoboldCpp is currently busy generating before submitting a new request, avoiding queuing conflicts.$ curl http://localhost:5001/api/extra/perf- ›Adds
idlefield to theGET /api/extra/perfendpoint, allowing callers to check whether a generation is currently in progress without submitting a generation request. - ›Adds an aesthetic instruct UI option (early beta) in the Lite interface.
- ›Converts the embedded horde worker to daemon mode to improve stability.
- ›Adds
- v1.39.1
KoboldCpp v1.39.1 adds
--blasbatchsize 2048, 12k/16k context sizes, and Tavern V2 card import with world info.└──▷ GET THIS VERSION$ git clone --branch v1.39.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.39.1
└──▷ TRY ITRun inference with a very large batch size when VRAM allows, to maximize throughput.$ koboldcpp.exe --model <model_path> --blasbatchsize 2048
- ›Adds experimental
--blasbatchsize 2048support (note: buffers are doubled, consuming significantly more memory). - ›Adds
--contextsizeoptions for 12k and 16k context windows. - ›Adds Tavern V2 card format import in KoboldCpp Lite, including world info (character book) and improved settings edit boxes.
- ›Pulls upstream CUDA speedups for MMQ mode across all quantization types.
- ›Adds experimental
- v1.38
KoboldCpp v1.38 adds Quantized MatMul (MMQ) prompt processing for CUDA via
--usecublas mmq.└──▷ GET THIS VERSION$ git clone --branch v1.38 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.38
└──▷ TRY ITRun aQ4_0model with MMQ prompt processing on CUDA to reduce VRAM usage and speed up inference.$ koboldcpp.exe --model <model_path> --usecublas mmq
- ›Adds
--usecublas mmqflag (also togglable in GUI) to enable Quantized MatMul (MMQ) prompt processing on CUDA, reducing memory usage and improving speed forQ4_0models. - ›Displays a terminal warning when received context exceeds the max launcher-allocated context.
- ›Adds a Help button in the GUI.
└──▷ BREAKING ON UPGRADE- !
--noavx2mode no longer uses OpenBLAS, now behaving the same as Failsafe mode.
- ›Adds
- v1.37.1a
KoboldCpp v1.37.1 adds an embedded Horde Worker, LLAMA2 70B support, and exposes
--tensor_splitfor CUDA multi-GPU use.└──▷ GET THIS VERSION$ git clone --branch v1.37.1a https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.37.1a
└──▷ TRY ITShare your local GGML model with the AI Horde without any extra software — the worker runs in the background alongside normal inference.$ koboldcpp.exe --model mymodel.gguf --hordeconfig 'MyHordeModel' 512 2048 'my-api-key-here' 'MyWorkerName'
Retrieve per-generation performance details including stopping reason and token counts from the API.$ curl http://localhost:5001/api/extra/perf- ›Extends
--hordeconfigto accept 5 parameters —[hordemodelname] [hordegenlength] [hordemaxctx] [hordeapikey] [hordeworkername]— which starts an embedded AI Horde worker that serves requests automatically in the background, eliminating the need for separate tools like HaidraScribe/KAIHordeBridge. - ›Exposes
--tensor_splitfor splitting model layers across multiple CUDA GPUs, matching upstream behavior. - ›Retains
--blasbatchsize 1024support after it was removed upstream (note: scratch and KV buffer sizes will be larger when used). - ›Adds LLAMA2 70B model support, with GQA automatically set to 8 upon detection.
- ›Adds additional fields to
/api/extra/perfresponse, including stopping reason and generated token counts for the last generation.
+1 moreshow less
- ›Adds experimental Kepler architecture (e.g. K80) as a CUDA build target.
- ›Extends
- v1.36
KoboldCpp v1.36 replaces
--linearropewith--ropeconfigfor unified RoPE tuning and exposes new perf data via/api/extra/perf.└──▷ GET THIS VERSION$ git clone --branch v1.36 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.36
└──▷ TRY ITRun LLAMA2 at native 4K context without any RoPE scaling, taking full advantage of the model's built-in tuning.$ koboldcpp.exe --model llama2-7b.gguf --contextsize 4096 --ropeconfig 1.0 10000
Extend context beyond the model's native limit using 2x linear RoPE scaling.$ koboldcpp.exe --model llama2-7b.gguf --contextsize 8192 --ropeconfig 0.5 10000
Query per-request token counter and performance metrics from the API for monitoring throughput.$ curl http://localhost:5001/api/extra/perf- ›Adds
--ropeconfig <scale> <base>CLI argument to control both RoPE frequency scale (Linear) and RoPE frequency base (NTK-Aware) in a single flag, replacing the removed--linearropeflag — e.g.--ropeconfig 0.5 10000for 2x linear scale or--ropeconfig 1.0 10000for native LLAMA2 4K tuning. - ›Exposes additional token counter data through the API endpoint
/api/extra/perf. - ›Automatically configures long-context
NTK-Aware RoPEbased on the--contextsizeparameter by default, with no manual tuning required. - ›Adds
--ropeconfigsupport in the GUI for ease of use. - ›Updates Kobold Lite with improved whitespace trim support and a new toggle for partial chat responses.
└──▷ BREAKING ON UPGRADE- !The
--linearropeflag has been removed; replace it with--ropeconfig <scale> <base>(e.g.--ropeconfig 0.5 10000for equivalent 2x linear scaling).
- ›Adds
- v1.35
KoboldCpp v1.35 adds CUDA 8-bit MMV acceleration, a new
/api/extra/perfendpoint, and--linearropecontext scaling.└──▷ GET THIS VERSION$ git clone --branch v1.35 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.35
└──▷ TRY ITRun a SuperHOT fine-tuned model with linear RoPE scaling to match its recommended 0.25 scale at 8K context.$ koboldcpp.exe --model superhot-13b.gguf --linearrope --contextsize 8192
Poll real-time prompt-processing and generation timing from a running instance to benchmark throughput.$ curl http://localhost:5001/api/extra/perf- ›Adds
--linearropelaunch parameter to enable linear RoPE scaling (using 2048 as base) as an alternative to NTK-Aware RoPE; combine with--contextsize 8192for a0.25linear scale suited to SuperHOT models. - ›Exposes prompt-processing and generation timing via new API endpoint
GET /api/extra/perf. - ›Enables CUDA 8-bit MMV mode (quantized dot products) for formats
q4_0,q4_1,q5_0, andq5_1, delivering significant GPU throughput gains when full GPU offload is used; K-quants and CL are unaffected. - ›Adds Save and Load settings options to the GUI launcher.
- ›Adds 'All Devices' selection in the GUI for CUDA multi-GPU configurations.
+1 moreshow less
- ›Displays a warning when poor sampler orders are detected, nudging users toward the default configuration.
- ›Adds
- v1.34.2
KoboldCpp v1.34.2 adds NTK-aware RoPE scaling to 8K context,
--bantokens, per-generation sampler_order/mirostat, and a new customtkinter GUI.└──▷ GET THIS VERSION$ git clone --branch v1.34.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.34.2
└──▷ TRY ITBlock unwanted tokens globally — useful when a model repeatedly abuses specific characters or substrings.$ koboldcpp.exe --model mymodel.ggml --contextsize 4096 --bantokens [ a ooo
Route inference to a specific GPU (e.g. the third card) in a multi-GPU rig while staying in low-VRAM mode.$ koboldcpp.exe --model mymodel.ggml --usecublas lowvram 2 --contextsize 8192
Use per-generation mirostat sampling via the/generateAPI instead of global defaults.$ curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "mirostat": 2, "mirostat_tau": 5.0, "mirostat_eta": 0.1, "sampler_order": [6,0,1,3,4,2,5]}'
- ›Adds
--bantokensCLI flag to block a list of token substrings from being generated — e.g.--bantokens [ a ooobans all tokens matching those substrings. - ›Adds
--usecublas lowvram <index>syntax for selecting a specific GPU by index when using CUDA multi-GPU setups. - ›Adds
sampler_orderandmirostat/tau/etaparameters to the/generateAPI, settable per-generation request. - ›Switches RoPE scaling to NTK-aware method driven by the existing
--contextsizeparameter, with support up to 8K context. - ›Extends NTK-aware scaled RoPE support to GPT-NeoX and GPT-J model architectures, enabling longer context (e.g. 4K) on older models.
+3 moreshow less
- ›Adds 3K and 6K as selectable context size options alongside existing sizes.
- ›Adds a new
customtkinter-basedGUI with more configurable settings; requires thecustomtkinterPython module on Linux and macOS (bundled in Windows.exebuilds). - ›Kobold Lite now displays submitted contexts after each generation and adds two new scenarios plus limited Tavern v2 card support.
- ›Adds
- v1.33
KoboldCpp v1.33 adds unified CUDA+CL distribution, GPU acceleration for more model architectures, and long-context Scaled RoPE support.
└──▷ GET THIS VERSION$ git clone --branch v1.33 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.33
└──▷ TRY ITRun a model with CUDA acceleration on a low-VRAM GPU by offloading layers to the GPU while keeping memory usage minimal.$ koboldcpp.exe --usecublas lowvram --model <path-to-model.ggml>
Enable extended context beyond the default 2048-token limit using Scaled RoPE for longer conversations or documents.$ koboldcpp.exe --usecublas --contextsize 3072 --model <path-to-model.ggml>
- ›Adds
--usecublasflag to select CUDA inference mode, with--usecublas lowvramfor low-VRAM operation, alongside--useclblastfor CLBlast — all available in a single All-In-One distributable. - ›Adds
--contextsizeflag to enable long-context inference beyond 2048 tokens via Scaled RoPE for LLAMA models (tested up to 3k+). - ›Extends CUDA GPU layer offloading to MPT, GPT-2, GPT-J, and GPT-NeoX model architectures.
- ›Back-ports CUDA support to all prior GGML file format versions (GGML, GGMF, GGJT v1/v2/v3), allowing legacy quants to load and run under CUDA mode.
- ›Applies VRAM memory optimizations (previously OpenCL-only) to CUDA, enabling more layers to be offloaded than upstream llama.cpp.
+1 moreshow less
- ›Instruct mode now supports any number of newlines in start and end tags, configurable by the user.
- ›Adds
- v1.32.3
KoboldCpp v1.32.3 brings OpenCL K-Quant CUDA kernel ports and GPU offloading for MPT, GPT-2, GPT-J, and GPT-NeoX architectures.
└──▷ GET THIS VERSION$ git clone --branch v1.32.3 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.32.3
- ›Ports optimized K-Quant CUDA kernels to OpenCL, delivering approximately 15% faster generation speed for K-Quant models on OpenCL backends.
- ›Adds basic GPU offloading via OpenCL for MPT, GPT-2, GPT-J, and GPT-NeoX architectures, achieving roughly 50% speedup for GPT-J and 30% for WizardCoder (weights still copied to RAM).
- ›Implements scratch buffers for MPT, GPT-2, NeoX, and GPT-J architectures, significantly reducing BLAS memory usage and enabling larger BLAS batch sizes on these models.
- ›Extends GPT tokenizer with support for Starcoder special added tokens, improving coherence for non-llama models.
- v1.31.2
KoboldCpp v1.31.2 adds horde max context control, debug-mode-gated output, and console token generation rate display.
└──▷ GET THIS VERSION$ git clone --branch v1.31.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.31.2
└──▷ TRY ITEnable verbose server endpoint logging during development without exposing horde prompt content in shared environments.$ koboldcpp --debugmode --hordeconfig <api_key> <worker_name>
- ›Adds
--hordeconfigsupport for specifying a separate max context length allowed in horde, independent of the real context length used for memory allocation. - ›Displays token generation rate in the console during inference.
- ›Gates server endpoint debug output behind
--debugmode; also suppresses incoming horde prompt logs when--hordeconfigis set unless--debugmodeis also enabled. - ›Adds new scenarios, italics chat text, and customizable idle message counts to Kobold Lite.
└──▷ BREAKING ON UPGRADE- !RWKV sequence mode is disabled; setups relying on it for speed improvements will no longer benefit from those gains.
- ›Adds
- v1.30.3
KoboldCpp v1.30.3 adds OpenCL K-Quant GPU offload, RWKV World Tokenizer, SSE streaming, abort endpoint, and LoRA base support.
└──▷ GET THIS VERSION$ git clone --branch v1.30.3 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.30.3
└──▷ TRY ITAbort a runaway generation without restarting the server — useful in CI pipelines or interactive sessions.$ curl -X POST http://localhost:5001/api/extra/abort
Load a LoRA adapter with an explicit base model so the adapter is applied against the correct base weights.$ koboldcpp --model my_model.gguf --lora my_adapter.bin my_base_model.gguf
- ›Adds a true SSE-streaming endpoint at
/api/extra/generate/stream(Agnaistic-compatible) that streams tokens in real time during generation. - ›Adds a polled-streaming endpoint at
/api/extra/generate/checkto fetch in-progress results without disrupting generation; the old 8-token chunked streaming remains available viastreamamount=8in the URL. - ›Adds an abort endpoint at
/api/extra/abortthat halts in-progress generation without stopping the server, integrated into Kobold Lite via an 'abort' button. - ›Adds
--lora [lora_file] [base_model]optional second parameter for specifying a LoRA base model. - ›Adds full OpenCL / CLBlast support for K-Quants, covering both prompt processing and GPU offloading across all K-quant formats.
+2 moreshow less
- ›Adds support for the RWKV World Tokenizer and RWKV-World models, with automatic detection and selection.
- ›Adds CUDA support for older ggjtv2 models via backport, available through
koboldcpp_CUDA_only.exe.
- ›Adds a true SSE-streaming endpoint at
- v1.29
KoboldCpp v1.29 adds BLAS batch size control to the Easy Launcher GUI and merges upstream K-quantization support for OpenBLAS.
└──▷ GET THIS VERSION$ git clone --branch v1.29 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.29
- ›Adds BLAS batch size setting to the KoboldCpp Easy Launcher GUI, giving users direct control over batch sizing without CLI flags.
- ›Merges upstream K-quantization (K-quants) implementations for OpenBLAS, expanding supported model quantization formats (note: K-quants remain unsupported in CLBlast).
- ›Adds streaming support for aesthetic chat mode in KoboldCpp Lite.
- v1.28
KoboldCpp v1.28 adds MPT model support, a new
--hordeconfigflag, and--blasbatchsize -1to maximize GPU layer offloading.└──▷ GET THIS VERSION$ git clone --branch v1.28 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.28
└──▷ TRY ITRegister a custom display name and max generation length when serving a model to the Horde network.$ koboldcpp.exe --model mymodel.ggml --hordeconfig 'MyHordeName' 512
- ›Renames
--renamemodelto--hordeconfig, which now accepts two parameters: the horde display name and the advertised max generation length on horde. - ›Adds
--blasbatchsize -1to disable BLAS while retaining CLBlast GPU layer offloading, enabling more layers to be offloaded and faster generation at the cost of slower prompt processing. - ›Adds support for MPT models; use
--contextsizeto set context length (up to ~5000 tokens tested). - ›Enhances the KoboldCpp Easy Launcher GUI with controls for the number of CLBlast GPU layers, thread count, and additional toggles.
- ›Improves CLBlast memory allocation efficiency, allowing more layers to be offloaded to GPU than before.
└──▷ BREAKING ON UPGRADE- !The
--renamemodelflag has been renamed to--hordeconfig; any scripts or configs using--renamemodelwill break on upgrade.
- ›Renames
- v1.27
KoboldCpp v1.27 adds
--renamemodel, RWKV v101 support, AutoGenerated Memory in Kobold Lite, and CL BLAST VRAM-only layer offloading.└──▷ GET THIS VERSION$ git clone --branch v1.27 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.27
└──▷ TRY ITOverride the model name reported to the Horde network so it appears under a custom identifier.$ koboldcpp.exe --renamemodel mymodel
- ›Adds
--renamemodelCLI flag to override the displayed model name (prefixed withkoboldcpp/), useful for Horde operators. - ›Supports RWKV.cpp v101 model format (updated GGML library, smaller and faster), with automatic backwards-compatible detection of both old and new quantization formats.
- ›Adds EOS token support for RWKV models.
- ›Integrates CLBlast GPU offloading improvement that stores layers fully in VRAM without a duplicate RAM copy, reducing overall RAM usage when offloading GPU layers.
- ›Adds AutoGenerated Memory feature in Kobold Lite, which generates a short story summary/memory with a single click (works best with instruct models).
+1 moreshow less
- ›Pulls upstream support for OpenLlama 3B models.
- ›Adds
- v1.26b
KoboldCpp v1.26b adds token probability inspection via
--debugmode, a new Top-A sampler, and Starcoder model support.└──▷ GET THIS VERSION$ git clone --branch v1.26b https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.26b
└──▷ TRY ITInspect per-token probabilities and context contents during generation to evaluate sampler settings or diagnose model overconfidence.$ koboldcpp.exe --model my_model.bin --debugmode
Re-enable EOS stop tokens (previously blocked by default) so generation halts correctly on end-of-sequence across all model architectures.$ koboldcpp.exe --model my_model.bin --unbantokens
- ›Adds token probability display to
--debugmode: for every generated token, the console shows probabilities of up to 4 alternative tokens after all samplers are applied, enabling sampler configuration testing and model confidence analysis. - ›Adds
--debugmodedisplay of input/context contents and their token IDs (note: slight performance hit; off by default). - ›Adds
--unbantokensflag to enable EOS stop tokens across all model types; the[token is also no longer banned by default. - ›Adds the Top-A sampler, a Kobold-exclusive implementation not present in upstream llama.cpp, which reduces randomness proportionally to the squared softmax probability of the most probable token (set to
0to disable). - ›Adds support for Starcoder and Starcoder Chat models.
- ›Adds token probability display to
- v1.25.1
KoboldCpp v1.25.1 adds Failsafe mode for AVX-less hardware, sampler_seed API support, and streaming length control in Lite UI.
└──▷ GET THIS VERSION$ git clone --branch v1.25.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.25.1
└──▷ TRY ITRun KoboldCpp on a legacy CPU with no AVX/SSE support (including Windows 7) using Failsafe mode.$ koboldcpp.exe --noavx2 --noblas --nommap --model <path-to-model>
Set a fixed sampler seed via the KoboldAI/generateAPI for reproducible outputs.$ curl -X POST http://localhost:5001/api/v1/generate -H 'Content-Type: application/json' -d '{"prompt": "Once upon a time", "sampler_seed": 42}'
- ›Adds Failsafe mode via
--noavx2 --noblas --nommapflags, disabling all CPU intrinsics (AVX, SSE) to run on ancient hardware including Windows 7. - ›Adds
sampler_seedparameter support to the/generateAPI endpoint for reproducible generation. - ›Adds
?streamamount=[value]URL parameter to Kobold Lite UI for controlling variable streaming lengths (default: 8 tokens) when launched with--stream. - ›Expands
--debugmodeconsole logging to display context token contents. - ›Adds drag-and-drop file load functionality to Kobold Lite UI.
+2 moreshow less
- ›Greatly improved markdown rendering support in Kobold Lite UI.
- ›Upgrades CLBlast to version 1.6.
- ›Adds Failsafe mode via
- v1.24
KoboldCpp v1.24 adds GGJT v3 quantization support (q4_0, q4_1, q8_0) and new Kobold Lite UI toggles.
└──▷ GET THIS VERSION$ git clone --branch v1.24 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.24
- ›Supports the new GGJT v3 quantization format, including
q4_0,q4_1, andq8_0quantization types, while retaining backwards compatibility with all historical GGML formats (GGML, GGHF, GGJT v1, v2, v3). - ›Adds a toggle in Kobold Lite to avoid inserting newlines in Instruct mode, useful for Pygmalion and OpenAssistant based instruct models.
- ›Adds a toggle in Kobold Lite to enable basic markdown rendering in Instruct mode (off by default).
- ›Provides an alternative CUDA build (via Henky) for this version, enabling access to the latest GGJT v3 quantizations for CUDA users on LLAMA-based models.
- ›Supports the new GGJT v3 quantization format, including
- v1.23.1
KoboldCpp v1.23.1 adds GPT-2/J/NeoX quantization support and experimental OpenCL GPU offloading via CLBlast.
└──▷ GET THIS VERSION$ git clone --branch v1.23.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.23.1
└──▷ TRY ITOffload a fixed number of LLAMA model layers to a GPU using OpenCL/CLBlast to accelerate inference on any OpenCL-capable GPU.$ koboldcpp.exe --useclblast --gpulayers 20 <path-to-model.ggml>
- ›Adds experimental OpenCL GPU offloading via CLBlast using
--useclblastcombined with--gpulayers <n>to select the number of layers to offload; works on all GPUs for new quantization formats of LLAMA models. - ›Extends GPU offloading support to q8 quantization formats after pulling the q8 dequant kernel fix.
- ›Adds support for new quantization formats for GPT-2, GPT-J, and GPT-NeoX models.
- ›Adds experimental OpenCL GPU offloading via CLBlast using
- v1.20
KoboldCpp v1.20 adds
--contextsizeflag for large contexts and--forceversionfor RedPajama/GPT-NeoX model support.└──▷ GET THIS VERSION$ git clone --branch v1.20 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.20
└──▷ TRY ITRun a large-context model that exceeds the default 2048-token limit.$ koboldcpp.exe --contextsize 4096 my_model.bin
- ›Adds
--contextsizeflag to allocate additional RAM and support context sizes beyond 2048 tokens. - ›Adds
--forceversionflag to manually override model version detection when automatic RedPajama identification fails. - ›Adds experimental support for RedPajama variants of GPT-NeoX models.
- ›Adds
- v1.19
KoboldCpp v1.19 adds mirostat sampling, force-version override, CLBlast thread control, and expanded RWKV quantization support.
└──▷ GET THIS VERSION$ git clone --branch v1.19 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.19
└──▷ TRY ITEnable mirostat type 2 sampling to get more coherent output from a large model without manual temperature/top-p tuning.$ koboldcpp.exe --model mymodel.bin --usemirostat 2 5.0 0.1
Load a modified or misdetected model by forcing the format version, bypassing failed auto-detection.$ koboldcpp.exe --model rogue_model.bin --forceversion 401
Tune CLBlast throughput independently from CPU threads when GPU-accelerated inference is active.$ koboldcpp.exe --model mymodel.bin --threads 4 --blasthreads 8
- ›Adds
--usemirostat [type] [tau] [eta]flag to enable mirostat sampling on all model types, replacing normal stochastic samplers; e.g.--usemirostat 2 5.0 0.1for mirostat type 2. - ›Adds
--forceversion [ver]flag to override automatic model file format detection when it fails, e.g.401for GPTNeoX-Type2. - ›Adds
--blasthreadsflag to set a separate thread count when CLBlast is active, defaulting to the value of--threadsif not specified. - ›Expands RWKV support to include all new RWKV quantizations, with
q5_1delivering significantly faster inference thanfp16at similar quality. - ›Includes an experimental Windows 7-compatible
.exebuild for this release.
└──▷ BREAKING ON UPGRADE- !RWKV
Q4_1_Oquantization is no longer supported following the upstream change.
- ›Adds
- v1.18
KoboldCpp v1.18 adds group chat conversations,
--highpriorityCPU boost flag, and--usemlockRAM-pinning for Apple M1.└──▷ GET THIS VERSION$ git clone --branch v1.18 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.18
└──▷ TRY ITSpeed up token generation on a CPU-bound machine by elevating KoboldCpp's process priority.$ koboldcpp.exe --model mymodel.bin --highpriority
Keep a large model pinned in RAM on Apple M1 to avoid swapping and reduce generation latency.$ koboldcpp.exe --model mymodel.bin --usemlock
- ›Adds
--highpriorityCLI flag to raise the process CPU priority, potentially reducing generation latency. - ›Adds
--usemlockCLI parameter to pin the model in RAM, targeting Apple M1 users. - ›Adds Group Conversations to Kobold Lite chat mode: specify multiple chat opponents delimited with
||$||(up to 10 custom stopping sequences) so the AI replies as different participants; works best with Multiline Replies disabled and on LLAMA-based models. - ›Adds a new built-in scenario Class Reunion in Kobold Lite to demonstrate group chat functionality.
- ›Adds
- v1.17
KoboldCpp v1.17 adds
--unbantokensflag to unban tokens including EOS, required for newer Pygmalion models.└──▷ GET THIS VERSION$ git clone --branch v1.17 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.17
└──▷ TRY ITRun KoboldCpp with token unbanning enabled to support newer Pygmalion models that require EOS suppression.$ koboldcpp.exe --unbantokens
- ›Adds
--unbantokensCLI flag to unban tokens during generation, including prevention of EOS token generation, enabling compatibility with newer Pygmalion models. - ›Exposes Token Unbanning in the UI, allowing it to be configured without CLI flags.
- ›Adds
- v1.16
KoboldCpp v1.16 adds Tail Free Sampling and Typical Sampling, plus CLBlast support for q5_0 and q5_1 formats.
└──▷ GET THIS VERSION$ git clone --branch v1.16 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.16
- ›Adds CLBlast GPU acceleration support for the
q5_0andq5_1quantization formats. - ›Adds two new token samplers: Tail Free Sampling (TFS) and Typical Sampling, available alongside the reworked Top-P, Top-K, and Rep Pen samplers.
- ›Unifies sampling functions across all model architectures and types under a single overhauled sampling system.
└──▷ BREAKING ON UPGRADE- !Upstream llama.cpp has completely removed support for the
q4_3format; users are strongly advised to switch away fromq4_3and reconvert any existingq4_3models.
- ›Adds CLBlast GPU acceleration support for the
- v1.15
KoboldCpp v1.15 adds an Easy Mode GUI,
--debugmodeflag, q5_0/q5_1 quantization, and multi-sequence stop strings.└──▷ GET THIS VERSION$ git clone --branch v1.15 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.15
└──▷ TRY ITInspect exactly how your prompt is being tokenized before it reaches the model backend — useful for debugging context issues.$ koboldcpp.exe --model my_model.bin --debugmode
Run KoboldCpp in streaming mode while skipping the Easy Mode GUI, with the Lite UI automatically configured for streaming.$ koboldcpp.exe --model my_model.bin --stream --skiplauncher
- ›Adds
--skiplauncherflag to bypass the new Easy Mode GUI and proceed directly to CLI operation. - ›Adds
--debugmodeflag to print the tokenized prompt sent to the backend in the terminal window. - ›Setting
--streamnow automatically redirects the embedded Kobold Lite UI to streaming mode, removing the need to manually append?streaming=1to the URL. - ›Introduces a new Easy Mode GUI launcher that activates when no command-line arguments are provided, offering a guided setup for first-time users.
- ›Adds q5_0 and q5_1 quantization format support for llama.cpp, GPT-2, GPT-J, and GPT-NeoX model formats (OpenBLAS supported; CLBlast not yet supported).
+1 moreshow less
- ›Kobold Lite UI now supports multiple custom stopping sequences, separated by the
||$||delimiter, with sequences saved to save files and autosaved.
- ›Adds
- v1.14
KoboldCpp v1.14 adds backwards compatibility for older NeoX quantizations and bundles non-AVX2 support in a single executable.
└──▷ GET THIS VERSION$ git clone --branch v1.14 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.14
- ›Adds backwards compatibility for an older version of NeoX with different quantizations.
- ›Bundles non-AVX2 CPU support inside the same
.exe, selectable with the--noavx2flag. - ›Supports GPU acceleration via CLBlast with the
--useclblastflag. - ›Supports
--smartcontextflag to reduce prompt processing frequency for large contexts.
- v1.13.1
KoboldCpp v1.13.1 adds
--unbantokensflag and expands CLBlast GPU quantization support with up to 50% faster prompt processing.└──▷ GET THIS VERSION$ git clone --branch v1.13.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.13.1
└──▷ TRY ITAllow the model to produce EOS and Square Bracket tokens that are normally suppressed, useful when the output format requires them.$ koboldcpp.exe --unbantokens mymodel.bin
- ›Adds
--unbantokensCLI flag to allow previously banned tokens such as EOS and Square Brackets to be generated. - ›Adds CLBlast dequantization support for
q4_2andq4_3quantization formats, enabling GPU-accelerated inference for models using those formats. - ›Adds quantization handling for GPT-NeoX, GPT-2, and GPT-J model architectures.
- ›Makes
mmapautomatic when a LoRA adapter is selected.
- ›Adds
- v1.11
KoboldCpp v1.11 adds GPT-NeoX/Pythia/StableLM support,
--lorafor llama, and multi-backend build improvements.└──▷ GET THIS VERSION$ git clone --branch v1.11 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.11
└──▷ TRY ITBuild both OpenBLAS and CLBlast backends on Linux/OSX, then select CLBlast at runtime for GPU acceleration.$ make LLAMA_OPENBLAS=1 LLAMA_CLBLAST=1 && ./koboldcpp mymodel.bin --useclblast
- ›Adds
--loraparameter to enable LORA file support for llama models. - ›Adds GPT-NeoX, Pythia, and StableLM model architecture support.
- ›Adds limited fast-forwarding for RWKV, allowing context reuse when the context is completely unmodified.
- ›Kobold Lite UI now supports a custom stopping sequence, configurable in the Memory panel.
- ›Improved OSX and Linux builds now compile multiple acceleration backends (e.g.
make LLAMA_OPENBLAS=1 LLAMA_CLBLAST=1) and allow selecting between them at runtime via flags such as--useclblast.
- ›Adds
- v1.10
KoboldCpp v1.10 adds RWKV model support, a browser-launch flag, and a new version endpoint.
└──▷ GET THIS VERSION$ git clone --branch v1.10 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.10
└──▷ TRY ITStart KoboldCpp in streaming mode and immediately open the browser, useful for local one-command launches.$ koboldcpp.exe --stream --launch mymodel.bin
Query the running instance to confirm the KoboldCpp version from a script or healthcheck.$ curl http://localhost:5001/api/extra/version- ›Adds
--launchCLI flag to automatically open the browser on startup (combinable with existing flags, e.g.--stream --launch). - ›New
/api/extra/versionendpoint returns the running KoboldCpp version number. - ›Adds native RWKV model support with no external dependencies — no PyTorch or tokenizers libraries required.
- ›Adds
- v1.9
KoboldCpp v1.9 adds API stopping sequences support and BLAS mode for GPT-J and GPT2 models.
└──▷ GET THIS VERSION$ git clone --branch v1.9 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.9
- ›Adds stopping sequences support to the API, allowing generation to halt early when a stop sequence is matched and return the response immediately without consuming remaining tokens.
- ›GPT-J and GPT2 models now support BLAS mode for faster inference, using a smaller batch size than LLaMA models.
- v1.8.1
KoboldCpp v1.8.1 brings ~20% CLBlast speed boost via GPU-side 4-bit dequantization.
└──▷ GET THIS VERSION$ git clone --branch v1.8.1 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.8.1
- ›CLBlast now performs 4-bit dequantization on the GPU (via
--useclblast [platform_id] [device_id]), delivering approximately 20% faster inference for CLBlast users.
- ›CLBlast now performs 4-bit dequantization on the GPU (via
- v1.7
KoboldCpp v1.7 adds
--smartcontextto avoid frequent prompt context recalculation.└──▷ GET THIS VERSION$ git clone --branch v1.7 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.7
└──▷ TRY ITRun KoboldCpp with smart context to reduce recalculation overhead during long conversations.$ koboldcpp.exe --smartcontext <model_path>
Run KoboldCpp on hardware without AVX2 support using the bundled fallback path.$ koboldcpp.exe --noavx2 <model_path>
- ›Adds
--smartcontextflag, a prompt context manipulation mode that avoids frequent context recalculation when the context window is full. - ›Adds
--noavx2flag to enable a non-AVX2 execution path, now bundled in the same.exe.
- ›Adds
- v1.6
KoboldCpp v1.6 adds GPU name display and bundles non-AVX2 support into a single executable.
└──▷ GET THIS VERSION$ git clone --branch v1.6 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.6
└──▷ TRY ITRun KoboldCpp on a machine that lacks AVX2 support (e.g., older CPUs) using the now-bundled non-AVX2 path.$ koboldcpp.exe --noavx2 --model <path-to-model>
- ›Bundles the non-AVX2 build into the same
koboldcpp.exe, enabled via the--noavx2flag — no separate download needed on older hardware.
- ›Bundles the non-AVX2 build into the same
- v1.5
KoboldCpp v1.5 adds AVX2/non-AVX2 unified binary and experimental CLBlast GPU acceleration for prompt processing.
└──▷ GET THIS VERSION$ git clone --branch v1.5 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.5
└──▷ TRY ITEnable GPU-accelerated prompt processing via CLBlast by specifying your OpenCL platform and device IDs.$ koboldcpp.exe --useclblast 0 0 ggml_model.bin
Run KoboldCpp on an older CPU that lacks AVX2 support by falling back to the compatibility codepath bundled in the same executable.$ koboldcpp.exe --noavx2 ggml_model.bin
- ›Adds
--useclblast [platform_id] [device_id]flag to enable experimental CLBlast GPU acceleration for faster prompt processing. - ›Adds
--noavx2flag to switch to compatibility mode on CPUs without AVX2 support, now bundled into the same binary instead of a separate download. - ›Includes quantization tools in
tools.zipfor converting fp16 models to quantized format.
- ›Adds
- v1.4
KoboldCpp v1.4 makes mmap the default and adds
--nommapto opt out.└──▷ GET THIS VERSION$ git clone --branch v1.4 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.4
└──▷ TRY ITRun KoboldCpp without memory-mapped loading to restore the pre-v1.4 default behavior.$ koboldcpp.exe --nommap <model_path>
- ›Adds
--nommapflag to disable memory-mapped file loading, which is now enabled by default.
└──▷ BREAKING ON UPGRADE- !mmap is now enabled by default; existing setups that relied on mmap being off will need to add
--nommapto preserve previous behavior.
- ›Adds
- v1.3
KoboldCpp v1.3 adds
--usemmapflag, auto-detection of GPTJ/GPT2 quantized file versions, and startup version display.└──▷ GET THIS VERSION$ git clone --branch v1.3 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.3
└──▷ TRY ITRe-enable memory-mapped file loading on a system where mmap improves load times, overriding the new default.$ koboldcpp.exe --usemmap ggml_model.bin
- ›Adds
--usemmapflag to opt back in to memory-mapped file loading, which is now disabled by default following upstream enhancements. - ›Automatically distinguishes between older and newer GPTJ and GPT2 quantized model files, removing the need for manual format selection.
- ›Displays version numbers at startup for easier identification of the running build.
└──▷ BREAKING ON UPGRADE- !
mmap(memory-mapped file loading) is now disabled by default; existing setups relying on mmap behavior must explicitly pass--usemmapto restore it.
- ›Adds
- v1.2
KoboldCpp v1.2 adds support for newer GPT-2 model variants including Cerebras models from Hugging Face.
└──▷ GET THIS VERSION$ git clone --branch v1.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.2
- ›Supports new versions of GPT-2 models, including Cerebras models hosted on Hugging Face.
- v1.0.9beta
KoboldCpp v1.0.9beta adds GPT-2 model support and Alpaca Instruct Mode in the embedded Kobold Lite UI.
└──▷ GET THIS VERSION$ git clone --branch v1.0.9beta https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.9beta
- ›Adds GPT-2 model support (including theoretical compatibility with Cerebras models), enabling inference on very small ggml models at high token throughput on CPU.
- ›Adds Stanford Alpaca-compatible Instruct Mode to the embedded Kobold Lite interface, enabling structured prompt/response formatting — configurable in Kobold Lite settings.
- ›Adds repetition penalty (Rep Pen) support for GPT-J and GPT-2 models (and pyg.cpp), bringing penalty behavior in line with llama.cpp.
- v1.0.8beta
KoboldCpp v1.0.8beta adds GPT4ALL.CPP and GPT-J format support and boosts generation speed with
-Ofast.└──▷ GET THIS VERSION$ git clone --branch v1.0.8beta https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.8beta
└──▷ TRY ITOverride the new physical-core-based thread default to maximize throughput on a hyperthreaded or high-core-count machine.$ koboldcpp.exe --threads 16 <model_path>
- ›Adds support for the original GPT4ALL.CPP model format.
- ›Adds support for GPT-J formats, including the original 16-bit legacy format and the 4-bit version from Pygmalion.cpp.
- ›Switches compiler optimization flag from
-O3to-Ofast, increasing token generation speed. - ›Changes default thread count to scale by physical core count rather than os.cpu_count(), with manual override available via
--threads.
└──▷ BREAKING ON UPGRADE- !Library file names and references are renamed as part of the rebranding from llamacpp-for-kobold to koboldcpp — any scripts or integrations referencing the old library names will break.
- v1.0.7
KoboldCpp v1.0.7 adds ggjt model format support, streaming opt-in via
--stream, and richer console generation progress.└──▷ GET THIS VERSION$ git clone --branch v1.0.7 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.7
└──▷ TRY ITRun KoboldCpp with streaming enabled after the default changed to non-streaming.$ llamacpp-for-kobold.exe --stream
- ›Adds
--streamflag to opt into streaming mode; non-streaming is now the default. - ›Supports the new ggml llama.cpp model format (
magic=ggjt, version 3) while retaining backward compatibility with all older versions. - ›Improved console debug output during generation now shows token progress and time taken in real time.
└──▷ BREAKING ON UPGRADE- !Non-streaming mode is now the default; setups that relied on streaming behavior must now explicitly pass
--streamto restore it.
- ›Adds
- v1.0.6beta
KoboldCpp v1.0.6beta adds OpenBLAS acceleration and a
--noblasflag, doubling initial prompt processing speed.└──▷ GET THIS VERSION$ git clone --branch v1.0.6beta https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.6beta
└──▷ TRY ITRun the server without OpenBLAS if you hit compatibility issues on your OS or platform.$ llamacpp-for-kobold.exe --noblas
Discover all available command-line flags in this release.$ llamacpp-for-kobold.exe --help
- ›Adds
--noblasflag to disable OpenBLAS acceleration at runtime. - ›Adds
--helpflag via switch to argparse, exposing all command-line options. - ›Integrates OpenBLAS to accelerate initial prompt processing by over 2x on compatible systems.
- ›Updates Embedded Kobold Lite with pseudo token streaming for a more responsive generation UI.
- ›Adds
- v1.0.5
KoboldCpp v1.0.5 adds a softprompts endpoint and selectable KV data types.
└──▷ GET THIS VERSION$ git clone --branch v1.0.5 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.5
- ›Adds
/apisoftprompts endpoint, enabling softprompt injection via the KoboldAI-compatible API athttp://localhost:5001. - ›Adds support for selecting KV cache data type, defaulting to
f32instead off16. - ›Caps maximum thread count at 4 to improve throughput on memory-bottlenecked inference workloads.
└──▷ BREAKING ON UPGRADE- !The default KV cache data type changes from
f16tof32, which increases memory usage for existing setups.
- ›Adds
- v1.0.4
KoboldCpp v1.0.4 adds prompt token caching for faster generation and standalone PyInstaller executables for distribution.
└──▷ GET THIS VERSION$ git clone --branch v1.0.4 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.4
- ›Adds token caching for prompts, enabling fast-forward through partially duplicated prompt prefixes so edits near the end of a previous prompt regenerate significantly faster.
- ›Introduces a standalone PyInstaller-built
llamacpp_for_kobold.exefor all future releases, supporting drag-and-drop model loading or interactive model selection via a popup dialog.
- v1.0.3
KoboldCpp v1.0.3 adds dynamic context length support and reduces default batch sizes for better output quality.
└──▷ GET THIS VERSION$ git clone --branch v1.0.3 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.3
- ›Supports dynamic context lengths sent from the client, allowing context size to vary per request.
- ›Reduces default batch sizes to lower memory usage and improve output quality.
- v1.0.2
KoboldCpp v1.0.2 embeds Kobold Lite UI and updates to the new ggml model format while retaining backward compatibility.
└──▷ GET THIS VERSION$ git clone --branch v1.0.2 https://github.com/LostRuins/koboldcpp.git # already have the repo? check out this version: $ git checkout v1.0.2
- ›Embeds Kobold Lite directly in the server, accessible at
http://localhost:5001after runningllama_for_kobold.py [ggml_quant_model.bin] [port]. - ›Supports the new ggml model format while maintaining backward compatibility with the old ggml format and old tokenizer.
- ›Embeds Kobold Lite directly in the server, accessible at