项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-23 · 当前星标 ★ 2001
使用教程
环境要求
- Node.js 与 npm(用于 npm ci / npm run dev)
- Git,用于拉取源码
- 可选:Docker 与 Docker Compose,用于本地容器化部署
- 可用的 OpenAI 兼容 API 密钥(由使用者自行提供)
安装与启动步骤
-
1获取项目源码
克隆仓库到本地并进入项目目录,后续所有命令都在该目录执行。
git clone https://github.com/Niek/chatgpt-web.git cd chatgpt-web -
2安装依赖
使用 npm ci 按锁文件安装依赖,保证依赖版本与项目一致,不要用 npm install 替代。
npm ci -
3启动开发服务器
运行开发模式,终端会输出本地访问地址,浏览器打开该地址即可进入聊天界面。
npm run dev -
4Docker Compose 部署
用 Docker Compose 一次性启动应用与模拟 API 服务,适合本地快速验证,后台运行。
docker compose up -d -
5配置模拟 API
编辑项目根目录 .env,把 provider 设为 custom,接口地址指向本地模拟服务,密钥填任意非空值。
-
6单独启动模拟 API
仅启动 mocked_api 服务,配合上面的 .env 配置即可在无真实密钥时测试对话流程。
docker compose up -d mocked_api
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
VITE_PROVIDER | 是 | 指定使用的 API 提供方,测试模拟接口时填 custom | custom |
VITE_API_BASE | 是 | API 基础地址,指向模拟 API 时用于重定向请求 | http://localhost:5174 |
VITE_API_KEY | 是 | 访问 API 所需的密钥,模拟模式下填任意非空值即可 | sk-xxxxxxxx |
如何确认成功
开发服务器启动后终端会打印本地地址,浏览器打开该地址,选择提供方并填入 API 密钥后能列出可用模型即成功。
常见问题
Q:没有 API 密钥能试用吗?
A:可以。在 .env 中把 VITE_PROVIDER 设为 custom、VITE_API_BASE 设为 http://localhost:5174,并给 VITE_API_KEY 填任意非空值,再启动 mocked_api 服务即可。
Q:如何测试模拟响应延迟和长度?
A:在对话中发送形如 d2 l10 的内容,d 后数字表示延迟秒数,l 后数字表示返回句子数量,可组合使用。
Q:如何测试图片生成和 SVG 渲染?
A:把对话的 Image Generation Model 设为 mock-image 并输入 show me an image of ...;测试 SVG 时提示 mock svg 且不要开启图片生成。
Q:聊天记录存在哪里?
A:保存在浏览器本地存储中,不会上传到第三方服务器,更换浏览器或清空缓存后记录不再保留。
注意事项
- 开发模式与 Docker Compose 两种方式二选一即可,不要重复占用同一端口。
- npm ci 需要 package-lock.json,若缺失请检查仓库是否完整克隆。
- 对话内容直接发送给所选 API 提供方,注意密钥与数据的保管。
- 修改 .env 后需重启开发服务或容器才会生效。
核心亮点
- 基于 Svelte 构建,产物轻量、运行时开销小,页面响应快
- 支持流式输出、多轮会话与 Markdown/代码高亮,日常对话体验完整
- 前端结构清晰,便于改主题、换模型参数或接入自有 API 代理
不足之处
- 仅提供前端界面,需自备 OpenAI API Key 与后端代理,开箱即用程度有限
- 功能相对基础,缺少插件、知识库、多用户权限等进阶能力
- 项目规模中等,文档与长期维护活跃度有待观察
适用场景
- 开发者自建个人 ChatGPT 网页入口,统一管理对话历史
- 团队内部搭建轻量 AI 对话工具,接入自有 API 网关
- 作为学习 OpenAI API 流式对话与 Svelte 前端集成的参考项目
替代项目
chatgpt-next-web、lobe-chat、chatbox
同类项目推荐
PureChat
开源
一个应用搞定多模型聊天,还能导出截图换主题
PureChat 是一款全面的聊天应用程序,它将传统的即时消息与高级 AI 功能集成在一起。其模块···
yetibot
开源
在聊天框里用管道命令,把运维和自动化全搞定
Extreme chatops bot for Slack, Discord, Mattermost, IRC New contributors welcome
ajean
开源
一个二进制,把本地大模型、记忆、联网和加密全装进家里
Run your own AI at home, in one single executable: llama.cpp on your GPU (installed ···
ChatChat
开源
一个界面聊遍多家 AI 模型,自部署更安心
Chat Chat, your own unified chat and search to AI platform, with a simple and easy t···
glados-voice-assistant
开源
把GLaDOS带回家,用毒舌语音控制你的智能家居。
DIY Voice Assistant based on the GLaDOS character from Portal video game series. Wor···
Cebian
开源
在浏览器侧边栏随时唤起 AI,不切页面直接对话
An AI assistant that lives in your browser side panel
agnai
开源
自建多用户角色扮演聊天平台,支持海量机器人并发
AI Agnostic (Multi-user and Multi-bot) Chat with Fictional Characters. Designed with···
InternalBeyond
开源
离线单文件,把 AI 情感陪伴装进个人网站
【Project-IB】边界之外:离线运行的单文件个人网站式项目,旨于维系情感的连续性。A sing···
peekobot
开源
百行代码,轻松给网站加个对话引导
A simple, choice-driven chatbot framework for your website written in just over 100 ···
