跳到主要内容Skip to main content
← Runners

KoboldCppKoboldCpp

LostRuins(KoboldAI 社区)LostRuins (KoboldAI community)
开源Open source AGPL3.0AGPL3.0 单文件Single file GGUFGGUF 角色扮演Roleplay 长上下文Long context partial lifecycle: active 核验Checked 2026-10-30

KoboldCpp 是角色扮演/创意写作圈的本地推理老兵:单文件免安装、GGUF、Kobold 系上下文管理传统。 AGPL-3.0——商用集成前先读 copyleft 义务。诚实标注:官方仓在 LostRuins 名下(koboldai 名下旧仓 404)。

KoboldCpp is the veteran local runner of the roleplay/creative-writing scene: single-file zero-install, GGUF, the Kobold context-management tradition. AGPL-3.0 — read the copyleft obligations before commercial integration. Honest note: the official repo lives under LostRuins (the koboldai path 404s).

适合与不适合When to use it, when not to

适合:长上下文角色扮演与创意写作、要零安装单文件、KoboldAI 前端生态用户。 不适合:要 AGPL 之外的宽松许可做闭源集成;要 OpenAI 兼容作主工作流(能用但非主轴)。

Fits: long-context roleplay and creative writing, zero-install single file, KoboldAI frontend users. Not a fit: closed-source distribution under a laxer license; OpenAI compatibility as the main workflow.

中文生态China availability 国产 / 国内可直接用 / 备案状态 · 快照domestic / direct access / CAC filing · snapshot 2026-10-21

出品属地Origin
国外出品foreign-made LostRuins(个人维护者,KoboldAI 社区线)。LostRuins (individual maintainer, KoboldAI community line).
国内使用Direct access
大陆可直连direct OK github.com/LostRuins/koboldcpp 直连实测 200(2026-10-21)。github.com/LostRuins/koboldcpp measured 200 direct (2026-10-21).
备案状态CAC filing
未见于备案名单not in filing list:未见于网信办公示名单(2026-10-21 检索);开源项目未面向大陆公众提供服务,备案不适用。not in the CAC public registry (searched 2026-10-21); the open-source project does not serve the mainland public, so filing does not apply.

备案信息以网信办《生成式人工智能服务已备案信息》公示名单为准(按批次滚动更新,本站只抄编号不解读);「大陆可直连」是本站从大陆网络直连实测的结果,不是厂商承诺。GitHub 类站点当日实测有波动,口径写在依据里。Filing status is quoted from the CAC public registry (updated batch by batch; this site copies the number and does not interpret it). "Direct access" is this site's own reachability measurement from a mainland network, not a vendor promise. GitHub-hosted sites fluctuated on the measurement day — the note says so.

固定坐标系Fixed coordinate system

8 个维度dimensions, 与同分区其他对象逐项可比each comparable item by item against others in the same section.

模型与开放条件Model & openness

GGUF 为主(仓库描述「Run GGUF AI models locally」直抓所见)+ transformers 转换线; 支持量化档看 models 站 GGUF 索引口径。

GGUF-first (repo description "Run GGUF AI models locally", direct-fetched) + a transformers conversion line; for supported quantization tiers see the models-site GGUF index framing.

运行位置Where it runs

单文件可执行程序(「One File. Zero Install.」官方描述);基于 llama.cpp 系; GitHub 12,097★(API 核验 2026-10-21)。

A single-file executable ("One File. Zero Install." official description); built on the llama.cpp line; GitHub 12,097★ (API verified 2026-10-21).

本地文件Local files

全本地运行:模型、对话与生成记录都在自有环境;未见官方云线或遥测声明。

Fully local: models, conversations and generation records all live in your own environment; no official cloud line or telemetry statement seen.

关机后的任务Tasks after shutdown

内置 KoboldAI 兼容 API server 常驻;细节未逐条核验。

A built-in KoboldAI-compatible API server stays resident; details not verified item by item.

工具与扩展Tools & extensions

以角色扮演/创意写作负载为主轴;工具调用/function calling 支持面未逐条核验。

Roleplay/creative-writing workloads are the main axis; the tool-calling/function-calling support surface not verified item by item.

上下文与记忆Context & memory

上下文与内存(memory/smart context)管理是 Kobold 系传统强项;细节未逐条核验。

