gpt4free-ts

免费用上 GPT-4,TypeScript 开发者快速集成

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 对话助手 🍴 复刻 1324 🐛 待处理 48 👀 关注 82
GitHub ↗
GitHub 星标 ★ 7642
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 完全免费,开源项目,需自行部署,无官方在线服务。

项目预览

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

项目数据

分类对话助手
开发团队xiangsx
定价模式🏷️完全免费
价格说明完全免费,开源项目,需自行部署,无官方在线服务。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议GPL-3.0
主要语言TypeScript
技术栈/模型chatbot,chatbots,chatgpt,chatgpt-free,chatgpt4,free-gpt,gpt,gpt-3,gpt-35-turbo,gpt-4,gpt4,gpt4-api,gpt4free,nodejs,openai,typescript
GitHub 星标★ 7642
上线时间2023-05-04 00:00:00
代码更新2024-09-04
仓库体积3.0 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数6

项目介绍

gpt4free-ts 是 xtekky/gpt4free 的 TypeScript 移植版,旨在免费提供 OpenAI GPT-4 的 API 访问。它通过逆向工程和聚合多个第三方渠道,绕开官方付费限制,让开发者无需 API Key 即可调用 GPT-4、GPT-3.5 等模型。项目核心能力包括:支持多种模型(gpt-4、gpt-3.5-turbo)、提供简洁的 API 接口、兼容 Node.js 环境,并具备流式响应和对话管理功能。它解决了个人开发者或小团队在无预算情况下体验和集成 GPT-4 能力的问题,但依赖第三方渠道的稳定性,存在被屏蔽或失效的风险。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7642

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:Docker 6 步

环境要求

  • Node.js 环境(本地运行需使用 yarn 安装依赖)
  • Docker 环境(推荐用 docker run 方式运行)
  • Docker Compose(使用 docker-compose 部署时需要)
  • 必须先在项目根目录创建 .env 文件,所有运行方式都依赖它
  • 若本机无法直连目标站点,需要准备可用的 http 代理

安装与启动步骤

  1. 1获取项目代码

    把仓库克隆到本地,README 建议先 fork 一份,因为部分逆向目标站点随时可能下线。

    git clone https://github.com/xiangsx/gpt4free-ts.git
  2. 2创建 .env 文件

    在项目根目录新建 .env,填入代理、RapidAPI Key、并发数等配置;不需要代理时删除 http_proxy 这一行。

  3. 3本地安装依赖

    在项目目录下用 yarn 安装 Node 依赖,README 本地运行部分只给出了这一条安装命令。

    yarn
  4. 4Docker 方式运行

    README 推荐的方式,用 --env-file 加载 .env,并把容器 3000 端口映射到本机 3000 端口。

    docker run -p 3000:3000 --env-file .env xiangsx/gpt4free-ts:latest
  5. 5docker-compose 部署

    同样需要先创建好 .env,然后在项目目录执行后台构建并启动。

    docker-compose up --build -d
  6. 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 Keyxxxxxxxxxx
EMAIL_TYPE否临时邮箱类型,可选 temp-email、temp-email44、tempmail-loltemp-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

★ 349 2026-08-09
RWKV_APP 开源

一个应用,全平台离线跑 RWKV 聊天

Cross-platform, local-first RWKV chat built with Flutter for Android, iOS, Windows, ···

★ 133 2026-08-09
llm-x 开源

在浏览器里,像用ChatGPT一样轻松玩转本地大模型。

LLMX; Easiest 3rd party Local LLM UI for the web!

★ 297 2026-08-09
chatgpt-voice 开源

张嘴就能和 ChatGPT 聊天,解放双手的语音助手

Have a conversation with ChatGPT. Casually ⚡️

★ 169 2026-08-09
College-Enquiry-Chatbot 开源

问校园事,秒回答案,告别跑腿咨询

The College Enquiry Chatbot project is built using machine learning algorithms. The ···

★ 140 2026-08-09
cog 开源

在聊天框里直接跑命令行,运维协作快人一步

Bringing the power of the command line to chat

★ 917 2026-08-09
AChat 开源

本地优先、远程同步,企业级 AI 对话平台

AChat - An open-source/self-hosted/local-first AI platform, designed for enterprises···

★ 3257 2026-08-09
myGPTReader 开源

用 ChatGPT 和 AI 对话式阅读,让每篇文章都能聊起来

A community-driven way to read and chat with AI bots - powered by chatGPT.

★ 4397 2026-08-09
ai-bot-groupmate 开源

给 QQ 群塞一个会插话接梗的 AI 群友

Estrella Bot · QQ 群 AI 群友机器人。把 QQ 小号接给任意 OpenAI 兼容模型(本机 / Deep···

★ 104 2026-11-08