chatgpt.js

几行代码接入 ChatGPT，前端/Node 都适用，还带命令行调试工具。

chatgpt.js 是一个轻量级的 JavaScript 库，专为前端和 Node.js 环境设计，旨在简化与 ChatGPT（包括 GPT-4 和 GPT-5）的交互。它解决了开发者直接调用 OpenAI API 时面临的复杂性和浏览器跨域限制问题，提供了一套简洁的异步接口，支持流式响应、会话管理、多轮对话和自定义参数。该库同时附带一个交互式命令行工具，方便开发者快速测试和调试。其核心能力包括：自动处理 API 认证、内置重试与错误处理、支持模型切换和上下文管理，以及极小的包体积（约 5KB），适合嵌入各类 Web 应用、浏览器扩展或自动化脚本。通过封装底层请求，chatgpt.js 让开发者无需关注繁琐的 HTTP 细节，即可快速构建聊天机器人、AI 助手或内容生成工具。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2039

维护状态维护中

是否开源是

定价模式 free

项目预览

项目数据

分类对话助手

开发团队KudoAI

所属国家

官网地址https://chatgptjs.org

GitHubhttps://github.com/KudoAI/chatgpt.js

定价模式free

价格说明开源库，本地部署或集成使用，完全免费。

访问状态

是否开源是

开源协议

主要语言JavaScript

技术栈/模型ai,artificial-intelligence,bot,chat,chatbot,chatgpt,clientside,conversational-ai,conversational-bots,frontend,gpt,gpt-5,javascript,kudoai,library,machine-learning,ml,nlp,openai

GitHub 星标★ 2039

30天Star增速

HF 下载量

上线时间2023-03-15 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

Star 增长趋势

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

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 5 分钟部署方式：库/依赖 4 步

环境要求

Node.js 与 npm 环境（使用 npm 安装命令的前提）
项目根目录（Node.js 方式安装时需在项目根执行）
浏览器环境（Web 方式引入 CDN 脚本时需要）
支持 @require 的用户脚本管理器（Greasemonkey 方式需要，如 Tampermonkey）

安装与启动步骤

1项目内安装

在 Node.js 项目根目录执行，将 chatgpt.js 作为依赖安装到当前项目。注意包名带 @kudoai 作用域前缀，不要漏写。
```
npm install @kudoai/chatgpt.js
```
2网页 CDN 引入

在 HTML 页面中通过 script 标签引入 jsDelivr 上的压缩版文件，适合纯前端页面直接使用，无需构建工具。
3油猴脚本引入

在用户脚本的元数据区用 @require 引入同一 CDN 文件，即可在 Tampermonkey、Violentmonkey 等脚本管理器中使用。
```
// @require https://cdn.jsdelivr.net/npm/@kudoai/chatgpt.js@4/dist/chatgpt.min.js
// ==/UserScript==
```
4全局安装

需要全局使用（例如配合交互式命令行工具）时执行全局安装，安装后可在任意目录调用，可能需要管理员权限。
```
npm install -g @kudoai/chatgpt.js
```

如何确认成功

Node.js 方式下导入该包不报错即为安装成功；网页方式下 script 标签正常加载、控制台无 404 报错即引入成功。

常见问题

Q：为什么 README 顶部提示项目已迁移？

A：官方声明本项目已迁移到 https://gitlab.com/kudoai/chatgpt-js，后续更新与新文档请以该 GitLab 仓库为准，GitHub 仓库可能不再同步维护。

Q：npm 安装时提示找不到包怎么办？

A：确认包名写全为 @kudoai/chatgpt.js，包含 @kudoai 作用域前缀；单独写 chatgpt.js 不是本库的 npm 包名。

Q：Web 引入和 Node.js 安装有什么区别？

A：Web 方式通过 CDN 的 dist/chatgpt.min.js 在浏览器中直接加载；Node.js 方式通过 npm 安装到项目依赖，用于后端或构建流程。

Q：用户脚本里怎么复用同一份代码？

A：在脚本元数据块中写 @require 指向 CDN 的 chatgpt.min.js，脚本运行时该库会自动加载，无需另外打包。

注意事项

README 明确标注项目已迁移至 GitLab 仓库，获取最新版本请优先访问新地址。
CDN 链接使用 @4 主版本号，同一主版本下的小版本更新会被自动获取。
README 节选中未给出 API 密钥配置与具体调用示例，使用前请查阅官方文档站点 chatgptjs.org。
Greasemonkey 方式可参考官方起始模板 KudoAI/chatgpt.js-greasemonkey-starter。

核心亮点

极轻量（约 5KB），无外部依赖，加载快，适合前端性能敏感场景
支持流式响应和会话上下文管理，开箱即用，减少开发量
提供交互式 CLI，可快速测试和调试，降低入门门槛

不足之处

文档/社区待观察
主要封装官方 API，若 OpenAI 接口变动，需及时跟进更新

适用场景

在浏览器扩展或网页中快速集成 ChatGPT 对话功能
构建轻量级聊天机器人或 AI 助手，需要前端直连 API
开发自动化脚本或 CLI 工具，用于批量生成内容或测试

替代项目

openai-node、langchain.js、gpt-3.encoder

项目介绍

chatgpt.js 是开发框架领域的开源项目，由 KudoAI 开发，2023 年首次发布。

在全站 13,635 个收录项目中，它的 GitHub 星标数（2,039）位列前 30%，在开发框架分类中处于中上游。

项目仍在小幅维护中，最近一次代码更新于 2026-08-10。开源库，本地部署或集成使用，完全免费。从国内网络环境看，可直接访问。

它主要面向的使用场景是：在浏览器扩展或网页中快速集成ChatGPT对话功能。同类可对比的替代方案包括 openai-node、langchain.js、gpt-3.encoder。

上一篇：ai-chatbot-framework

下一篇：wink-nlp