How xtekky/gpt4free works
GPT4Free is a multi-provider LLM and media access product, exposed through a Python client, OpenAI-compatible API, optional GUI, and MCP server. A typical client request selects a model/provider, runs through provider execution and retry/response handling, and returns generated content; provider adapters connect to external services. The README also identifies local inference, media generation, and browsing/tool capabilities. Several implementation links are supported by the SOURCE INDEX or excerpts; links for unsampled subsystems are omitted rather than inferred.
Main entry points: __init__.py Python Client · service.py Client Service · OpenaiTemplate.py Provider Adapters · retry_provider.py Retry Providers
Components 26
User Interfaces
- Python Client
g4f/client/__init__.py - OpenAI API
g4f/api/run.py - Web GUI
g4f/gui/server/app.py - MCP Server
g4f/mcp/server.py
Request Routing
- Client Service
g4f/client/service.py - Provider Catalog
g4f/Provider/__init__.py - Provider Router
g4f/providers/provider_router.py - Any Provider
g4f/providers/any_provider.py - Retry Providers
g4f/providers/retry_provider.py - Config Routes
g4f/providers/config_provider.py - Model Catalog
g4f/models.py - Response Handling
g4f/providers/response.py - Configuration
g4f/config.py - Shared Types
g4f/typing.py - Diagnostics
g4f/debug.py
Provider Integrations
- Provider Runtime
g4f/providers/base_provider.py - Provider Adapters
g4f/Provider/template/OpenaiTemplate.py - Async HTTP
g4f/requests/aiohttp.py - Local Inference
g4f/Provider/local - Credentials and Cookies
g4f/cookies.py
Media and Tools
- Agent Tools
g4f/Provider/AgentTools.py - Media Generation
g4f/image/__init__.py - Media Persistence
g4f/image/copy_images.py - Web Browsing
g4f/browsing/browse.py
Other components
- Application User
- External Model Services
Connections 29
- Application User → Python Client: requests
README.md - Application User → OpenAI API: calls
README.md - Application User → Web GUI: uses
README.md - Python Client → Client Service: resolves via
g4f/client/__init__.py - Client Service → Provider Catalog: resolves provider
g4f/client/service.py - Client Service → Config Routes: checks routes
g4f/client/service.py - Client Service → Diagnostics: logs selection
g4f/client/service.py - Client Service → Model Catalog: resolves model
g4f/client/service.py - Python Client → Any Provider: dispatches through
g4f/client/__init__.py - Python Client → Retry Providers: uses
g4f/client/__init__.py - Python Client → Response Handling: returns
g4f/client/__init__.py - Provider Catalog → Provider Adapters: loads
g4f/Provider/__init__.py - Provider Router → Provider Catalog: resolves providers
g4f/providers/provider_router.py - Provider Router → Retry Providers: uses
g4f/providers/provider_router.py - Retry Providers → Provider Runtime: invokes
g4f/providers/retry_provider.py - Provider Adapters → Provider Runtime: implements
- Provider Adapters → External Model Services: requests models
- Local Inference → Provider Runtime: implements
- Python Client → Media Generation: creates media
g4f/client/__init__.py - Media Generation → Media Persistence: persists media
g4f/image/copy_images.py - MCP Server → Media Generation: uses
g4f/mcp/server.py - MCP Server → Media Persistence: copies media
g4f/mcp/server.py - MCP Server → Credentials and Cookies: uses
g4f/mcp/server.py - Python Client → Agent Tools: runs tools
g4f/client/__init__.py - Provider Adapters → Async HTTP: sends requests
- Provider Adapters → Credentials and Cookies: uses credentials
- Web Browsing → External Model Services: searches web
- Python Client → Shared Types: uses schemas
g4f/client/__init__.py - Retry Providers → Configuration: reads settings
g4f/providers/retry_provider.py