gpt4free
免费聚合 GPT-4/Claude/DeepSeek 等 30+ AI 模型，支持 Docker 一
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
免费聚合 GPT-4/Claude/DeepSeek 等 30+ AI 模型，支持 Docker 一
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
图1：GPT4Free 项目封面
你是否曾因为 OpenAI 的 API 账单望而却步？你是否想在自己的应用里接入 GPT-4、Claude、DeepSeek 等顶级大模型，却不想掏一分钱？GPT4Free（简称 g4f）正是为解决这个问题而生——它是一个完全免费、社区驱动的 Python 工具包，通过聚合数十个第三方 AI 服务接口，让开发者可以零成本调用市面上几乎所有主流大语言模型。
GPT4Free 最初由开发者 @xtekky 在 2023 年发起，最初的口号简单直接——"免费用 GPT-4"。当时 OpenAI 的 GPT-4 API 价格高昂，普通开发者和个人用户根本用不起。xtekky 通过封装多个第三方网站的免费 GPT-4 接口，让任何人都能用 Python 代码免费调用 GPT-4。
这个项目迅速在 GitHub 上走红，GitHub Stars 从 0 一路飙升到超过 66,000。2024 年，核心维护工作由 @hlohaus 接手，他重构了整个代码库，转而采用更稳定的 Provider 架构，支持 Groq、Lambdax、Monica 等新兴免费 API 提供商，同时引入了 Docker 容器化、OpenAI 兼容 API、MCP 服务器等企业级功能。项目也从最初的"薅羊毛工具"演变为一个有完整生态的 AI 调用基础设施。
GPT4Free 不是一个单一模型的封装，而是一个多 Provider 聚合层。它支持的模型涵盖：
用户无需注册任何账号，无需获取任何 API Key，只需要一行 Python 代码就能切换使用不同的模型：
from g4f import Client
client = Client()
response = client.chat.completions.create(model="gpt-4o", messages=[{"role": "user", "content": "Hello!"}])
如果某个 Provider 不可用，g4f 会自动重试或切换到下一个可用 Provider，用户完全不感知底层细节。
对于已经基于 OpenAI API 开发的应用，g4f 提供了一个 OpenAI 兼容的 REST API（Interference API）。只需将 base URL 改为 http://localhost:8080/v1，就能把现有应用的 API Key 替换成免费的 g4f 调用：
from openai import OpenAI
client = OpenAI(base_url="http://localhost:8080/v1", api_key="not-needed")
这意味着 LangChain、AutoGen、AnythingLLM 等基于 OpenAI API 构建的 AI 应用，可以几乎零成本迁移到 g4f。
g4f 自带一个基于 FastAPI + Web 前端的本地 Web 界面，访问 http://localhost:8080/chat/ 即可使用。界面支持模型切换、对话历史、多轮对话等常用功能。此外，它还内置了 MCP Server，允许 Claude Desktop 等 AI 助手直接调用 g4f 的网页搜索、内容抓取、图片生成等工具。
图2：GPT4Free Logo
g4f 的架构设计围绕 Provider 抽象层展开。g4f/providers/ 目录下每个 .py 文件对应一个 Provider 实现，定义了如何与特定 AI 服务商的 API 通信。这种插件化架构使得添加新 Provider 非常简单——只需要写一个 Python 类，实现几个标准接口即可。
项目还包含：
g4f/api/ — FastAPI 服务器，实现 OpenAI 兼容接口g4f/gui/server/ — Web UI 后端g4f/mcp/ — MCP Server 实现g4f/client/ — Python 同步/异步客户端g4f/local/ — 本地推理后端（如 Ollama）核心依赖包括 curl_cffi（高性能 HTTP 请求）、httpx（异步 HTTP）、selenium（浏览器自动化，部分 Provider 需要）。项目支持 Python 3.10+，提供完整的类型注解。
如果你只想快速体验，Docker 方式是最低门槛——一行命令启动完整 Web UI：
docker run -p 8080:8080 -p 7900:7900 \
--shm-size="2g" \
hlohaus789/g4f:latest
打开 http://localhost:8080/chat/ 即可使用。Slim 镜像（latest-slim）仅 2GB，适合资源受限的环境。
纯 Python 安装同样简单：pip install -U g4f[all]，然后 python -m g4f.cli gui 启动 Web 界面。
不过需要注意：部分 Provider 依赖 Chrome/Chromium 浏览器进行自动化操作，Windows 用户建议直接下载 .exe 打包版本，避免配置浏览器的麻烦。
GPT4Free 并非没有争议。首先，免费 Provider 的稳定性无法保证——第三方网站可能随时修改接口或关闭免费访问，g4f 团队需要持续维护各个 Provider 的适配代码，用户体验会有波动。
其次，数据隐私是需要考虑的问题。使用 g4f 时，你的对话数据会经过第三方 Provider 的服务器，这些 Provider 的隐私政策各不相同。如果处理敏感数据，建议使用 g4f.local 配合 Ollama 进行本地推理，完全不依赖外部服务。
第三，项目从 GPL-3.0 许可转变为 Proprietary License 的过程也引发了一些社区讨论——部分早期用户对商业化方向表示关注。
GPT4Free 存在和活跃的意义远超其本身作为一个工具的价值。它持续对商业 AI 服务商的价格策略形成压力——GPT-4 API 价格从 2023 年的每千 token 0.03 美元已大幅下降，Groq 等竞品也纷纷推出低价的免费层级。g4f 证明了市场对低成本 AI 调用的强烈需求，同时也为开发者提供了一个绝佳的实验平台，用于快速测试不同模型、对比效果、构建原型。
GitHub Stars 超过 66,000，PyPI 月下载量持续增长，这个项目已经成为开源 AI 工具链中一个不可忽视的存在。无论你是 AI 爱好者想体验最新模型，还是开发者想在产品中低成本集成 AI 能力，GPT4Free 都值得一试。