
gpt4free-ts
免费用上 GPT-4,TypeScript 开发者快速集成
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7642
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 环境(本地运行需使用 yarn 安装依赖)
- Docker 环境(推荐用 docker run 方式运行)
- Docker Compose(使用 docker-compose 部署时需要)
- 必须先在项目根目录创建 .env 文件,所有运行方式都依赖它
- 若本机无法直连目标站点,需要准备可用的 http 代理
安装与启动步骤
-
1获取项目代码
把仓库克隆到本地,README 建议先 fork 一份,因为部分逆向目标站点随时可能下线。
git clone https://github.com/xiangsx/gpt4free-ts.git -
2创建 .env 文件
在项目根目录新建 .env,填入代理、RapidAPI Key、并发数等配置;不需要代理时删除 http_proxy 这一行。
-
3本地安装依赖
在项目目录下用 yarn 安装 Node 依赖,README 本地运行部分只给出了这一条安装命令。
yarn -
4Docker 方式运行
README 推荐的方式,用 --env-file 加载 .env,并把容器 3000 端口映射到本机 3000 端口。
docker run -p 3000:3000 --env-file .env xiangsx/gpt4free-ts:latest -
5docker-compose 部署
同样需要先创建好 .env,然后在项目目录执行后台构建并启动。
docker-compose up --build -d -
6使用免费 API Key
README 提供一个免费的 OpenAI 兼容渠道,Base URL 为 https://api.gptgod.online,Key 为 sk-OsMMq65tXdfOIlTUYtocSL7NCsmA7CerN77OkEv29dODg1E
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
http_proxy | 否 | 无法直连目标网站时配置的 HTTP 代理;不需要代理则删除该行 | http://host:port |
rapid_api_key | 否 | 使用 forefront 相关功能时用于接收注册邮件的 RapidAPI Key | xxxxxxxxxx |
EMAIL_TYPE | 否 | 临时邮箱类型,可选 temp-email、temp-email44、tempmail-lol | temp-email44 |
DEBUG | 否 | 使用 forefront 时设为 1 可显示逆向过程,便于本地排查 | 0 |
POOL_SIZE | 否 | forefront 并发数,运行成功前保持为 1,越大越占内存 | 0 |
PHIND_POOL_SIZE | 否 | phind 渠道的并发会话数量,越大可同时进行的对话越多 | 0 |
如何确认成功
docker run 启动后容器监听的 3000 端口映射到本机,用浏览器访问 http://localhost:3000 或发起请求有响应即算启动成功。
常见问题
Q:必须创建 .env 文件吗?
A:是的,README 明确说明所有运行方式都需要先创建 .env 文件,否则容器和本地服务缺少必要配置。
Q:没有代理能不能跑?
A:可以。如果你能直接访问目标网站,就把 .env 里的 http_proxy 那一行删掉即可。
Q:POOL_SIZE 应该设多大?
A:README 建议在第一次运行成功之前保持为 1,之后可再按内存情况调大以支持更多并发对话。
Q:rapid_api_key 是必须的吗?
A:不是。它只在你要使用 forefront 相关接口时才需要配置,用于接收注册邮件获取 API Key。
Q:服务打不开或请求失败怎么办?
A:先检查 .env 是否创建、代理是否可用;该项目依赖第三方渠道,站点可能随时被屏蔽或下线。
注意事项
- 先 fork 一份仓库,因为部分被逆向的站点可能随时下线。
- 免费 API Key 由第三方站点 gptgod.online 提供,并非官方 OpenAI 渠道,随时可能失效。
- 模型输出依赖第三方渠道稳定性,存在被屏蔽的风险,请勿用于生产关键业务。
- 并发数配置越大占用内存越多,本地调试建议先用默认值。
核心亮点
- 零成本接入 GPT-4,无需 OpenAI API Key
- TypeScript 原生支持,类型安全,易于集成到 Node.js 项目
- 支持流式输出,交互体验流畅
不足之处
- 依赖逆向工程,第三方渠道可能随时失效,稳定性无保障
- 文档和社区支持相对薄弱,需自行摸索
适用场景
- 个人开发者快速原型验证,体验 GPT-4 能力
- 教学演示或研究用途,无需付费即可调用大模型
- 在资源受限环境中临时替代官方 API 进行功能测试
替代项目
gpt4free、free-chatgpt-api、chatgpt-api
上一篇:BetterChatGPT
下一篇:HuLa
同类项目推荐
FoundationChat
开源
在 iOS 26 上快速跑通苹果原生端侧聊天,省去模型接入烦恼
A chat app with iOS 26 Foundation Models
RWKV_APP
开源
一个应用,全平台离线跑 RWKV 聊天
Cross-platform, local-first RWKV chat built with Flutter for Android, iOS, Windows, ···
llm-x
开源
在浏览器里,像用ChatGPT一样轻松玩转本地大模型。
LLMX; Easiest 3rd party Local LLM UI for the web!
chatgpt-voice
开源
张嘴就能和 ChatGPT 聊天,解放双手的语音助手
Have a conversation with ChatGPT. Casually ⚡️
College-Enquiry-Chatbot
开源
问校园事,秒回答案,告别跑腿咨询
The College Enquiry Chatbot project is built using machine learning algorithms. The ···
cog
开源
在聊天框里直接跑命令行,运维协作快人一步
Bringing the power of the command line to chat
AChat
开源
本地优先、远程同步,企业级 AI 对话平台
AChat - An open-source/self-hosted/local-first AI platform, designed for enterprises···
myGPTReader
开源
用 ChatGPT 和 AI 对话式阅读,让每篇文章都能聊起来
A community-driven way to read and chat with AI bots - powered by chatGPT.
ai-bot-groupmate
开源
给 QQ 群塞一个会插话接梗的 AI 群友
Estrella Bot · QQ 群 AI 群友机器人。把 QQ 小号接给任意 OpenAI 兼容模型(本机 / Deep···