xtekky /gpt4free

The official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3

★ 67,063⑂ 13,458👁 483⑃ 1,159● 2,063▤ 583
PythonGPL-3.0Created 2023-03-29t.me/g4f_channel
Download: Release v8.9.3Release-8.9.3 ↓8.9.32026-11-11
+5
Daily
+46
Weekly
67,063
stars
13,458
forks
483
watchers
1,159
prs
2,063
issues
583
releases

README

GPT4Free (g4f)

    !GitHub Repo stars


  


  




  
    Created by @xtekky, maintained by @hlohaus
  


Support the project on
      
        GitHub Sponsors
      
      ❤️


Live demo & docs: https://g4f.dev | Documentation: https://g4f.dev/docs


---

GPT4Free (g4f) is a community-driven project that aggregates multiple accessible providers and interfaces to make working with modern LLMs and media-generation models easier and more flexible. GPT4Free aims to offer multi-provider support, local GUI, OpenAI-compatible REST APIs, and convenient Python and JavaScript clients — all under a community-first license.

This README is a consolidated, improved, and complete guide to installing, running, and contributing to GPT4Free.

Table of contents
- What’s included
- Quick links
- Requirements & compatibility
- Installation
  - Docker (recommended)
  - Slim Docker image
  - Sandbox desktop (Docker)
  - Windows (.exe)
  - Python (pip / from source / partial installs)
- Running the app
  - GUI (web client)
  - FastAPI / Inference API
  - CLI
  - Optional provider login (desktop in container)
- Using the Python client
  - Synchronous text example
  - Image generation example
  - Async client example
- Using GPT4Free.js (browser JS client)
- Providers & models (overview)
- Local inference & media
- Configuration & customization
- Running on smartphone
- Inference API (OpenAI‑compatible)
- Examples & common patterns
- Contributing
  - How to create a new provider
  - How AI can help you write code
- Security, privacy & takedown policy
- Credits, contributors & attribution
- Powered-by highlights
- Changelog & releases
- Manifesto / Project principles
- License
- Contact & sponsorship
- Appendix: Quick commands & examples

---

 What’s included
- Python client library and async client.
- Optional local web GUI.
- FastAPI-based OpenAI-compatible API (Inference API).
- Official browser JS client (g4f.dev distribution).
- Docker images (full and slim).
- Multi-provider adapters (LLMs, media providers, local inference backends).
- Tooling for image/audio/video generation and media persistence.

---

 Quick links
- Website & docs: https://g4f.dev | https://g4f.dev/docs  
- PyPI: https://pypi.org/project/g4f  
- Docker image: https://hub.docker.com/r/hlohaus789/g4f  
- Releases: https://github.com/xtekky/gpt4free/releases  
- Issues: https://github.com/xtekky/gpt4free/issues  
- Community: Telegram (https://telegram.me/g4f_channel) · Discord News (https://discord.gg/5E39JUWUFa) · Discord Support (https://discord.gg/qXA4Wf4Fsm)

---

 Related projects
- g4f-go – Self-contained Go launcher for g4f (downloads CPython + g4f on demand; includes the g4f-go sandbox launcher for Docker, Podman and udocker)
- remote_desktop – WebRTC-based remote desktop host/viewer
- sandbox-desktop – TigerVNC + Xfce + noVNC desktop in Docker with preinstalled coding agents (menu/tool list, start script, Dockerfile)

---

 Requirements & compatibility
- Python 3.10+ recommended.
- Goo

Top issues

Discussions

Latest release

Release v8.9.3 v8.9.3 2026-11-11
What's Changed
 Fix Windows Python runtime extraction by @hlohaus with @Copilot in https://github.com/xtekky/gpt4free/pull/3560
 Restore API dependencies in unittest CI by @hlohaus with @Copilot in https://github.com/xtekky/gpt4free/pull/3563
 Fix idle browser cleanup by @hlohaus with @Copilot in https://github.com/xtekky/gpt4free/pull/3561
 Add Keenable to browsing APIs (keyless search + markdown fetch) by @KGKallasmaa in https://github.com/xtekky/gpt4free/pull/3556

 New Contributors
 @KGKallasmaa made their first contribution in https://github.com/xtekky/gpt4free/pull/3556

Full Ch

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON