KoboldAI-Client

本地跑模型，边聊边写小说和角色扮演

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3954

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类对话助手

开发团队KoboldAI

所属国家

官网地址https://koboldai.com

GitHubhttps://github.com/KoboldAI/KoboldAI-Client

定价模式free

价格说明开源免费，可本地部署使用

访问状态

是否开源是

开源协议AGPL-3.0

主要语言Python

技术栈/模型

GitHub 星标★ 3954

30天Star增速

HF 下载量

上线时间2021-05-02 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-16

浏览次数0

项目介绍

KoboldAI-Client 是一个面向 AI 辅助写作与角色扮演的开源前端客户端，用 Python 编写，核心目标是把本地或远程的大语言模型变成可交互的创作伙伴。它解决的是普通聊天界面缺乏写作控制的问题：用户可以通过界面调节生成参数、编辑上下文、管理世界信息与角色设定，并支持多分支故事、记忆注入和提示词模板，让模型输出更符合剧情走向。项目早期以支持多种模型格式著称，如今 GGUF 推理已转向同作者的 KoboldCPP 项目，本仓库更多承担客户端与交互层职责。它适合需要长文本续写、互动小说、角色对话和创意脑暴的用户，也提供 API 供其他程序调用，整体强调本地部署、隐私可控与高度可定制。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：云服务 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

浏览器（前端为浏览器界面，需通过浏览器访问）
一个可用的模型或在线服务：本地/远程模型，或 OpenAI、Inferkit 等服务的 API Key
若本地运行：自行准备显卡或 CPU 算力（CPU 模式速度较慢）
可选：能访问 Google Colab 的网络环境，用免费 GPU/TPU 运行模型

安装与启动步骤

1确认项目状态

README 顶部明确警告：本仓库为旧版软件，不再维护，无法运行现代模型，请先确认是否还要继续使用。
2改用 KoboldCpp

若目标是使用最新的现代模型，README 建议切换到同作者的 KoboldCpp 项目，不要继续用本仓库。
3用 Colab 免费运行

没有高端显卡时，README 给出仓库内两个 Colab 笔记本链接，可在线使用免费 GPU 或 TPU 跑模型。
4挑选合适的模型

README 按 GPU 与 TPU 分别列出可用模型表，按写作、冒险、NSFW 等用途选择，如 Nerys、Tiefighter 13B、Erebus。
5选择本地或在线服务

也可用自己的显卡、CPU 本地运行，或使用带 API Key 的在线服务；不同选择直接决定生成质量与速度。

关键配置

配置项	必填	说明	示例
`API Key（OpenAI / Inferkit 等）`	否	使用在线 AI 服务时需要填入对应平台的 API Key	`sk-xxxxxxxx`

如何确认成功

在浏览器中打开 KoboldAI 前端界面，切换 Novel/Adventure/Chatbot 模式后能正常生成文本即算可用。

常见问题

Q：为什么装不上或跑不了新模型？

A：README 明示本仓库是旧版且已停止维护，无法运行现代模型，官方建议改用 KoboldCpp（koboldcpp.net）。

Q：我想用最新的模型，应该去哪里？

A：前往 KoboldCpp 项目，README 给出的下载入口是 https://koboldai.org/cpp，或访问 koboldcpp.net。

Q：没有高端显卡还能用吗？

A：可以。README 提供免费 Google Colab 的 GPU 与 TPU 笔记本，也可用 CPU 运行，只是速度会明显更慢。

Q：必须自己有模型吗？

A：不一定，README 提到可使用带 API Key 的在线服务（如 OpenAI、Inferkit），也可以只用免费的 Colab 资源。

注意事项

本仓库为旧版遗留项目，官方已不再维护，README 顶部有明确警告。
GGUF 推理能力已转移到同作者的 KoboldCpp 项目，本仓库更多只承担客户端与交互层职责。
README 中未提供本地安装命令、端口或依赖版本，具体部署方式请以官网与 KoboldCpp 文档为准。
实际生成效果完全取决于你选择的模型或在线服务，README 中不同模型的风格差异很大。

核心亮点

提供丰富的写作控制项，如上下文编辑、世界信息、记忆与作者注释，能显著影响生成走向
支持本地模型与远程 API 两种模式，兼顾隐私与算力弹性
界面围绕长文创作和角色扮演设计，支持多分支、重试与撤销，交互体验成熟

不足之处

GGUF 推理已迁移到 KoboldCPP，本仓库定位变为客户端，新用户容易混淆两个项目
Python 依赖较重，环境配置对新手不够友好

适用场景

用本地模型续写小说或剧本，实时调整剧情分支
与自定义角色进行长期角色扮演对话，维护人设与记忆
作为写作助手做头脑风暴、扩写和风格改写

替代项目

SillyTavern、text-generation-webui

上一篇：chatgpt-bot-telegram

下一篇：没有了！