xtekky/gpt4free

GPT4Free (g4f) – 社区驱动的多提供商 LLM 工具包

是什么 – 一个 Python 包（也提供 Docker 镜像和轻量级 Web GUI），可通过单一的 OpenAI 兼容接口调用多种大语言模型和媒体生成服务。它整合了公共 API、浏览器自动化提供商和本地推理后端，通过以下方式提供服务：

• Python 客户端（g4f.client / g4f.AsyncClient）
• 浏览器端 JavaScript 客户端（g4f.dev CDN）
• 可选的 FastAPI「Interference」服务器，模拟 OpenAI REST API
• 本地 Web GUI，用于聊天和媒体生成
• MCP 服务器，允许其他助手（如 Claude）调用网络搜索、网页抓取或图像生成。

核心组件

组件	目的
Python 库	Client/AsyncClient 提供 chat.completions.create 和 images.generate 方法，可自动选择最佳提供方（model="auto"），或指定提供方（如 flux, glm-5.3）。
Web GUI	简单的聊天界面，可通过 http://localhost:8080/chat/ 访问。可通过 run_gui() 或 CLI 启动。
FastAPI Interference API	暴露 OpenAI 兼容的 /v1 端点，适用于期望 OpenAI 的现有工具。Swagger UI 在 /docs。
Docker 镜像	适用于 x86_64/arm64 的完整镜像（hlohaus789/g4f）和精简镜像（…:latest-slim）。卷可存储浏览器 HAR/cookies 和生成的媒体。
MCP 服务器	JSON-RPC/HTTP 服务，为外部 AI 代理提供 web_search、web_scrape 和 image_generation 工具。
提供方适配器	g4f/Provider/ 下的代码实现了与 OpenAI 兼容端点、PerplexityLabs、Gemini、MetaAI、Pollinations（媒体）以及本地模型运行时等服务的连接。

如何开始

1. 安装 – pip install -U g4f[all]（或拉取 Docker 镜像）。
2. 运行 –
   • GUI：python -m g4f.cli gui --port 8080
   • API：python -m g4f --port 8080
   • MCP：g4f mcp --http --port 8765
3. 调用 API – Python 示例代码：

   from g4f.client import Client
   c = Client()
   resp = c.chat.completions.create(model="auto",
                                    messages=[{"role":"user","content":"Hello!"}])
   print(resp.choices[0].message.content)
   

   该库会自动选择可用的最佳提供方。

为何重要 – 它降低了实验多种 LLM 服务的门槛，无需管理多个 SDK 或 API 密钥。通过提供 OpenAI 兼容层，现有代码库（如 LangChain、Pydantic-AI 等）可仅做最小修改，切换到免费或社区托管的后端。

许可与社区 – GPL-v3 许可，鼓励开放协作。开发由 @xtekky（创建者）和 @hlohaus（维护者）主导，拥有活跃的 Discord/Telegram 社区，并可通过 GitHub 获得赞助支持。

典型用例

• 快速原型开发可回退到任意可达模型的聊天机器人。
• 通过 Pollinations 等提供方生成图像、音频、视频等媒体。
• 运行自托管的 OpenAI 兼容端点，用于内部工具。
• 通过 MCP 服务器，使其他 AI 助手能够执行网络搜索或生成图像。

资源

• 文档与实时演示：https://g4f.dev
• PyPI：https://pypi.org/project/g4f
• Docker Hub：https://hub.docker.com/r/hlohaus789/g4f
• GitHub：https://github.com/xtekky/gpt4free