chatgpt-web

自部署的 ChatGPT 网页聊天前端,界面轻快可改

开源 🏷️完全免费 ⏳ 访问状态待核验 对话助手 🍴 复刻 459 🐛 待处理 32 👀 关注 18
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 2001
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 支持限时试用 · 开源免费,需自备OpenAI API Key,按API用量付费

项目预览

chatgpt-web 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队Niek
定价模式🏷️完全免费
价格说明开源免费,需自备OpenAI API Key,按API用量付费
访问状态⏳ 访问状态待核验
是否开源是
开源协议GPL-3.0
主要语言Svelte
GitHub 星标★ 2001
上线时间2023-03-02 00:00:00
代码更新2026-11-16
仓库体积30.9 MB
本站数据更新2026-11-23
维护状态活跃
收录时间2026-11-23
浏览次数0

项目介绍

chatgpt-web 是一个基于 Svelte 构建的 ChatGPT 网页界面,通过调用 OpenAI API 提供对话交互能力。项目解决的核心问题是:官方网页版在界面定制、部署方式和数据掌控上受限,用户希望拥有一个可自行部署、界面简洁、可二次开发的聊天前端。核心能力包括:多轮对话与会话管理、流式输出、模型与参数配置、对话历史保存、Markdown 渲染与代码高亮,以及适配桌面与移动端的响应式布局。项目采用 Svelte 编写,构建产物轻量,前端结构清晰,便于修改主题、接入自有后端代理或扩展功能。适合开发者作为自托管对话入口、内部工具原型或学习 OpenAI API 前端集成的参考实现。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-11-23 · 当前星标 ★ 2001

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 6 步

环境要求

  • Node.js 与 npm(用于 npm ci / npm run dev)
  • Git,用于拉取源码
  • 可选:Docker 与 Docker Compose,用于本地容器化部署
  • 可用的 OpenAI 兼容 API 密钥(由使用者自行提供)

安装与启动步骤

  1. 1获取项目源码

    克隆仓库到本地并进入项目目录,后续所有命令都在该目录执行。

    git clone https://github.com/Niek/chatgpt-web.git
    cd chatgpt-web
  2. 2安装依赖

    使用 npm ci 按锁文件安装依赖,保证依赖版本与项目一致,不要用 npm install 替代。

    npm ci
  3. 3启动开发服务器

    运行开发模式,终端会输出本地访问地址,浏览器打开该地址即可进入聊天界面。

    npm run dev
  4. 4Docker Compose 部署

    用 Docker Compose 一次性启动应用与模拟 API 服务,适合本地快速验证,后台运行。

    docker compose up -d
  5. 5配置模拟 API

    编辑项目根目录 .env,把 provider 设为 custom,接口地址指向本地模拟服务,密钥填任意非空值。

  6. 6单独启动模拟 API

    仅启动 mocked_api 服务,配合上面的 .env 配置即可在无真实密钥时测试对话流程。

    docker compose up -d mocked_api

关键配置

配置项必填说明示例
VITE_PROVIDER是指定使用的 API 提供方,测试模拟接口时填 customcustom
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 功能集成在一起。其模块···

★ 545 2026-08-09
yetibot 开源

在聊天框里用管道命令,把运维和自动化全搞定

Extreme chatops bot for Slack, Discord, Mattermost, IRC New contributors welcome

★ 362 2026-08-09
ajean 开源

一个二进制,把本地大模型、记忆、联网和加密全装进家里

Run your own AI at home, in one single executable: llama.cpp on your GPU (installed ···

★ 115 2026-09-27
ChatChat 开源

一个界面聊遍多家 AI 模型,自部署更安心

Chat Chat, your own unified chat and search to AI platform, with a simple and easy t···

★ 1268 2026-10-11
glados-voice-assistant 开源

把GLaDOS带回家,用毒舌语音控制你的智能家居。

DIY Voice Assistant based on the GLaDOS character from Portal video game series. Wor···

★ 347 2026-08-09
Cebian 开源

在浏览器侧边栏随时唤起 AI,不切页面直接对话

An AI assistant that lives in your browser side panel

★ 186 2026-08-09
agnai 开源

自建多用户角色扮演聊天平台,支持海量机器人并发

AI Agnostic (Multi-user and Multi-bot) Chat with Fictional Characters. Designed with···

★ 795 2026-08-09
InternalBeyond 开源

离线单文件,把 AI 情感陪伴装进个人网站

【Project-IB】边界之外:离线运行的单文件个人网站式项目,旨于维系情感的连续性。A sing···

★ 682 2026-08-09
peekobot 开源

百行代码,轻松给网站加个对话引导

A simple, choice-driven chatbot framework for your website written in just over 100 ···

★ 313 2026-08-09