xtekky/gpt4free

GPT4Free (g4f) – コミュニティ主導のマルチプロバイダー LLM ツールキット

何であるか – 一貫した OpenAI 互換インターフェースを通じて、幅広い大規模言語モデルおよびメディア生成サービスを呼び出せる Python パッケージ（Docker イメージおよび簡易 Web GUI としても利用可能）。公開 API、ブラウザ自動化プロバイダー、ローカル推論バックエンドを統合し、以下のインターフェースを提供します：

• Python クライアント（g4f.client / g4f.AsyncClient）
• ブラウザ側 JavaScript クライアント（g4f.dev CDN）
• オプションの FastAPI「Interference」サーバー（OpenAI REST API を模倣）
• チャットおよびメディア生成用のローカル Web GUI
• 外部アシスタント（例：Claude）が Web 検索、スクレイピング、画像生成を実行できる MCP サーバー。

主なコンポーネント

コンポーネント	目的
Python ライブラリ	Client/AsyncClient は chat.completions.create および images.generate メソッドを提供し、自動的に最適なプロバイダーを選択（model="auto"）または指定可能（例：flux, glm-5.3）。
Web GUI	http://localhost:8080/chat/ でアクセス可能なシンプルなチャット UI。run_gui() または CLI で起動可能。
FastAPI Interference API	OpenAI 互換の /v1 エンドポイントを公開。既存のツール（OpenAI を想定）に有用。Swagger UI は /docs に。
Docker イメージ	x86_64/arm64 向けのフルイメージ（hlohaus789/g4f）とスリムイメージ（…:latest-slim）。ボリュームにはブラウザの HAR/クッキーおよび生成されたメディアが保存。
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 アシスタントが Web 検索や画像生成を実行可能にする。

リソース

• ドキュメントとライブデモ: https://g4f.dev
• PyPI: https://pypi.org/project/g4f
• Docker Hub: https://hub.docker.com/r/hlohaus789/g4f
• GitHub: https://github.com/xtekky/gpt4free