Chatbox 免费开源 AI 桌面客户端上手指南:本地模型接入与魔改实操
Chatbox 免费开源 AI 桌面客户端上手指南本地模型接入与魔改实操【免费下载链接】chatboxPowerful AI Client项目地址: https://gitcode.com/GitHub_Trending/ch/chatbox你有一台装着 Ollama 的机器想写周报又不想让内容离开本机——打开 Chatbox把模型切到本地全程零外发。Chatbox 是一款免费开源的 AI 桌面客户端GPLv3支持 OpenAI、Claude、Ollama 等多家模型服务商API Provider即模型接口的提供方对话数据存在本地覆盖 Windows、macOS、Linux。图1Chatbox 浅色主题完整界面左侧为会话与提示词库三步从克隆到启动环境只需 Node.js建议 16 及以上和 npm这是 Electron用网页技术写桌面应用项目的标配。拉源码、装依赖git clone https://gitcode.com/GitHub_Trending/ch/chatbox cd chatbox npm install第一条命令把仓库拉到本地npm install安装全部依赖装完后会自动执行postinstall顺带构建好开发用的资源包。启动开发模式npm run dev它以热更新模式启动 Electron 主进程和前端渲染进程改代码即时生效想发布安装包再执行npm run package当前平台或npm run package:allWin/Mac/Linux 全平台。场景一接入本地 Ollama 模型对话不出内网适合对数据敏感、或不想依赖境外 API 的用户。在机器上装好 Ollama本地模型运行框架并拉取一个模型打开 Chatbox 设置把 AI Provider 切到OllamaAPI Host 保持默认http://localhost:11434模型下拉框会自动列出本机已拉取的模型供你挑选开始对话即可所有请求都发往本机。图2设置页选择 Ollama 作为 AI Provider模型列表自动拉取背后的逻辑可以直接读源码确认src/renderer/packages/models/ollama.ts 里的listModels()请求 Ollama 的/api/tags接口所以下拉框里的模型就是本机真实已有的。场景二读懂模型适配层为加新供应商做准备models/ 目录下每个文件对应一家供应商openai.ts、claude.ts、ollama.ts、siliconflow.ts……新增一家供应商思路是三步在该目录新建文件继承Base类实现callChatCompletion发起对话请求并流式吐字需要模型列表的话再实现listModels在 models/index.ts 的getModel函数和AIModelProviderMenuOptionList菜单里注册。以 Ollama 适配类为例看看需要填多少东西export default class Ollama extends Base { public name Ollama async callChatCompletion(rawMessages, signal, onResultChange) { const res await this.post(${this.getHost()}/api/chat, ...) await this.handleNdjson(res, (message) { ... }) return result } async listModels(): Promisestring[] { ... } }以上为 ollama.ts 的结构节选。Base已封装好 fetch 重试、SSE/NDJSON 流式解析、错误分类所以新供应商的实现非常薄——照抄一家、换掉 URL 和报文即可。场景三让团队共享一个 OpenAI Keyteam-sharing/ 目录提供一套现成方案成员共用一个 OpenAI 账户的 API 资源但 Key 只保存在服务器上客户端不暴露。准备一台能访问 openai.com 的服务器任意云厂商均可装好 Docker启动共享服务把 Key 通过环境变量注入镜像容器内的 Caddy反向代理会自动完成域名与密钥的替换和 HTTPS 证书处理docker run -p 80:80 -p 443:443 \ -v ./caddy_config:/config -v ./caddy_data:/data \ -e KEY你的 OpenAI Key \ -e HOST你的域名 \ bensdocker/chatbox-team把https://你的域名发给成员他们在设置里把这个地址填进API Host字段不用填 Key 即可共享资源域名映射后约五分钟生效。图3Chatbox 深色主题长时间使用的护眼选项详细步骤见 team-sharing/README-CN.md。踩坑备忘发消息提示Failed to fetch→ 网络连不上你填的 API Host → 检查当前网络能否访问该地址或改走代理。突然报You exceeded your current quota→ OpenAI 账户免费额度用尽或过期 → 登录 OpenAI 控制台充值或绑定支付方式。回复慢、答非所问→ 温度参数Temperature控制回复随机程度或上下文过长 → 在设置里调低温度或减少携带的历史消息数。npm install报错→ Node.js 版本过低 → 升到 16 后清空 npm 缓存重装依赖。更多答案见 doc/FAQ-CN.md。行动入口Chatbox 的定位是一手的 AI 对话客户端数据本地、供应商可换、代码可读可改适合想摆脱网页端、用本地模型、或给团队搭共享通道的用户。文档看 doc/README-CN.md问题提 Issue想动手就从 fork 一份开始提交 PR。【免费下载链接】chatboxPowerful AI Client项目地址: https://gitcode.com/GitHub_Trending/ch/chatbox创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

HyperMesh内外饰件快速建模:从几何清理到网格划分全流程指南

HyperMesh内外饰件快速建模:从几何清理到网格划分全流程指南

在整车内外饰件的CAE分析里,最容易被人低估的环节,不是求解器设置,也不是结果解读,而是前处理建模。尤其是仪表板、门饰板、保险杠这类塑料薄壁件,从CAD数据到可计算的有限元模型,中间隔着几何清理、中面抽…

2026/11/17 20:49:58 阅读更多 →
智元机器人双榜第一背后:人形机器人运动控制与具身智能技术拆解

智元机器人双榜第一背后:人形机器人运动控制与具身智能技术拆解

最近智元机器人把自家面向商用和工业场景的人形机器人直接拉去参加了人形机器人赛事,并且拿下了双榜第一。这件事在外界看来可能只是“机器人跑酷”“机器人搬箱子”的新闻,但放在技术视角下,其实是一次非常典型的工程化压力测试。平时在工厂…

2026/11/22 7:07:35 阅读更多 →
思源笔记数学公式排版:从 $ 到矩阵公式的完整指南

思源笔记数学公式排版:从 $ 到矩阵公式的完整指南

思源笔记数学公式排版:从 $ 到矩阵公式的完整指南 【免费下载链接】siyuan An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作 …

2026/11/17 11:43:36 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