mrkeyoor.com_
Tue 08 Sept 16:09 UTC
LLM Toolsevaluationupdated 08 Sept 2026

gpt4free review

GPT4Free, packaged as `g4f`, puts many hosted and local model adapters behind a Python client, web interface, OpenAI-compatible server, and MCP server. It can route text and media requests through providers with different login methods, but it does not make those providers equally reliable or grant permission to use their services.

Verdict

Our gpt4free install pulled 137 packages, occupied 507 MB, and built in 4 seconds, but it offered no test target to check the 76,608-line source tree. Use it for research and disposable experiments when provider churn is part of the work. For a production gateway, choose official provider credentials through LiteLLM or Portkey, or use Ollama when keeping inference local matters more than the provider catalog.

We ran it

Lab card: what happened when we ran gpt4freeScreenshot of gpt4free (t.me/g4f_channel)
Install✓ · 44s137 packages · 507 MB
Build✓ · 4s
Testsn/ano test script
Known vulns0(pip-audit)
Repo386 files~76,608 lines of source · 19.3 MB · 5 CI workflows

Answers from our run

Does gpt4free build from source?

Dependencies installed in 44 seconds (137 packages), and the build succeeded in 4 seconds. We cloned commit 0701d8e into a clean Debian container with 3 CPUs and no project-specific setup.

Does gpt4free have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does gpt4free have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use gpt4free?

Production teams that need contractual provider access and predictable availability: the README says behavior depends on each provider, while the legal notice calls the project educational and unaffiliated.

What are the alternatives to gpt4free?

LiteLLM, Portkey AI Gateway, Ollama. Our gpt4free install pulled 137 packages, occupied 507 MB, and built in 4 seconds, but it offered no test target to check the 76,608-line source tree.

Setup3/544-second install and 4-second build, but 507 MB and no tests
Docs4/5Many setup paths; provider ratings and linked MCP detail are missing
Community5/566,662 stars with same-day commits, release, and issue activity
Maturity3/5v8.4.4 is active, while setup metadata still says pre-alpha

Who it’s for

Developers experimenting with several model providers through one local Python interface.
Tinkerers who can repair browser automation when a provider changes its page or login flow.
Self-hosters prepared to secure an API, browser desktop, cookies, HAR files, and generated media.
MCP users who want local web search, scraping, and image-generation tools.
Builders comparing hosted adapters with Ollama-backed local inference.

Who it’s NOT for

Production teams that need contractual provider access and predictable availability: the README says behavior depends on each provider, while the legal notice calls the project educational and unaffiliated.
Operators unwilling to store browser cookies or HAR captures: several adapters use them, and the Docker guide maps a persistent directory for those files.
Buyers who require a tested release gate: our checkout had no tests script or target, so the lab skipped tests.
Minimal Python environments: our install added 137 packages and occupied 507 MB before any local model assets.
Public API hosts without their own HTTPS, authentication, and firewall controls: the README assigns all three jobs to the operator.
Teams expecting documented provider reliability scores: open issue 3519 requests them after its reporter found that some listed models failed intermittently.

Setup reality

Our sandbox installed 137 packages in 44 seconds and used 507 MB on disk, then the build step succeeded in 4 seconds. Commit 0701d8e had no tests script or target, so tests were skipped. Pip-audit reported 0 known vulnerabilities in the installed environment.

Provider requirements vary. Some routes need API keys or tokens; browser-driven routes may need Chrome, cookies, HAR files, or an interactive login through the container desktop. Local inference needs its own model runtime and hardware. Server operators should set an API key and protect stored credentials.

The 19.3 MB checkout contained 386 files and about 76,608 source lines, with 5 CI workflows, a compose file, and no top-level Dockerfile. Provider availability can change independently of a g4f release, and the slim image may update the Python package when it starts.

Version 8.4.4 fronts hosted providers and local models

GPT4Free v8.4.4 is an adapter collection with several ways in. Python callers get synchronous and asynchronous clients, browser users get a local GUI, and existing OpenAI-style applications can point at its Interference API. Provider modules cover text and media services, authenticated accounts, browser-driven sessions, and local runtimes such as Ollama.

commit 0701d8e spans 386 files, roughly 76,608 source lines, and 19.3 MB before installation. That is a large surface for a project whose value depends on many outside services. Each adapter can inherit a provider's authentication, rate limits, page changes, model list, and terms. The README acknowledges that model availability and behavior depend on provider capabilities.

A 44-second install occupies 507 MB before model assets

Our Python 3.12 sandbox installed 137 packages in 44 seconds and consumed 507 MB on disk. The build then completed successfully in 4 seconds. Those figures came from the full measured source setup, not the smaller optional groups in setup.py. The project offers api, gui, search, image, files, local, tray, webview, and slim extras for buyers who want to reduce or specialize the environment. A careful deployment should install only the paths it uses.

