Skip to content

Enable API / LAN (KoboldCPP) ​

UI labels vary by version — follow your installed KoboldCPP. Goals:

  1. Enable OpenAI Compatible / Chat Completions API
  2. Listen so LAN can reach it (not localhost-only)
  3. Allow the port in the firewall

Common defaults ​

ItemCommon value
Port5001 (follow launch flags / UI)
Base URL (for MiniTavern)http://YOUR_PC_IP:5001/v1

Some builds use launch flags, e.g. (illustrative — check the current README):

bash
# Illustrative: remote access + OpenAI-compatible endpoint (exact flags follow official README)
koboldcpp --model your.gguf --host 0.0.0.0 --port 5001

Local self-test ​

Browser or curl:

text
http://127.0.0.1:5001/v1/models

Then LAN:

text
http://YOUR_PC_IP:5001/v1/models

Fill in MiniTavern ​

FieldValue
Model platformCustom (OpenAI)
Base URLhttp://YOUR_PC_IP:5001/v1
API KeyUsually empty or any placeholder
Model nameSame id as /v1/models

Next ​

Configure in MiniTavern · Troubleshoot