Context and memory (memory/smart context) management is the Kobold line's traditional strength; details not verified item by item.

权限与限制Permissions & limits

本地进程无账号体系;API server 监听与鉴权由用户自配(默认口径未逐条核验)。

A local process with no account system; API-server listening and authentication are user-configured (default stance not verified item by item).

适合什么任务Best for

适合:角色扮演/长上下文创意写作、要单文件免安装、要 KoboldAI 生态兼容。 不适合:要 OpenAI 兼容主叙事(有但非主轴);要 AGPL 商用闭源分发(copyleft 约束)。

Fits: roleplay/long-context creative writing, wanting a single file with no install, wanting KoboldAI ecosystem compatibility. Does not fit: wanting the OpenAI-compatible narrative as the main axis (it exists but isn't the main axis); closed-source distribution built on AGPL (copyleft obligations).

头号误解Top misconception

  • AGPL 的 copyleft——基于它分发服务要开源义务,商用闭源集成前先读条款AGPL copyleft — distributing a service built on it carries open-source obligations; read the terms before closed-source commercial integration
  • 找错仓库——官方仓在 LostRuins 名下,koboldai/koboldcpp 已 404(2026-10-21 直抓核验)Finding the wrong repo — the official repo is under LostRuins; koboldai/koboldcpp 404s (direct-fetched 2026-10-21)
  • 把「单文件」当「功能少」——上下文管理线是它的看家特色Reading 'single file' as 'feature-poor' — the context-management line is its flagship

未知项清单Known unknowns

  • 上下文管理特性全清单(smart context/memory 线未逐条核验)
  • 工具调用支持状态(未逐条核验)
  • 个人维护者的长期维护承诺(未见官方声明——单点维护风险如实标注)
  • The full context-management feature list (the smart context/memory line not verified item by item)
  • Tool-calling support status (not verified item by item)
  • The individual maintainer's long-term maintenance commitment (no official statement seen — single-point maintenance risk flagged as such)

证据来源Evidence sources

判断可回到以下一手源复核。本站核验日Every judgement can be rechecked against the primary sources below. Verified on 2026-10-30,内容更新日content updated on 2026-10-21。

类型Type名称Name链接Link
repoLostRuins/koboldcpp · 仓库(AGPL-3.0;12,097★,最近推送 2026-10-29,GitHub API 核验)LostRuins/koboldcpp · repo (AGPL-3.0; 12,097★, last push 2026-10-29, GitHub API verified)https://github.com/LostRuins/koboldcpp
docsLostRuins/koboldcpp · LICENSE(2026-10-21 直抓核验)LostRuins/koboldcpp · LICENSE (direct-fetched and verified 2026-10-21)https://github.com/LostRuins/koboldcpp/blob/master/LICENSE
changelogLostRuins/koboldcpp · Releases(changelog)LostRuins/koboldcpp · Releases (changelog)https://github.com/LostRuins/koboldcpp/releases
docsKoboldCpp · 官方 WikiKoboldCpp · official Wikihttps://github.com/LostRuins/koboldcpp/wiki

实测记录Measured runs

本档未跑吞吐与显存实测;结论只覆盖运行时能力与许可。

This site has not completed measured runs. The closest test protocol is the code-side protocols/framework/_protocol.md (the local-endpoint and credential-boundary sections are reusable; no runner-specific protocol exists on this site yet).

相关条目Related entries

  • llama.cppllama.cpp底层同源(llama.cpp 系);KoboldCpp 在其上加 GUI 与上下文管理。Same underlying root (the llama.cpp line); KoboldCpp adds GUI and context management on top.
  • text-generation-webuitext-generation-webui / textgen同为社区 GUI 路线:TGW 重扩展生态,KoboldCpp 重单文件与角色扮演。Both community GUI routes: TGW leans on the extension ecosystem, KoboldCpp on the single file and roleplay.
  • OpenAI Agents SDKOpenAI Agents SDK另一层 · 框架与运行时Other layer · Frameworks & runtimes

本页由This page is generated from the ai-handbook 数据层生成(CC BY 4.0)。data layer (CC BY 4.0). 方法论与坐标系定义见仓库内For the methodology and coordinate definitions, see METHODOLOGY.md.