Pip-audit found 0 known vulnerabilities in the installed environment at commit 0701d8e. That is a useful snapshot, though it says nothing about unreported flaws, provider-side code, Chrome extensions, downloaded local models, or a future dependency resolution. Browser automation and document conversion widen the trust boundary beyond Python packages. Pin the release and lock the environment if repeatability matters, especially because the README says the slim container can update g4f and add dependencies when it starts.

What happened when we ran it

Our run used 3 CPUs, 8 GB of RAM, no secrets, and an unprivileged Debian container. Installation succeeded in 44 seconds with 137 packages, the build passed in 4 seconds, and pip-audit reported 0 known vulnerabilities. The repository had 5 CI workflow files, a compose file, no top-level Dockerfile, and no conventional tests directory. The checkout itself held 386 files and about 76,608 lines of source.

Tests were skipped because the project exposed no tests script or target in the measured setup. That is different from a passing suite. The tree contains material under etc/testing and etc/unittest, but our harness found no command it could treat as the repository test entry point. We did not call a provider, open the GUI, start the API, exercise MCP, or generate media. No response-quality, uptime, latency, or model-availability claim comes from this sandbox run.

Three credential paths require different threat models

The README describes at least 3 access patterns: provider API keys or tokens, browser cookies or HAR files, and local model runtimes. Browser-driven providers may also need Chrome or Chromium and an interactive desktop exposed on port 7900. The full Docker example persists har_and_cookies and generated_media, while the example environment lists keys for several services. Those files and variables can carry account access, so mounting them into a convenience container is a security decision.

A hosted g4f server needs controls the package does not supply by magic. The README tells production operators to add HTTPS, authentication, and firewall rules, and to restrict access to cookie and HAR storage. Its compose example maps ports 8080, 1337, and 7900; the browser desktop should not be exposed casually. An application-level G4F_API_KEY can protect the API path, but network policy, secret storage, rotation, logs, and generated-media retention still need an owner.

Provider compatibility does not guarantee provider reliability

Issue 3519, opened September 5, 2026, asks the maintainers to publish reliability ratings after its author found that some listed models did not consistently work. One report is not a benchmark, yet its request matches the README's own caveat that availability and behavior depend on provider capabilities. Provider selection and fallback can reduce individual failures, but they can also hide changes until output quality, cost, or authentication breaks in production. Test the exact route instead of trusting a broad model name.

The legal notice adds another adoption boundary. It says the repository is unaffiliated with the API providers, intended for educational use, and places compliance responsibility on the user. That language does not decide what every use is allowed to do. It tells an organization to check provider terms, account authorization, data handling, and local law before routing real prompts through scraped or session-based adapters. Official API credentials through a conventional gateway are easier to approve and support.

MCP exposes 3 tools to assistants over stdio or HTTP

The bundled MCP server gives assistants 3 documented tools: web search through DuckDuckGo, page scraping, and image generation. It runs over stdio for a local client or HTTP with a JSON-RPC endpoint and health route. The README includes a Claude Desktop configuration, so this is a real MCP integration rather than a tag attached to the project. Every tool can reach outside the assistant process, which makes host allowlists, output handling, provider credentials, and HTTP binding part of the MCP deployment.

Documentation is uneven here. The main README links readers to g4f/mcp/README.md, but that file is absent at commit 0701d8e even though the server package and example configuration exist. The main page supplies enough commands to start it, while detailed tool behavior requires reading source. This is manageable for an experiment and weak for a service granting web and media actions to an agent. Start on loopback, use the 3-tool set deliberately, and inspect each tool before wider access.

Same-day release activity accompanies fast provider churn

GitHub recorded 66,662 stars, 2 open issues and pull requests combined, and a last push on September 8, 2026. Release v8.4.4 was published earlier that day. Nearby commits removed one provider, changed browser management, adjusted page selectors, and fixed headless handling. That pace shows active maintenance and the reason maintenance is necessary: browser-backed adapters can stop working when an outside site changes. A release tag does not freeze the services behind it.

Alternatives

ProjectWhat it isPick it when
LiteLLM gh↗A multi-provider SDK and gateway centered on supported API credentials and routing.pick this instead when production routing, budgets, logs, and official provider APIs matter.
Portkey AI GatewayAn open-source gateway for routing model APIs with policy and observability controls.pick this instead when the gateway itself needs enterprise access and traffic controls.
Ollama gh↗A local model runner with a simple API and downloadable model library.pick this instead when local inference and predictable ownership beat access to many hosted adapters.

What people are saying

  1. [velocity-scout] xtekky/gpt4free

Sources

  1. GPT4Free README
  2. GPT4Free v8.4.4 release
  3. GPT4Free legal notice
  4. GPT4Free package setup at commit 0701d8e
  5. Issue 3519: provider reliability ratings
  6. GPT4Free repository

More llm tools reviews

openai-agents-python · notfair-plugin · freecad-mcp · chat-on-steroids · my-free-code · claude-cookbooks · the whole board →