Heads up This site is currently under heavy development.
← all tools
◆ Local LLM Runtimes

KoboldCpp

v1.120 open-source

Run GGUF models easily with a KoboldAI UI. One File. Zero Install.

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

Release history

  1. v1.120 Aug 29, 2026 · issue 011

    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 IT
    Load 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 --usedirectio flag to enable DirectIO model load mode, and allows mlock and mmap to 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.
  2. v1.119 Aug 16, 2026 · issue -003

    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 .kcppt quick-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.
  3. v1.119 Aug 16, 2026 · issue 002

    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 .kcppt template 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.
  4. v1.118.1 Aug 1, 2026 · issue -018

    KoboldCpp v1.118.1 adds image-gen abort support, multi-language Qwen3TTS, --jinjathink flag, 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 IT
    Enable Jinja templating automatically when using a thinking-capable model, without a separate Jinja flag.
    $ koboldcpp --model mymodel.gguf --jinjathink
    • New --jinjathink flag 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_disconnect request 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.
  5. v1.118.1 Aug 1, 2026 · issue 002

    KoboldCpp v1.118.1 adds image-gen abort support, multi-language Qwen3TTS, --jinjathink auto-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 IT
    Enable Jinja templating automatically when you want think-block support without separately passing a Jinja flag.
    $ ./koboldcpp-linux-x64 --model mymodel.gguf --jinjathink
    • Adds --jinjathink flag that automatically enables Jinja templating when set.
    • Adds keep_image_gen_on_disconnect request 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.
  6. v1.117.1 Jul 9, 2026 · issue -041

    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 11434 makes 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 row option for CUDA is removed in the next release; users must migrate to tensor split or layer split before upgrading beyond v1.117.1.
  7. v1.116.1 Jun 27, 2026 · issue -053

    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 IT
    Allow --onready commands 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-onready CLI flag, which re-enables --onready commands from config files when swapping .kcpps configs via API or Web UI; must be triggered directly from the terminal and cannot be saved.
    • Adds --failsafe CLI flag for macOS builds to use Accelerate only, bypassing Metal.
    • Adds response_format: mp3 support 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.
  8. v1.115.2 Jun 12, 2026 · issue -068

    KoboldCpp v1.115.2 adds Anthropic /v1/messages API, --sdvramlimit for 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 IT
    Cap 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/messages API, including multimodal and tool calling.
    • New --sdvramlimit flag limits VRAM usage for image and video generation by splitting the compute graph, enabling any image gen model to load on constrained hardware.
    • New --usemtp flag (and GUI toggle) enables Multi-Token Prediction drafting when built into the model; alternatively, pass a MTP drafter via --draftmodel.
    • New --reasoningeffort flag (and GUI toggle) sets the default reasoning effort, using --gendefaults under the hood to apply API defaults.
    • Use --debugmode to 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 --musicllm is 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.
  9. v1.114.1 May 30, 2026 · issue -081

    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 IT
    Host 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 X flag to enable experimental continuous batching, allowing X simultaneous text generation requests instead of queuing — useful for multi-user hosting or Horde deployments.
    • Adds --rpcmode (connect or host) and --rpctargets flags plus --rpcport (default 5551) 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 the thinking_enabled jinja kwarg.
    • Adds chat_template_kwargs field to the API for passing jinja kwargs objects directly via API calls.
    • Adds --sdtiledvae 1 flag (hotfix) to enable VAE tiling for video generation.
    +9 moreshow less
    • Adds --noswa flag 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 --noswa or uncheck the SWA checkbox in the GUI launcher to restore previous behavior.
  10. v1.113.2 May 16, 2026 · issue -095

    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 IT
    Run 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 rowsplit syntax).
    • Adds --reqtimeout flag to specify request timeouts for router mode and similar requests.
    • Adds --musiclowvram flag 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 rowsplit will no longer work.
  11. v1.112.2 Apr 20, 2026 · issue -121

    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 IT
    Cap 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_effort API field for thinking models, accepting values high, medium, low, minimal, or none; also settable via --gendefaults '{"reasoning_effort":"minimal"}' or in KoboldAI Lite under Settings > Tokens > Thinking > Reasoning Effort.
    • Adds --swapadding parameter to extend the SWA (Sliding Window Attention) context window by a specified number of tokens while keeping KV memory footprint small.
    • Adds --quantkv flag replacing the old single-digit values for KV cache quantization; supports f16, bf16, q8_0, q5_1, and q4_0 as named values (e.g. --quantkv q5_1).
    • Adds --baseconfig flag to pre-load a base config file on every model swap, merged with the target config; overridable via baseconfig parameter on the /api/admin/reload_config API endpoint.
    • Adds --jinjatemplate / --chat-template-file flags to replace a model's built-in Jinja template with a custom one.
    +6 moreshow less
    • Adds --image-min-tokens and --image-max-tokens flags 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/tokencount to 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 --quantkv values are deprecated; --quantkv now requires a named cache type string (f16, bf16, q8_0, q5_1, q4_0) — configs or scripts using numeric values must be updated.
  12. v1.111.2 Apr 3, 2026 · issue -138

    KoboldCpp v1.111.2 adds Gemma 4 and Qwen3 TTS voice design, /v1/responses API, 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 IT
    Run 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 --useswa flag to optionally enable Sliding Window Attention for Gemma 4, reducing VRAM usage significantly.
    • Adds --jinja flag support for Gemma 4 to enforce correct chat completions format and avoid bad outputs from wrong templates.
    • Adds --jinjatools flag to enable Jinja-based tool calling for broader model compatibility; falls back to universal tool calling when not set.
    • Adds --jinja-kwargs / --chat-template-kwargs flags (matching llama.cpp syntax) to pass Jinja chat template kwargs, e.g. --chat-template-kwargs '{"enable_thinking":false}'.
    • Adds --quantkv 3 option (also selectable in the GUI launcher) to enable BF16 KV cache type.
    +16 moreshow less
    • Adds --autoswap flag 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 --sdmaingpu flag allowing image generation models to be independently placed on any GPU.
    • Adds support for credentials supplied via environment variables KCPP_ADMINPASSWORD and KCPP_PASSWORD at launch.
    • Adds basic /v1/responses and /v1/messages compatibility API endpoints.
    • Adds encapsulate_thinking request field (set to false to disable) controlling whether detected thinking content is sent via reasoning_content in 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 .kcppt template 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_content instead of content in chat completions API responses. Set encapsulate_thinking to false in your request to restore the previous behavior.
  13. v1.110 Mar 19, 2026 · issue -153

    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 IT
    Enable 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 --routermode flag 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_model option 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 --routermode for automatic reload workflows.
    • Adds --ttsgpu toggle for Qwen3TTS GPU acceleration, with Vulkan speed improvements.
    • Extends --sdlora to 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.
  14. v1.109.2 Mar 3, 2026 · issue -168

    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 IT
    Generate 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/musicui when music model files are loaded.
    • Adds Qwen3-TTS support for high-quality voice cloning; specify a directory of .mp3 or .wav voice samples with --ttsdir to enable voice selection during TTS narration.
    • Adds support for importing SillyTavern JSONL exports.
    • Adds ComfyUI auth token support.
    +2 moreshow less
    • --admindir now 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.
  15. v1.108.2 Feb 18, 2026 · issue -180

    KoboldCpp v1.108.2 adds Ollama /api/show emulation, 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 IT
    Query 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/show endpoint emulation, extending API compatibility for tools that expect an Ollama-compatible server.
    • Autofit is now triggered when -1 gpulayers (the default) is selected and no tensor splits or tensor overrides are set; setting explicit GPU layers overrides this behavior.
    • --autofit mode 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.
  16. v1.107.3 Jan 31, 2026 · issue -198

    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 IT
    Store 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 --nopipelineparallel flag to disable pipeline parallel, which is now on by default in CLI.
    • Adds --noflashattention flag to disable flash attention, which is now on by default in CLI.
    • Adds --downloaddir option to specify where model downloads are stored when using URL references.
    • Adds --sdvaeauto flag to enable TAE SD support for Flux2.
    • Adds Vulkan (Older PC) GPU support in oldpc builds, 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 error as 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.
  17. v1.106.2 Jan 17, 2026 · issue -212

    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 IT
    Override 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 --device flag (e.g. --device Vulkan0,Vulkan1) to directly override selected GPU devices from the command line.
    • Adds GGML_VK_VISIBLE_DEVICES environment 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.json config format compatible with Claude Desktop.
    • Supports multiple simultaneous MCP servers, automatically combining their tools and dispatching requests appropriately.
    • Enables the continue_assistant_turn API 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.
  18. v1.105.4 Jan 2, 2026 · issue -227

    KoboldCpp v1.105.4 adds --gendefaults for 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 IT
    Force 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 --gendefaults flag, 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 --autofit to allocate extra space when multiple models are loaded simultaneously (e.g. image generation, embeddings).
    • Allows configuring the number of --smartcache slots (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
    • !--sdgendefaults has been deprecated and merged into --gendefaults; existing configurations using --sdgendefaults should be migrated to --gendefaults.
  19. v1.104 Dec 20, 2025 · issue -240

    KoboldCpp v1.104 adds --smartcache dynamic KV snapshotting, --autofit GPU 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 IT
    Speed 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 --smartcache flag: 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 --autofit flag: enables upstream llama.cpp automatic GPU layer fitting (-fit), overwriting manual layer configs and tensor overrides to find a better GPU fit automatically.
    • Adds --pipelineparallel flag to opt into pipeline parallelism on multi-GPU setups (previously the default); trades higher memory usage for faster speed.
    • Adds remove_limits payload/--sdgendefaults override to bypass the new cfg_scale cap 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 .kcpps config 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 --pipelineparallel to restore the previous behaviour.
    • !--forceversion flag 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.
  20. v1.103 Dec 4, 2025 · issue -256

    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 IT
    Use 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/completions endpoint (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.gguf with the Flux1 VAE and a Qwen3-4B text encoder as Clip 1; a .kcppt template 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.
  21. v1.102.3 Nov 26, 2025 · issue -264

    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 IT
    Use 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 --jinja flag to use jinja2 templates from GGUF in /v1/chat/completions for normal messages while retaining the KoboldCpp universal tool-calling module.
    • Adds --jinja_tools flag 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 --testmemory debug 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 mirostat sampler had tau and eta parameters swapped due to an old bug now fixed; to reproduce previous behavior, swap your configured values for tau and eta.
  22. v1.101.1 Nov 1, 2025 · issue -289

    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 IT
    Pass 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 --overridekv values split by commas in a single invocation.
    • Renames --blasbatchsize to --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/sdui by 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).
  23. v1.100.1 Oct 12, 2025 · issue -309

    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 IT
    Generate 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 --sdoffloadcpu flag to dynamically load/unload image generation weights to RAM when not in use (e.g. during VAE decoding).
    • Adds --sdvaecpu flag to perform VAE decoding on CPU using RAM instead of VRAM.
    • Adds --sdclipcpu flag to perform CLIP/T5 decoding on CPU (new default behavior).
    • Adds --sdgendefaults flag to set default image generation parameters.
    • Adds --lowvram flag (equivalent to -nkvo) to avoid offloading the KV cache, now usable in both CUDA and Vulkan (replaces the former lowvram CUDA-only option).
    +7 moreshow less
    • Renames --sdclipl to --sdclip1 and --sdclipg to --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 at http://localhost:5001/sdui.
    • Updates StableUI to support animations and video output, including Image-To-Video (I2V) via the txt2img panel.
    • Adds dry_penalty_last_n parameter 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 .embd resource 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
    • !--sdclipl is renamed to --sdclip1 and --sdclipg is renamed to --sdclip2; any launch scripts or configs using the old flag names will break.
    • !The lowvram CUDA option is moved to a new --lowvram flag; existing setups relying on the old CUDA-specific lowvram option must switch to the flag.
  24. v1.99.4 Sep 21, 2025 · issue -329

    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 IT
    Drop-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 --ratelimit flag for per-IP rate limiting to help prevent abuse of public instances.
    • Adds /v1/audio/voices API endpoint for listing available TTS voices.
    • Renames --promptlimit to --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 --promptlimit flag has been renamed to --genlimit; any scripts or configs using --promptlimit must be updated.
  25. v1.98.1 Aug 24, 2025 · issue -357

    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 IT
    Enable 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 --sdflashattention and --sdconvdirect flags to toggle flash attention and conv2d independently for image generation.
    • Extends --sdquant to accept a parameter [0/1/2] for three quantization levels (adds q8 support alongside existing q4) for image generation models.
    • Adds --overridenativecontext flag to override a model's expected trained context when computing automatic RoPE scaling.
    • Adds --embeddingsmaxctx flag to override the default embedding model max context (which now defaults to the lower of current model max context and trained context).
    • Adds 4096 as 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.sh script 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'.
  26. v1.97.4 Aug 6, 2025 · issue -363

    KoboldCpp v1.97.4 adds GLM4.5 and GPT-OSS model support, a --moecpu flag for CPU-bound MoE layers, and a /ping endpoint 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 IT
    Run 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 /ping stub 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.
  27. v1.96.2 Jul 17, 2025 · issue -364

    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 IT
    Ask 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 --usecublas flag to --usecuda (old name still accepted for backwards compatibility).
    • Emulates the OpenAI /v1/images/generations endpoint, enabling image-generation API calls against KoboldCpp.
    • Adds audio input support for multimodal models, enabling .wav, .mp3, and .flac files 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 .kcpps config 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.
  28. v1.95.1 Jun 29, 2025 · issue -365

    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 IT
    After 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 .kcppt template; accessible through StableUI at http://localhost:5001/sdui with 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.
  29. v1.94.2 Jun 21, 2025 · issue -365

    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 IT
    Limit 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 --sdphotomaker flag to load PhotoMaker for face cloning alongside any SDXL-based model, available in text2img, img2img, and inpaint modes via the SDUI at http://localhost:5001/sdui.
    • Adds --sdclampedsoft flag for soft total resolution clamping (e.g. a value of 640 allows 640x640, 512x768, and 768x512 images), combinable with the existing --sdclamped hard-clamp flag.
    • Adds --sdtiledvae flag to specify a resolution threshold beyond which VAE tiling is applied, replacing the previous --sdnotile.
    • Adds --embeddingsmaxctx flag to cap the max context length for embedding models, reducing memory usage.
    • Adds --embeddingsgpu flag to offload embedding model layers to GPU.
    +8 moreshow less
    • Adds --maingpu flag 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/image endpoint, 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
    • !--sdnotile is replaced by --sdtiledvae; setups using --sdnotile must switch to the new flag.
  30. v1.93.2 Jun 7, 2025 · issue -365

    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 --embeddingsmaxctx flag.

    └──▷ 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 IT
    Cap 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 --embeddingsmaxctx CLI option to control the maximum context size for the embeddings endpoint.
    • Adds --singleinstance flag awareness for Windows Shell integration: only instances started with this flag are replaced when a .gguf file is double-clicked to open in KoboldCpp.
    • Adds add_sd_step_limit adapter flag to cap the maximum number of steps in image generation.
    • Adds /api/extra/shutdown API endpoint (localhost-only) to power Windows Shell integration, allowing a running instance to be replaced when a new .gguf is launched.
    • Adds Windows Shell integration allowing .gguf files to be associated with KoboldCpp; double-clicking a .gguf opens 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-cuda1210 is renamed to koboldcpp-linux-x64; automated scripts using the old name will break when the old filename is removed.
    • !Linux binary koboldcpp-linux-x64-cuda1150 is renamed to koboldcpp-linux-x64-oldpc; automated scripts using the old name will break when the old filename is removed.
    • !Windows binary koboldcpp_cu12.exe is renamed to koboldcpp.exe; automated scripts using the old name will break when the old filename is removed.
    • !Windows binary koboldcpp_oldcpu.exe is renamed to koboldcpp-oldpc.exe; automated scripts using the old name will break when the old filename is removed.
    • !Windows binary koboldcpp_nocuda.exe is renamed to koboldcpp-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.
  31. v1.92.1 May 24, 2025 · issue -366

    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 IT
    Run 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 a dPaste.org-hosted link.
    • Adds --useswa flag 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 --showgui automatically when --skiplauncher is 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 via Save/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 (.charx archive 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.cmd for 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_skip value 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.
  32. v1.91 May 10, 2025 · issue -366

    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 IT
    Enable 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 --enableguidance flag (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
    • !KoboldCppAuto replaces 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.
  33. v1.90.2 Apr 29, 2025 · issue -367

    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 IT
    Run 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 --mmprojcpu flag to load and run the multimodal projector on CPU while keeping the main model on GPU.
    • Adds --blasbatchsize -1 mode that exclusively uses a batch size of 1 when processing prompts; also formally permits --blasbatchsize 16 to 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 grammar field, 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 --nobostoken triggering when model metadata explicitly indicates no BOS token.
    • Adds functioning Pixtral vision model support; note Pixtral is token-heavy (~4000 tokens per 1024px image); --contextsize or --visionmaxres can 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
    • !--onready shell commands can no longer be embedded into a .kcppt or .kcpps file; 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.
  34. v1.89 Apr 21, 2025 · issue -367

    KoboldCpp v1.89 adds NoScript chat/image gen, new --overridekv/--overridetensors flags, 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 IT
    Force 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 --overridekv launcher flag to overwrite a single model metadata property at runtime; input format is keyname=type:value.
    • Adds --overridetensors launcher flag to place tensors matching a pattern onto a specific backend; input format is tensornamepattern=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 /noscript now 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.
  35. v1.88 Apr 13, 2025 · issue -367

    KoboldCpp v1.88 adds image inpainting, a JSON-to-GBNF grammar endpoint, --maxrequestsize flag, 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 IT
    Limit 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 --maxrequestsize flag 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_grammar to 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 vulkaninfo when nvidia-smi is 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.
  36. v1.87.4 Apr 1, 2025 · issue -367

    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 IT
    Encode 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 --embeddingsmodel flag to load GGUF embedding models, exposed via /v1/embeddings and /api/extra/embeddings for text encoding into vector databases.
    • Adds --cli flag to run KoboldCpp in a fully headless terminal chat mode, with no GUI required.
    • Adds --quantkv support 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_prompt in 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.
  37. v1.86.2 Mar 14, 2025 · issue -368

    KoboldCpp v1.86.2 adds Gemma3 vision support, quantized KV with context shift, and new CLI flags --defaultgenamt and --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 IT
    Cap 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 --defaultgenamt option 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 --nobostoken option 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 KoboldCppAutomatic in 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 .kcpps configs, 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.
  38. v1.85.1 Mar 1, 2025 · issue -368

    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 IT
    Host 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 .kcpps file 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 --password to require an API key for save/load access.
    • Adds --exportconfig and --exporttemplate CLI flags to export any set of launch arguments as a .kcpps or .kcppt config 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.
  39. v1.84.2 Feb 15, 2025 · issue -369

    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 IT
    Download 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 aria2c and wget as 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.
  40. v1.83.1 Feb 8, 2025 · issue -369

    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 IT
    Enable 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 --admin flag to enable runtime model, settings, and config switching (including remote model swapping) via a new Admin panel in Kobold Lite.
    • Adds --admindir flag pointing to a directory of .kcpps launch configs, allowing hot-swap between different models, layers, and backends without restarting manually.
    • Adds --adminpassword flag to password-protect the admin panel and remote model-swap functions.
    • Adds --visionmaxres flag to cap the maximum resolution accepted by vision mmprojs; images exceeding the limit are automatically downscaled before processing.
    • Adds --ttsmaxlen flag 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'.
  41. v1.82.4 Jan 18, 2025 · issue -370

    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 IT
    Run 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; --ttsgpu offloads models to GPU and --ttsthreads sets a custom thread count.
    • Adds --analyze CLI flag (also in the GUI Extras tab) to inspect any GGUF file, displaying metadata, tensor names, dimensions, and types.
    • Adds --sdnotile flag to disable VAE tiling for image generation, eliminating bleeding graphical artifacts on some GPUs.
    • Adds --usemmap flag to opt in to memory-mapped loading; mmap is 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 --sdvaeauto or '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, MultimodalVision and APIs such as OpenAiSpeechApi, XttsApi, WhisperTranscribeApi.
    • CLBlast (Older CPU) build no longer requires AVX, extending GPU-assisted inference to very old or low-cost systems.
    └──▷ BREAKING ON UPGRADE
    • !mmap is no longer enabled by default; existing setups relying on memory-mapped model loading must now explicitly pass --usemmap or enable it in the GUI.
  42. v1.81.1 Jan 4, 2025 · issue -370

    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 IT
    Start 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 --websearch CLI 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/websearch endpoint 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 bare make was 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.
  43. v1.80.3 Dec 20, 2024 · issue -371

    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 IT
    Offload 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 --moeexperts flag to overwrite the number of experts used in MoE models.
    • Adds --failsafe flag to explicitly disable all CPU intrinsics and GPU usage.
    • Adds --draftgpulayers flag to set the number of layers offloaded for a speculative decoding draft model.
    • Adds --draftgpusplit flag to set GPU layer distribution ratio for the draft model across multiple GPUs (defaults to same as main model).
    • Adds suppress_non_speech field to the Whisper API, enabling suppression of noise annotation logits (e.g. barking, doorbell, chime, muzak).
    +11 moreshow less
    • Adds q as a URL query alias for query in Kobold Lite (e.g. http://localhost:5001?q=what+is+love).
    • MMQ is now the default for CLI; use the nommq flag 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_stop now defaults to true; setups that expected stop sequences to appear in output will no longer receive them without explicitly setting trim_stop to false.
    • !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.
  44. v1.79.1 Nov 30, 2024 · issue -372

    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 IT
    Host 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 --multiplayer flag (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/setstory endpoints for live story sync across multiple users and devices.
    • Adds Ollama-compatible endpoints /api/chat and /api/generate for basic Ollama API emulation, letting third-party tools that only speak Ollama point to KoboldCpp at http://localhost:5001 (or port 11434 for stricter tools); streaming is not supported.
    • Adds ComfyUI emulation via a new /prompt endpoint, supporting txt2img for tools that require ComfyUI API but lack A1111 API support.
    • Adds /api/extra/detokenize endpoint, which converts an array of token IDs into a detokenized string.
    • Adds /props endpoint 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.
  45. v1.78 Nov 16, 2024 · issue -372

    KoboldCpp v1.78 adds Flux and SD 3.5 image generation, new --nofastforward flag, and a /.well-known/serviceinfo identity 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 IT
    Load 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 --sdclipg CLI flags to load individual T5XXL, CLIP-L, and CLIP-G components for Flux and SD 3.5 image generation (supports URL resources).
    • Adds --nofastforward flag to force full prompt reprocessing on every request, enabling more repeatable and consistent inference results.
    • Adds /.well-known/serviceinfo common 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.
  46. v1.77 Nov 1, 2024 · issue -372

    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 IT
    Retrieve 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_logprobs endpoint for retrieving token probabilities after both streaming and non-streaming responses.
    • Response fields prompt_tokens, completion_tokens, and total_tokens now 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.
  47. v1.76 Oct 11, 2024 · issue -373

    KoboldCpp v1.76 adds Anti-Slop phrase banning via banned_strings and 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 IT
    Block 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_strings field: 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.
  48. v1.75.2 Sep 21, 2024 · issue -374

    KoboldCpp v1.75.2 auto-selects GPU backends by default, adds RWKV v6 support, new --showgui flag, 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 IT
    Launch 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 onto koboldcpp.exe now launches with GPU and gpulayers auto-configured.
    • New --showgui flag 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 .kcpps config files.
    • OpenBLAS backend removed and unified with NoBLAS into a single CPU mode; use --usecpu to enable CPU mode (the --noblas flag 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; --noblas is 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.
  49. v1.74 Aug 31, 2024 · issue -375

    KoboldCpp v1.74 adds XTC sampler, a --nomodel flag 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 IT
    Launch 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 --nomodel flag to launch the Lite WebUI without loading a local model, enabling selection of external API providers such as Horde, Gemini, or OpenAI.
    • Adds xtc_probability and xtc_threshold sampling parameters for the new XTC (Exclude Top Choices) creative-writing sampler; recommended starting values are xtc_threshold=0.15 and xtc_probability=0.5.
    • Horde Worker now supports connecting to SSL-secured KoboldCpp instances (use --nocertify for 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 -1 is passed to gpulayers.
    +1 moreshow less
    • Adds support for the Llama-3.1-Minitron-4B-Width model architecture.
  50. v1.73.1 Aug 19, 2024 · issue -375

    KoboldCpp v1.73.1 adds IPv6 dual-stack support, macOS ARM binaries, and a new --prompt pure 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 IT
    Run 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 --prompt flag 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 --promptlimit flag to control output length when using --prompt CLI mode.
    • Combines --prompt and --promptlimit with --benchmark to enable benchmarking with a custom prompt and capturing the response.
    • --multiuser now defaults to true; set --multiuser 0 to 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
    • !--multiuser now defaults to true; existing setups that relied on multi-user mode being disabled by default must explicitly set --multiuser 0.
  51. v1.72 Aug 2, 2024 · issue -375

    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 -1 in 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.
  52. v1.71.1 Jul 25, 2024 · issue -376

    KoboldCpp v1.71.1 adds shareable .kcppt launch templates, automatic GPU layer guessing via --gpulayers -1, and Vulkan iq4_nl format 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 IT
    Load 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 -1 to let KoboldCpp automatically estimate how many GPU layers to offload (experimental).
    • Adds KoboldCpp Launch Templates: shareable .kcppt files 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_nl quantization 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.
  53. v1.70.1 Jul 15, 2024 · issue -376

    KoboldCpp v1.70.1 adds Corpo Mode UI, DRY sampler, --unpack self-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 IT
    Use 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 --unpack flag enabling self-extraction of KoboldCpp PyInstaller binaries into an empty directory for easy file access and modification; also usable from the GUI launcher.
    • Adds --chatcompletionsadapter selection by bundled template filename (e.g. Llama-3.json), allowing pre-bundled chat completion templates to be referenced without a full path.
    • Raises default --contextsize from 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.exe for 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.
  54. v1.69.1 Jul 1, 2024 · issue -376

    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 IT
    Inject a forced positive and negative prompt for every Stable Diffusion generation request via an adapter config.
    yaml
    add_sd_prompt: "masterpiece, best quality"
    add_sd_negative_prompt: "blurry, low quality, nsfw"
    • Adds add_sd_prompt and add_sd_negative_prompt fields 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.
  55. v1.68 Jun 19, 2024 · issue -377

    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 IT
    Count 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: false parameter to the /api/extra/tokencount tokenize 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; --usevulkan now 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.
  56. v1.67 Jun 4, 2024 · issue -377

    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 IT
    Reduce 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, where level is 0=f16, 1=q8, or 2=q4; requires --flashattention and disables Context Shifting automatically.
    • Adds /api/extra/transcribe endpoint for speech-to-text transcription, accepting payloads as .wav files (max 32 MB) or base64-encoded WAV data.
    • Adds /v1/audio/transcriptions as an OpenAI-compatible drop-in transcription endpoint, also accepting .wav or 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.
  57. v1.66 May 24, 2024 · issue -378

    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 IT
    Apply 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 --sdlora flag to specify a custom Stable Diffusion LoRA file, and --sdloramult to 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 --sdvaeauto flag.
    • Supports passing an http/https URL to a GGUF file via the --model parameter 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.
  58. v1.65 May 11, 2024 · issue -378

    KoboldCpp v1.65 adds a standalone Stable Diffusion UI, CUDA 12 binaries, a new bypass_eos API 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 IT
    Run 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 --sdclamped flags to replace the deprecated --sdconfig, enabling per-parameter validation and easier extension of Stable Diffusion options.
    • Adds --hordemodelname, --hordeworkername, --hordekey, --hordemaxctx, and --hordegenlen flags to replace the deprecated --hordeconfig, giving each AI Horde setting its own named flag.
    • Adds bypass_eos field 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 --sdconfig flags 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).
  59. v1.64.1 May 1, 2024 · issue -378

    KoboldCpp v1.64.1 adds --flashattention, dynamic banned_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 IT
    Enable 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 --bantokens flag.
    $ 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 --flashattention experimental flag to enable Flash Attention for compatible models.
    • Adds banned_tokens field to the generate API, allowing per-generation token banning dynamically (replaces the removed --bantokens flag).
    • Adds render_special to the generate API, enabling rendering of special tokens such as <|start_header_id|> or <|eot_id|>.
    • Adds trim_stop support in SSE streaming modes so stop sequences are hidden during streaming when enabled; Chat Completions endpoint automatically applies trim_stop to instruct tag format for better compatibility with third-party clients like LibreChat.
    • Adds finish_reason communication 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; --benchmark now 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 --bantokens flag has been removed; token banning must now be submitted dynamically via the banned_tokens field in the generate API.
  60. v1.63 Apr 20, 2024 · issue -379

    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 IT
    Run 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 --contextsize is 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.
  61. v1.62.2 Apr 9, 2024 · issue -379

    KoboldCpp v1.62.2 adds Img2Img via /sdapi/v1/img2img, a --chatcompletionsadapter flag, 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 IT
    Load 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 --chatcompletionsadapter CLI 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/img2img endpoint, enabling image-to-image generation directly from KoboldCpp.
    • Expands /api/extra/perf/ with additional usage statistics.
    • Adds /docs endpoint 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.
  62. v1.61.2 Mar 13, 2024 · issue -380

    KoboldCpp v1.61.2 adds multimodal vision via --mmproj, API key auth via --password, mamba model support, and a new --ignoremissing flag.

    └──▷ 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 IT
    Enable 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 --mmproj flag 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 --password flag to require Bearer token authentication on all text generation endpoints; image endpoints remain unsecured.
    • Adds --ignoremissing flag to silently skip optional missing files passed via flags like --lora or --mmproj instead of exiting.
    • Adds clamped option for --sdconfig to 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 images in the submit payload.
    +7 moreshow less
    • Emulates an A1111-compatible /sdapi/v1/interrogate endpoint 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 --benchmark context 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.
  63. v1.60.1 Mar 4, 2024 · issue -380

    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 IT
    Run 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 --sdconfig CLI flag to load a compatible SD1.5 or SDXL .safetensors fp16 image model, enabling native local image generation via stable-diffusion.cpp with an A1111-compatible txt2img endpoint usable from Kobold Lite, SillyTavern, and other compatible frontends.
    • Adds --remotetunnel flag 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.
  64. v1.59.1 Feb 25, 2024 · issue -381

    KoboldCpp v1.59.1 adds --nocertify mode for Horde workers, Old CPU Vulkan build target, and IQ3_S quantization 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 IT
    Run a Horde worker on a network where SSL certificate validation fails, bypassing the error to stay connected.
    $ koboldcpp.exe --model mymodel.gguf --nocertify
    • Adds --nocertify flag 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_S quantization format support (merged in the 1.59.1 fix build).
    • Adds Google Gemma model support via upstream merges.
  65. v1.58 Feb 17, 2024 · issue -381

    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 IT
    Run 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 rowsplit option to --usecublas for 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 rowsplit to --usecublas.
  66. v1.57.1 Feb 8, 2024 · issue -381

    KoboldCpp v1.57.1 adds --benchmark CSV output, Vulkan multi-GPU via --usevulkan, and smoothing_factor sampling.

    └──▷ 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 IT
    Spread 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 --benchmark flag 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_split flag (CLI only — GUI launcher does not support multiple Vulkan devices).
    • Adds temperature Quad-Sampling via the smoothing_factor API parameter, also configurable in the Kobold Lite dynamic temperature panel.
    • Adds --debugmode timing 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.
  67. v1.56 Jan 27, 2024 · issue -382

    KoboldCpp v1.56 adds Vulkan GPU backend, XTTS text-to-speech, and dynatemp_exponent API 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 IT
    Run 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_exponent parameter (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.
  68. v1.55.1 Jan 10, 2024 · issue -382

    KoboldCpp v1.55.1 adds Dynamic Temperature sampling with dynatemp_range control 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 IT
    Use 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_range parameter enabling Dynamic Temperature (DynaTemp) sampling, where the actual temperature is automatically adjusted between temperature ± dynatemp_range at inference time (e.g., temperature=0.4 and dynatemp_range=0.1 yields a 0.3–0.5 range).
    • Exposes the most recently used seed in the /perf endpoint, 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.
  69. v1.54 Jan 1, 2024 · issue -382

    KoboldCpp v1.54 adds logit_bias support 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 IT
    Bias 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_bias parameter 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 stepcount and cfgscale settings for Horde/A1111 image generation in Lite.
    • Adds mouseover tooltips for all labels in the GUI launcher.
    • Includes a prebuilt no-CUDA Linux binary.
  70. v1.53 Dec 23, 2023 · issue -383

    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 IT
    Serve 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_pen is not explicitly set, rep_pen now 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_pen is not set, rep_pen now defaults to 1.0 instead of 1.1 — any workflow relying on the old implicit 1.1 default will produce different outputs.
  71. v1.52.2 Dec 13, 2023 · issue -383

    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 IT
    Run 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 lowvram flag (equivalent to -nkvo in 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/tokencount endpoint 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/perf endpoint for monitoring embedded Horde Worker health.
    +5 moreshow less
    • Merges support for QWEN and Mixtral model architectures from upstream; --noblas or --blasbatchsize -1 can mitigate slow batch prompt processing on Mixtral.
    • Selecting a .kcpps config 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 lowvram to restore the old behaviour.
  72. v1.51.1 Dec 1, 2023 · issue -383

    KoboldCpp v1.51.1 adds --quiet console suppression and extends --multiuser with 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 IT
    Run 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 --quiet flag to suppress all input and output from appearing in the console.
    • Extends --multiuser with 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 --remotetunnel is in use.
    • Allocates ~80 tokens of reserved KV cache space on top of the specified --contextsize (e.g. --contextsize 2048 allocates 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.
  73. v1.50.1 Nov 18, 2023 · issue -384

    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/completions endpoint (tested working with SillyTavern).
    • Extends /v1/completions with 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.
  74. v1.49 Nov 11, 2023 · issue -384

    KoboldCpp v1.49 adds Split Memory, trim_stop, and --preloadstory API 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 IT
    Guarantee 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 memory field to the /v1/generate API payload: forcefully prepends a string to any submitted prompt, and if the context limit is exceeded, overwrites from the beginning of the main prompt to make room — guaranteeing full memory insertion without needing exact token counts.
    • Adds trim_stop boolean field to the generate API payload: when true, strips detected stop sequences from the output and truncates everything after them (note: incompatible with SSE streaming).
    • Adds --preloadstory CLI flag to specify a JSON story savefile at server launch, hosting it at the /api/extra/preloadstory endpoint for frontends to consume over the API.
    • Adds LLAMA_PORTABLE=1 makefile 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.
  75. v1.48.1 Nov 4, 2023 · issue -384

    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 IT
    Run 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 --noshift flag 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 --remotetunnel flag, 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 clinfo and nvidia-smi queries, 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_train when 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.
  76. v1.47.2 Oct 20, 2023 · issue -385

    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 IT
    Enable 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_split configuration, 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.
  77. v1.46.1 Oct 8, 2023 · issue -385

    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 IT
    Run 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 --contextsize support 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.
    • .kcpps config 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/koboldcpp to koboldcpp/[model_filename].
    └──▷ BREAKING ON UPGRADE
    • !The --psutil_set_threads command-line argument has been removed.
    • !The --stream command-line argument has been removed; streaming is now a toggle saved inside Kobold Lite's settings.
    • !The --unbantokens command-line argument has been removed; EOS unbans must now be set via the generate API using the use_default_badwordsids JSON field.
    • !The --usemirostat command-line argument has been removed; Mirostat values must now be set via the generate API using the mirostat, mirostat_tau, and mirostat_eta JSON fields.
    • !The original tkinter GUI has been removed; only the customtkinter GUI remains.
    • !The default model name is changed from concedo/koboldcpp to koboldcpp/[model_filename], which breaks connections from old KoboldAI-Client users connecting via the Kobold API.
  78. v1.45.2 Oct 1, 2023 · issue -385

    KoboldCpp v1.45.2 adds OpenAI-compatible /v1/completions, grammar state persistence, 32k context, and a new --foreground flag.

    └──▷ 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 IT
    Send 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_state parameter to the grammar sampler API, allowing grammar state to persist across multiple requests.
    • Adds --foreground flag for Windows users to bring the console terminal to the foreground on each prompt generation, avoiding idle slowdown.
    • Increases maximum supported context via --contextsize to 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 .kcpps settings file via the file selector GUI combined with --skiplauncher (the settings file must already have a model selected).
    +5 moreshow less
    • Increases stop_sequence limit to 16.
    • Upgrades Lite polled-streaming to work in multiuser mode by issuing a unique key per request.
    • Enhances Remote-Link.cmd to 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_threads argument is deprecated and will be removed in a future version.
    • !The --stream argument is deprecated and will be removed; streaming is now a toggle saved inside Lite's settings.
    • !The --unbantokens argument is deprecated and will be removed; EOS unbans must now be set via the generate API using the use_default_badwordsids JSON field.
    • !The --usemirostat argument is deprecated and will be removed; Mirostat values must now be set via the generate API using the mirostat, mirostat_tau, and mirostat_eta JSON fields.
    • !The OpenAI completions endpoint moved from /api/extra/oai/v1/completions to /v1/completions.
  79. v1.44.2 Sep 20, 2023 · issue -386

    KoboldCpp v1.44.2 adds multi-user queuing, --onready hooks, 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 IT
    Run 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 --multiuser flag enabling up to 5 concurrent incoming /generate requests to be queued and processed in sequence instead of being rejected while busy.
    • Adds --onready launcher 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_length API 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; --stream flag 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.
  80. v1.43 Sep 7, 2023 · issue -386

    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 --ropeconfig is not explicitly set; --ropeconfig overrides this behavior.
    • Tweaks --unbantokens to push banned token logit values further down, reducing rare appearances while avoiding -inf to preserve sampling compatibility.
    • Adds support for older GGML format (ggjt_v3) for 34B LLaMA 2 models (note: may have issues when n_gqa is 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.
  81. v1.42.1 Aug 30, 2023 · issue -387

    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 --unbantokens CLI 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.
  82. v1.41 Aug 24, 2023 · issue -387

    KoboldCpp v1.41 adds GGUF model support, a --config flag for settings files, and a new /api/extra/tokencount endpoint.

    └──▷ 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 IT
    Launch KoboldCpp with a saved settings profile instead of re-specifying every flag each run.
    $ koboldcpp.exe --config mymodel.kcpps
    • Adds --config flag to load a .kcpps settings file at launch from the command line; .kcpps files can also be imported and exported from the GUI.
    • Adds new /api/extra/tokencount endpoint to tokenize any string and accurately measure its token count.
    • Supports LLAMA GGUF model format, detected and handled automatically alongside all existing model formats.
  83. v1.40.1a Aug 9, 2023 · issue -387

    KoboldCpp v1.40.1a adds an idle field to /api/extra/perf and 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 IT
    Poll whether KoboldCpp is currently busy generating before submitting a new request, avoiding queuing conflicts.
    $ curl http://localhost:5001/api/extra/perf
    • Adds idle field to the GET /api/extra/perf endpoint, 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.
  84. v1.39.1 Aug 7, 2023 · issue -387

    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 IT
    Run inference with a very large batch size when VRAM allows, to maximize throughput.
    $ koboldcpp.exe --model <model_path> --blasbatchsize 2048
    • Adds experimental --blasbatchsize 2048 support (note: buffers are doubled, consuming significantly more memory).
    • Adds --contextsize options 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.
  85. v1.38 Aug 2, 2023 · issue -387

    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 IT
    Run a Q4_0 model with MMQ prompt processing on CUDA to reduce VRAM usage and speed up inference.
    $ koboldcpp.exe --model <model_path> --usecublas mmq
    • Adds --usecublas mmq flag (also togglable in GUI) to enable Quantized MatMul (MMQ) prompt processing on CUDA, reducing memory usage and improving speed for Q4_0 models.
    • Displays a terminal warning when received context exceeds the max launcher-allocated context.
    • Adds a Help button in the GUI.
    └──▷ BREAKING ON UPGRADE
    • !--noavx2 mode no longer uses OpenBLAS, now behaving the same as Failsafe mode.
  86. v1.37.1a Jul 24, 2023 · issue -388

    KoboldCpp v1.37.1 adds an embedded Horde Worker, LLAMA2 70B support, and exposes --tensor_split for 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 IT
    Share 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 --hordeconfig to 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_split for splitting model layers across multiple CUDA GPUs, matching upstream behavior.
    • Retains --blasbatchsize 1024 support 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/perf response, 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.
  87. v1.36 Jul 20, 2023 · issue -388

    KoboldCpp v1.36 replaces --linearrope with --ropeconfig for 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 IT
    Run 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 --linearrope flag — e.g. --ropeconfig 0.5 10000 for 2x linear scale or --ropeconfig 1.0 10000 for native LLAMA2 4K tuning.
    • Exposes additional token counter data through the API endpoint /api/extra/perf.
    • Automatically configures long-context NTK-Aware RoPE based on the --contextsize parameter by default, with no manual tuning required.
    • Adds --ropeconfig support 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 --linearrope flag has been removed; replace it with --ropeconfig <scale> <base> (e.g. --ropeconfig 0.5 10000 for equivalent 2x linear scaling).
  88. v1.35 Jul 12, 2023 · issue -388

    KoboldCpp v1.35 adds CUDA 8-bit MMV acceleration, a new /api/extra/perf endpoint, and --linearrope context 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 IT
    Run 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 --linearrope launch parameter to enable linear RoPE scaling (using 2048 as base) as an alternative to NTK-Aware RoPE; combine with --contextsize 8192 for a 0.25 linear 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, and q5_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.
  89. v1.34.2 Jul 7, 2023 · issue -388

    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 IT
    Block 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 /generate API 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 --bantokens CLI flag to block a list of token substrings from being generated — e.g. --bantokens [ a ooo bans 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_order and mirostat/tau/eta parameters to the /generate API, settable per-generation request.
    • Switches RoPE scaling to NTK-aware method driven by the existing --contextsize parameter, 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-based GUI with more configurable settings; requires the customtkinter Python module on Linux and macOS (bundled in Windows .exe builds).
    • Kobold Lite now displays submitted contexts after each generation and adds two new scenarios plus limited Tavern v2 card support.
  90. v1.33 Jun 29, 2023 · issue -389

    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 IT
    Run 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 --usecublas flag to select CUDA inference mode, with --usecublas lowvram for low-VRAM operation, alongside --useclblast for CLBlast — all available in a single All-In-One distributable.
    • Adds --contextsize flag 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.
  91. v1.32.3 Jun 22, 2023 · issue -389

    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.
  92. v1.31.2 Jun 17, 2023 · issue -389

    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 IT
    Enable verbose server endpoint logging during development without exposing horde prompt content in shared environments.
    $ koboldcpp --debugmode --hordeconfig <api_key> <worker_name>
    • Adds --hordeconfig support 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 --hordeconfig is set unless --debugmode is 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.
  93. v1.30.3 Jun 13, 2023 · issue -389

    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 IT
    Abort 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/check to fetch in-progress results without disrupting generation; the old 8-token chunked streaming remains available via streamamount=8 in the URL.
    • Adds an abort endpoint at /api/extra/abort that 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.
  94. v1.29 Jun 7, 2023 · issue -389

    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.
  95. v1.28 Jun 4, 2023 · issue -389

    KoboldCpp v1.28 adds MPT model support, a new --hordeconfig flag, and --blasbatchsize -1 to 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 IT
    Register 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 --renamemodel to --hordeconfig, which now accepts two parameters: the horde display name and the advertised max generation length on horde.
    • Adds --blasbatchsize -1 to 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 --contextsize to 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 --renamemodel flag has been renamed to --hordeconfig; any scripts or configs using --renamemodel will break on upgrade.
  96. v1.27 Jun 1, 2023 · issue -389

    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 IT
    Override the model name reported to the Horde network so it appears under a custom identifier.
    $ koboldcpp.exe --renamemodel mymodel
    • Adds --renamemodel CLI flag to override the displayed model name (prefixed with koboldcpp/), 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.
  97. v1.26b May 27, 2023 · issue -390

    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 IT
    Inspect 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 --debugmode display of input/context contents and their token IDs (note: slight performance hit; off by default).
    • Adds --unbantokens flag 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 0 to disable).
    • Adds support for Starcoder and Starcoder Chat models.
  98. v1.25.1 May 24, 2023 · issue -390

    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 IT
    Run 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 /generate API 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 --nommap flags, disabling all CPU intrinsics (AVX, SSE) to run on ancient hardware including Windows 7.
    • Adds sampler_seed parameter support to the /generate API 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 --debugmode console 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.
  99. v1.24 May 21, 2023 · issue -390

    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, and q8_0 quantization 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.
  100. v1.23.1 May 17, 2023 · issue -390

    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 IT
    Offload 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 --useclblast combined 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.
  101. v1.20 May 8, 2023 · issue -390

    KoboldCpp v1.20 adds --contextsize flag for large contexts and --forceversion for 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 IT
    Run a large-context model that exceeds the default 2048-token limit.
    $ koboldcpp.exe --contextsize 4096 my_model.bin
    • Adds --contextsize flag to allocate additional RAM and support context sizes beyond 2048 tokens.
    • Adds --forceversion flag to manually override model version detection when automatic RedPajama identification fails.
    • Adds experimental support for RedPajama variants of GPT-NeoX models.
  102. v1.19 May 6, 2023 · issue -390

    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 IT
    Enable 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.1 for mirostat type 2.
    • Adds --forceversion [ver] flag to override automatic model file format detection when it fails, e.g. 401 for GPTNeoX-Type2.
    • Adds --blasthreads flag to set a separate thread count when CLBlast is active, defaulting to the value of --threads if not specified.
    • Expands RWKV support to include all new RWKV quantizations, with q5_1 delivering significantly faster inference than fp16 at similar quality.
    • Includes an experimental Windows 7-compatible .exe build for this release.
    └──▷ BREAKING ON UPGRADE
    • !RWKV Q4_1_O quantization is no longer supported following the upstream change.
  103. v1.18 May 2, 2023 · issue -390

    KoboldCpp v1.18 adds group chat conversations, --highpriority CPU boost flag, and --usemlock RAM-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 IT
    Speed 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 --highpriority CLI flag to raise the process CPU priority, potentially reducing generation latency.
    • Adds --usemlock CLI 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.
  104. v1.17 May 1, 2023 · issue -390

    KoboldCpp v1.17 adds --unbantokens flag 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 IT
    Run KoboldCpp with token unbanning enabled to support newer Pygmalion models that require EOS suppression.
    $ koboldcpp.exe --unbantokens
    • Adds --unbantokens CLI 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.
  105. v1.16 Apr 30, 2023 · issue -391

    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_0 and q5_1 quantization 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_3 format; users are strongly advised to switch away from q4_3 and reconvert any existing q4_3 models.
  106. v1.15 Apr 28, 2023 · issue -391

    KoboldCpp v1.15 adds an Easy Mode GUI, --debugmode flag, 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 IT
    Inspect 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 --skiplauncher flag to bypass the new Easy Mode GUI and proceed directly to CLI operation.
    • Adds --debugmode flag to print the tokenized prompt sent to the backend in the terminal window.
    • Setting --stream now automatically redirects the embedded Kobold Lite UI to streaming mode, removing the need to manually append ?streaming=1 to 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.
  107. v1.14 Apr 26, 2023 · issue -391

    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 --noavx2 flag.
    • Supports GPU acceleration via CLBlast with the --useclblast flag.
    • Supports --smartcontext flag to reduce prompt processing frequency for large contexts.
  108. v1.13.1 Apr 24, 2023 · issue -391

    KoboldCpp v1.13.1 adds --unbantokens flag 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 IT
    Allow 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 --unbantokens CLI flag to allow previously banned tokens such as EOS and Square Brackets to be generated.
    • Adds CLBlast dequantization support for q4_2 and q4_3 quantization formats, enabling GPU-accelerated inference for models using those formats.
    • Adds quantization handling for GPT-NeoX, GPT-2, and GPT-J model architectures.
    • Makes mmap automatic when a LoRA adapter is selected.
  109. v1.11 Apr 22, 2023 · issue -391

    KoboldCpp v1.11 adds GPT-NeoX/Pythia/StableLM support, --lora for 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 IT
    Build 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 --lora parameter 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.
  110. v1.10 Apr 18, 2023 · issue -391

    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 IT
    Start 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 --launch CLI flag to automatically open the browser on startup (combinable with existing flags, e.g. --stream --launch).
    • New /api/extra/version endpoint returns the running KoboldCpp version number.
    • Adds native RWKV model support with no external dependencies — no PyTorch or tokenizers libraries required.
  111. v1.9 Apr 16, 2023 · issue -391

    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.
  112. v1.8.1 Apr 16, 2023 · issue -391

    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.
  113. v1.7 Apr 14, 2023 · issue -391

    KoboldCpp v1.7 adds --smartcontext to 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 IT
    Run 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 --smartcontext flag, a prompt context manipulation mode that avoids frequent context recalculation when the context window is full.
    • Adds --noavx2 flag to enable a non-AVX2 execution path, now bundled in the same .exe.
  114. v1.6 Apr 13, 2023 · issue -391

    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 IT
    Run 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 --noavx2 flag — no separate download needed on older hardware.
  115. v1.5 Apr 12, 2023 · issue -391

    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 IT
    Enable 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 --noavx2 flag 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.zip for converting fp16 models to quantized format.
  116. v1.4 Apr 10, 2023 · issue -391

    KoboldCpp v1.4 makes mmap the default and adds --nommap to 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 IT
    Run KoboldCpp without memory-mapped loading to restore the pre-v1.4 default behavior.
    $ koboldcpp.exe --nommap <model_path>
    • Adds --nommap flag 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 --nommap to preserve previous behavior.
  117. v1.3 Apr 10, 2023 · issue -391

    KoboldCpp v1.3 adds --usemmap flag, 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 IT
    Re-enable memory-mapped file loading on a system where mmap improves load times, overriding the new default.
    $ koboldcpp.exe --usemmap ggml_model.bin
    • Adds --usemmap flag 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 --usemmap to restore it.
  118. v1.2 Apr 8, 2023 · issue -391

    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.
  119. v1.0.9beta Apr 5, 2023 · issue -391

    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.
  120. v1.0.8beta Apr 3, 2023 · issue -391

    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 IT
    Override 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 -O3 to -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.
  121. v1.0.7 Apr 1, 2023 · issue -391

    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 IT
    Run KoboldCpp with streaming enabled after the default changed to non-streaming.
    $ llamacpp-for-kobold.exe --stream
    • Adds --stream flag 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 --stream to restore it.
  122. v1.0.6beta Mar 29, 2023 · issue -392

    KoboldCpp v1.0.6beta adds OpenBLAS acceleration and a --noblas flag, 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 IT
    Run 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 --noblas flag to disable OpenBLAS acceleration at runtime.
    • Adds --help flag 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.
  123. v1.0.5 Mar 25, 2023 · issue -392

    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 /api softprompts endpoint, enabling softprompt injection via the KoboldAI-compatible API at http://localhost:5001.
    • Adds support for selecting KV cache data type, defaulting to f32 instead of f16.
    • 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 f16 to f32, which increases memory usage for existing setups.
  124. v1.0.4 Mar 24, 2023 · issue -392

    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.exe for all future releases, supporting drag-and-drop model loading or interactive model selection via a popup dialog.
  125. v1.0.3 Mar 22, 2023 · issue -392

    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.
  126. v1.0.2 Mar 21, 2023 · issue -392

    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:5001 after running llama_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.
my-toolchain — 0 tools
paste an install list to detect your tools

A brew list, a Brewfile, requirements.txt, a Dockerfile — or just the product names, free-form. Nothing leaves your browser.

    browse all tools →