{"id":13441327,"url":"https://github.com/xtekky/gpt4free","last_synced_at":"2026-05-16T00:20:13.585Z","repository":{"id":151310590,"uuid":"620936652","full_name":"xtekky/gpt4free","owner":"xtekky","description":"The official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3","archived":false,"fork":false,"pushed_at":"2026-02-20T13:01:13.000Z","size":170690,"stargazers_count":65720,"open_issues_count":5,"forks_count":13665,"subscribers_count":485,"default_branch":"main","last_synced_at":"2026-02-20T13:03:13.190Z","etag":null,"topics":["chatbot","chatbots","chatgpt","chatgpt-4","chatgpt-api","chatgpt-free","chatgpt4","deepseek","deepseek-api","deepseek-r1","gpt","gpt-4","gpt-4o","gpt4","gpt4-api","language-model","openai","openai-api","openai-chatgpt","reverse-engineering"],"latest_commit_sha":null,"homepage":"https://t.me/g4f_channel","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xtekky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"xtekky","github":["xtekky","hlohaus"],"patreon":"xtekky"}},"created_at":"2023-03-29T17:00:43.000Z","updated_at":"2026-02-20T13:01:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"98998c6c-fcf6-4a17-a415-1f3b5dc87006","html_url":"https://github.com/xtekky/gpt4free","commit_stats":null,"previous_names":[],"tags_count":429,"template":false,"template_full_name":null,"purl":"pkg:github/xtekky/gpt4free","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtekky%2Fgpt4free","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtekky%2Fgpt4free/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtekky%2Fgpt4free/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtekky%2Fgpt4free/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xtekky","download_url":"https://codeload.github.com/xtekky/gpt4free/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtekky%2Fgpt4free/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29681468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T12:30:22.644Z","status":"ssl_error","status_checked_at":"2026-02-21T12:29:55.402Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","chatbots","chatgpt","chatgpt-4","chatgpt-api","chatgpt-free","chatgpt4","deepseek","deepseek-api","deepseek-r1","gpt","gpt-4","gpt-4o","gpt4","gpt4-api","language-model","openai","openai-api","openai-chatgpt","reverse-engineering"],"created_at":"2024-07-31T03:01:32.599Z","updated_at":"2026-05-16T00:20:13.571Z","avatar_url":"https://github.com/xtekky.png","language":"Python","funding_links":["https://ko-fi.com/xtekky","https://github.com/sponsors/xtekky","https://github.com/sponsors/hlohaus","https://patreon.com/xtekky"],"categories":["Python","APIs","A01_文本生成_文本对话","Chatbots","三、GPT-4 镜像","🤖 AI \u0026 Machine Learning","ChatGPT Integrated Projects","Open API","Uncategorized","ChatGPT 开发","chatbot","HarmonyOS","Open-Source Local LLM Projects","GitHub projects","SDK, Libraries, Frameworks","Free AI Models \u0026 APIs","精选开源项目合集","chatgpt-api","Repos","GPT Security","App","Writing \u0026 Editing"],"sub_categories":["Easily blocked IP, Limit models","大语言对话模型及数据","3.5、GPT4free","Python","提示语（魔法）","Uncategorized","Github 热门项目（10k+）","Windows Manager","Python library, sdk or frameworks","Model Access","其他（平台、逆向工程）","Crack"],"readme":"# GPT4Free (g4f)\n\n[![PyPI](https://img.shields.io/pypi/v/g4f)](https://pypi.org/project/g4f) [![Docker Hub](https://img.shields.io/badge/docker-hlohaus789%2Fg4f-blue)](https://hub.docker.com/r/hlohaus789/g4f) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-red.svg)](https://www.gnu.org/licenses/gpl-3.0.txt) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/g4f?period=total\u0026units=INTERNATIONAL_SYSTEM\u0026left_color=GREY\u0026right_color=GREEN\u0026left_text=downloads)](https://pepy.tech/projects/g4f) ![GitHub Repo stars](https://img.shields.io/github/stars/xtekky/gpt4free)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://g4f.dev/docs/images/477107515-7f60c240-00fa-4c37-bf7f-ae5cc20906a1.png\" alt=\"GPT4Free logo\" height=\"200\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cspan style=\"background: linear-gradient(45deg, #12c2e9, #c471ed, #f64f59); -webkit-background-clip: text; -webkit-text-fill-color: transparent;\"\u003e\n    \u003cstrong\u003eCreated by \u003ca href=\"https://github.com/xtekky\"\u003e@xtekky\u003c/a\u003e,\u003cbr\u003e maintained by \u003ca href=\"https://github.com/hlohaus\"\u003e@hlohaus\u003c/a\u003e\u003c/strong\u003e\n  \u003c/span\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003cspan\u003eSupport the project on\u003c/span\u003e\n      \u003ca href=\"https://github.com/sponsors/hlohaus\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\n        GitHub Sponsors\n      \u003c/a\u003e\n      ❤️\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\nLive demo \u0026 docs: https://g4f.dev | Documentation: https://g4f.dev/docs\n\u003c/p\u003e\n\n---\n\nGPT4Free (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.\n\nThis README is a consolidated, improved, and complete guide to installing, running, and contributing to GPT4Free.\n\nTable of contents\n- [What’s included](#whats-included)\n- [Quick links](#quick-links)\n- [Requirements \u0026 compatibility](#requirements--compatibility)\n- [Installation](#installation)\n  - [Docker (recommended)](#docker-recommended)\n  - [Slim Docker image](#slim-docker-image)\n  - [Windows (.exe)](#windows-exe)\n  - [Python (pip / from source / partial installs)](#python-pip--from-source--partial-installs)\n- [Running the app](#running-the-app)\n  - [GUI (web client)](#gui-web-client)\n  - [FastAPI / Interference API](#fastapi--interference-api)\n  - [CLI](#cli)\n  - [Optional provider login (desktop in container)](#optional-provider-login-desktop-in-container)\n- [Using the Python client](#using-the-python-client)\n  - [Synchronous text example](#synchronous-text-example)\n  - [Image generation example](#image-generation-example)\n  - [Async client example](#async-client-example)\n- [Using GPT4Free.js (browser JS client)](#using-gpt4freejs-browser-js-client)\n- [Providers \u0026 models (overview)](#providers--models-overview)\n- [Local inference \u0026 media](#local-inference--media)\n- [Configuration \u0026 customization](#configuration--customization)\n- [Running on smartphone](#running-on-smartphone)\n- [Interference API (OpenAI‑compatible)](#interference-api-openai-compatible)\n- [Examples \u0026 common patterns](#examples--common-patterns)\n- [Contributing](#contributing)\n  - [How to create a new provider](#how-to-create-a-new-provider)\n  - [How AI can help you write code](#how-ai-can-help-you-write-code)\n- [Security, privacy \u0026 takedown policy](#security-privacy--takedown-policy)\n- [Credits, contributors \u0026 attribution](#credits-contributors--attribution)\n- [Powered-by highlights](#powered-by-highlights)\n- [Changelog \u0026 releases](#changelog--releases)\n- [Manifesto / Project principles](#manifesto--project-principles)\n- [License](#license)\n- [Contact \u0026 sponsorship](#contact--sponsorship)\n- [Appendix: Quick commands \u0026 examples](#appendix-quick-commands--examples)\n\n---\n\n## What’s included\n- Python client library and async client.\n- Optional local web GUI.\n- FastAPI-based OpenAI-compatible API (Interference API).\n- Official browser JS client (g4f.dev distribution).\n- Docker images (full and slim).\n- Multi-provider adapters (LLMs, media providers, local inference backends).\n- Tooling for image/audio/video generation and media persistence.\n\n---\n\n## Quick links\n- Website \u0026 docs: https://g4f.dev | https://g4f.dev/docs  \n- PyPI: https://pypi.org/project/g4f  \n- Docker image: https://hub.docker.com/r/hlohaus789/g4f  \n- Releases: https://github.com/xtekky/gpt4free/releases  \n- Issues: https://github.com/xtekky/gpt4free/issues  \n- Community: Telegram (https://telegram.me/g4f_channel) · Discord News (https://discord.gg/5E39JUWUFa) · Discord Support (https://discord.gg/qXA4Wf4Fsm)\n\n---\n\n## Requirements \u0026 compatibility\n- Python 3.10+ recommended.\n- Google Chrome/Chromium for providers using browser automation.\n- Docker for containerized deployment.\n- Works on x86_64 and arm64 (slim image supports both).\n- Some provider adapters may require platform-specific tooling (Chrome/Chromium, etc.). Check provider docs for details.\n\n---\n\n## Installation\n\n### Docker (recommended)\n1. Install Docker: https://docs.docker.com/get-docker/\n2. Create persistent directories:\n   - Example (Linux/macOS):\n     ```bash\n     mkdir -p ${PWD}/har_and_cookies ${PWD}/generated_media\n     sudo chown -R 1200:1201 ${PWD}/har_and_cookies ${PWD}/generated_media\n     ```\n3. Pull image:\n   ```bash\n   docker pull hlohaus789/g4f\n   ```\n4. Run container:\n   ```bash\n   docker run -p 8080:8080 -p 7900:7900 \\\n     --shm-size=\"2g\" \\\n     -v ${PWD}/har_and_cookies:/app/har_and_cookies \\\n     -v ${PWD}/generated_media:/app/generated_media \\\n     hlohaus789/g4f:latest\n   ```\nNotes:\n- Port 8080 serves GUI/API; 7900 can expose a VNC-like desktop for provider logins (optional).\n- Increase --shm-size for heavier browser automation tasks.\n\n### Slim Docker image (x64 \u0026 arm64)\n```bash\nmkdir -p ${PWD}/har_and_cookies ${PWD}/generated_media\nchown -R 1000:1000 ${PWD}/har_and_cookies ${PWD}/generated_media\n\ndocker run \\\n  -p 1337:8080 -p 8080:8080 \\\n  -v ${PWD}/har_and_cookies:/app/har_and_cookies \\\n  -v ${PWD}/generated_media:/app/generated_media \\\n  hlohaus789/g4f:latest-slim\n```\nNotes:\n- The slim image can update the g4f package on startup and installs additional dependencies as needed.\n- In this example, the Interference API is mapped to 1337.\n\n### Windows Guide (.exe)\n\n👉 Check out the Windows launcher for GPT4Free:  \n🔗 [https://github.com/gpt4free/g4f.exe](https://github.com/gpt4free/g4f.exe) 🚀  \n\n1. Download the release artifact `g4f.exe.zip` from:\n   https://github.com/xtekky/gpt4free/releases/latest\n2. Unzip and run `g4f.exe`.\n3. Open GUI at: http://localhost:8080/chat/\n4. If Windows Firewall blocks access, allow the application.\n\n### Python Installation (pip / from source / partial installs)\n\nPrerequisites:\n- Python 3.10+ (https://www.python.org/downloads/)\n- Chrome/Chromium for some providers.\n\nInstall from PyPI (recommended):\n```bash\npip install -U g4f[all]\n```\n\nPartial installs\n- To install only specific functionality, use optional extras groups. See docs/requirements.md in the project docs.\n\nInstall from source:\n```bash\ngit clone https://github.com/xtekky/gpt4free.git\ncd gpt4free\npip install -r requirements.txt\npip install -e .\n```\n\nNotes:\n- Some features require Chrome/Chromium or other tools; follow provider-specific docs.\n\n---\n\n## Running the app\n\n### GUI (web client)\n- Run via Python:\n```python\nfrom g4f.gui import run_gui\nrun_gui()\n```\n- Or via CLI:\n```bash\npython -m g4f.cli gui --port 8080 --debug\n```\n- Open: http://localhost:8080/chat/\n\n### FastAPI / Interference API\n- Start FastAPI server:\n```bash\npython -m g4f --port 8080 --debug\n```\n- If using slim docker mapping, Interference API may be available at `http://localhost:1337/v1`\n- Swagger UI: `http://localhost:1337/docs`\n\n### CLI\n- Start GUI server:\n```bash\npython -m g4f.cli gui --port 8080 --debug\n```\n\n### MCP Server\nGPT4Free now includes a Model Context Protocol (MCP) server that allows AI assistants like Claude to access web search, scraping, and image generation capabilities.\n\n**Starting the MCP server (stdio mode):**\n```bash\n# Using g4f command\ng4f mcp\n\n# Or using Python module\npython -m g4f.mcp\n```\n\n**Starting the MCP server (HTTP mode):**\n```bash\n# Start HTTP server on port 8765\ng4f mcp --http --port 8765\n\n# Custom host and port\ng4f mcp --http --host 127.0.0.1 --port 3000\n```\n\nHTTP mode provides:\n- `POST http://localhost:8765/mcp` - JSON-RPC endpoint\n- `GET http://localhost:8765/health` - Health check\n\n**Configuring with Claude Desktop:**\n\nAdd to your `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"gpt4free\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"g4f.mcp\"]\n    }\n  }\n}\n```\n\n**Available MCP Tools:**\n- `web_search` - Search the web using DuckDuckGo\n- `web_scrape` - Extract text content from web pages  \n- `image_generation` - Generate images from text prompts\n\nFor detailed MCP documentation, see [g4f/mcp/README.md](g4f/mcp/README.md)\n\n### Optional provider login (desktop within container)\n- Accessible at:\n  ```\n  http://localhost:7900/?autoconnect=1\u0026resize=scale\u0026password=secret\n  ```\n- Useful for logging into web-based providers to obtain cookies/HAR files.\n\n---\n\n## Using the Python client\n\nInstall:\n```bash\npip install -U g4f[all]\n```\n\nSynchronous text example:\n```python\nfrom g4f.client import Client\n\nclient = Client()\nresponse = client.chat.completions.create(\n    model=\"gpt-4o-mini\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello, how are you?\"}],\n    web_search=False\n)\nprint(response.choices[0].message.content)\n```\nExpected:\n```\nHello! How can I assist you today?\n```\n\nImage generation example:\n```python\nfrom g4f.client import Client\n\nclient = Client()\nresponse = client.images.generate(\n    model=\"flux\",\n    prompt=\"a white siamese cat\",\n    response_format=\"url\"\n)\nprint(f\"Generated image URL: {response.data[0].url}\")\n```\n\nAsync client example:\n```python\nfrom g4f.client import AsyncClient\nimport asyncio\n\nasync def main():\n    client = AsyncClient()\n    response = await client.chat.completions.create(\n        model=\"gpt-4o-mini\",\n        messages=[{\"role\": \"user\", \"content\": \"Explain quantum computing briefly\"}],\n    )\n    print(response.choices[0].message.content)\n\nasyncio.run(main())\n```\n\nNotes:\n- See the full API reference for streaming, tool-calling patterns, and advanced options: https://g4f.dev/docs/client\n\n---\n\n## Using GPT4Free.js (browser JS client)\nUse the official JS client in the browser—no backend required.\n\nExample:\n```html\n\u003cscript type=\"module\"\u003e\n  import Client from 'https://g4f.dev/dist/js/client.js';\n\n  const client = new Client();\n  const result = await client.chat.completions.create({\n      model: 'gpt-4.1',  // Or \"gpt-4o\", \"deepseek-v3\", etc.\n      messages: [{ role: 'user', content: 'Explain quantum computing' }]\n  });\n  console.log(result.choices[0].message.content);\n\u003c/script\u003e\n```\n\nNotes:\n- The JS client is distributed via the g4f.dev CDN for easy usage. Review CORS considerations and usage limits.\n\n---\n\n## Providers \u0026 models (overview)\n- GPT4Free integrates many providers including (but not limited to) OpenAI-compatible endpoints, PerplexityLabs, Gemini, MetaAI, Pollinations (media), and local inference backends.\n- Model availability and behavior depend on provider capabilities. See the providers doc for current, supported provider/model lists: https://g4f.dev/docs/providers-and-models\n\nProvider requirements may include:\n- API keys or tokens (for authenticated providers)\n- Browser cookies / HAR files for providers scraped via browser automation\n- Chrome/Chromium or headless browser tooling\n- Local model binaries and runtime (for local inference)\n\n---\n\n## Local inference \u0026 media\n- GPT4Free supports local inference backends. See [docs/local.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/local.md) for supported runtimes and hardware guidance.\n- Media generation (image, audio, video) is supported through providers (e.g., Pollinations). See [docs/media.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/media.md) for formats, options, and sample usage.\n\n---\n\n## Configuration \u0026 customization\n- Configure via environment variables, CLI flags, or config files. See [docs/config.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/config.md).\n- To reduce install size, use partial requirement groups. See [docs/requirements.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/requirements.md).\n- Provider selection: learn how to set defaults and override per-request at [docs/selecting_a_provider.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/selecting_a_provider.md).\n- Persistence: HAR files, cookies, and generated media persist in mapped directories (e.g., har_and_cookies, generated_media).\n\n---\n\n## Running on smartphone\n- The web GUI is responsive and can be accessed from a phone by visiting your host IP:8080 or via a tunnel. See [docs/guides/phone.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/guides/phone.md).\n\n---\n\n## Interference API (OpenAI‑compatible)\n- The Interference API enables OpenAI-like workflows routed through GPT4Free provider selection.\n- Docs: [docs/interference-api.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/interference-api.md)\n- Default endpoint (example slim docker): `http://localhost:1337/v1`\n- Swagger UI: `http://localhost:1337/docs`\n\n---\n\n## Examples \u0026 common patterns\n- Streaming completions, stopping criteria, system messages, and tool-calling patterns are documented in:\n  - [docs/client.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/client.md)\n  - [docs/async_client.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/async_client.md)\n  - [docs/requests.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/requests.md)\n- Integrations (LangChain, PydanticAI): [docs/pydantic_ai.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/pydantic_ai.md)\n- Legacy examples: [docs/legacy.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/legacy.md)\n\n---\n\n## Contributing\nContributions are welcome — new providers, features, docs, and fixes are appreciated.\n\nHow to contribute:\n1. Fork the repository.\n2. Create a branch for your change.\n3. Run tests and linters.\n4. Open a Pull Request with a clear description and tests/examples if applicable.\n\nRepository: https://github.com/xtekky/gpt4free\n\n### How to create a new provider\n- Read the guide: [docs/guides/create_provider.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/guides/create_provider.md)\n- Typical steps:\n  - Implement a provider adapter in `g4f/Provider/`\n  - Add configuration and dependency notes\n  - Include tests and usage examples\n  - Respect third‑party code licenses and attribute appropriately\n\n### How AI can help you write code\n- See: [docs/guides/help_me.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/guides/help_me.md) for prompt templates and workflows to accelerate development.\n\n---\n\n## Security, privacy \u0026 takedown policy\n- Do not store or share sensitive credentials. Use per-provider recommended security practices.\n- If your site appears in the project’s links and you want it removed, send proof of ownership to takedown@g4f.ai and it will be removed promptly.\n- For production, secure the server with HTTPS, authentication, and firewall rules. Limit access to provider credentials and cookie/HAR storage.\n\n---\n\n## Credits, contributors \u0026 attribution\n- Core creators: [@xtekky](https://github.com/xtekky) (original), maintained by [@hlohaus](https://github.com/hlohaus).\n- Full contributor graph: https://github.com/xtekky/gpt4free/graphs/contributors\n- Notable code inputs and attributions:\n  - `har_file.py` — input from [xqdoo00o/ChatGPT-to-API](https://github.com/xqdoo00o/ChatGPT-to-API)\n  - `PerplexityLabs.py` — input from [nathanrchn/perplexityai](https://github.com/nathanrchn/perplexityai)\n  - `Gemini.py` — input from [dsdanielpark/Gemini-API](https://github.com/dsdanielpark/Gemini-API) and [HanaokaYuzu/Gemini-API](https://github.com/HanaokaYuzu/Gemini-API)\n  - `MetaAI.py` — inspired by [meta-ai-api by Strvm](https://github.com/Strvm/meta-ai-api)\n  - `proofofwork.py` — input from [missuo/FreeGPT35](https://github.com/missuo/FreeGPT35)\n\nMany more contributors are acknowledged in the repository.\n\n---\n\n## Powered-by highlights\n- Pollinations AI — generative media: https://github.com/pollinations/pollinations\n- MoneyPrinter V2 — example project using GPT4Free: https://github.com/FujiwaraChoki/MoneyPrinterV2\n- For a full list of projects and sites using GPT4Free, see: [docs/powered-by.md](https://github.com/gpt4free/g4f.dev/blob/main/docs/powered-by.md)\n\n---\n\n## Changelog \u0026 releases\n- Releases and full changelog: https://github.com/xtekky/gpt4free/releases\n- Subscribe to Discord/Telegram for announcements.\n\n---\n\n## Manifesto / Project principles\nGPT4Free is guided by community principles:\n1. Open access to AI tooling and models.\n2. Collaboration across providers and projects.\n3. Opposition to monopolistic, closed systems that restrict creativity.\n4. Community-centered development and broad access to AI technologies.\n5. Promote innovation, creativity, and accessibility.\n\nhttps://g4f.dev/manifesto\n\n---\n\n## License\nThis program is licensed under the GNU General Public License v3.0 (GPLv3). See the full license: https://www.gnu.org/licenses/gpl-3.0.txt\n\nSummary:\n- You may redistribute and/or modify under the terms of GPLv3.\n- The program is provided WITHOUT ANY WARRANTY.\n\nCopyright notice\n```\nxtekky/gpt4free: Copyright (C) 2025 xtekky\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n```\n\n---\n\n## Contact \u0026 sponsorship\n- Maintainers: https://github.com/hlohaus  \n- Sponsorship: https://github.com/sponsors/hlohaus  \n- Issues \u0026 feature requests: https://github.com/xtekky/gpt4free/issues  \n- Takedown requests: takedown@g4f.ai\n\n---\n\n## Appendix: Quick commands \u0026 examples\n\nInstall (pip):\n```bash\npip install -U g4f[all]\n```\n\nRun GUI (Python):\n```bash\npython -m g4f.cli gui --port 8080 --debug\n# or\npython -c \"from g4f.gui import run_gui; run_gui()\"\n```\n\nDocker (full):\n```bash\ndocker pull hlohaus789/g4f\ndocker run -p 8080:8080 -p 7900:7900 \\\n  --shm-size=\"2g\" \\\n  -v ${PWD}/har_and_cookies:/app/har_and_cookies \\\n  -v ${PWD}/generated_media:/app/generated_media \\\n  hlohaus789/g4f:latest\n```\n\nDocker (slim):\n```bash\ndocker run -p 1337:8080 -p 8080:8080 \\\n  -v ${PWD}/har_and_cookies:/app/har_and_cookies \\\n  -v ${PWD}/generated_media:/app/generated_media \\\n  hlohaus789/g4f:latest-slim\n```\n\nPython usage patterns:\n- `client.chat.completions.create(...)`\n- `client.images.generate(...)`\n- Async variants via `AsyncClient`\n\nDocs \u0026 deeper reading\n- Full docs: https://g4f.dev/docs  \n- Client API docs: https://g4f.dev/docs/client  \n- Async client docs: https://g4f.dev/docs/async_client  \n- Provider guides: https://g4f.dev/docs/providers  \n- Local inference: https://g4f.dev/docs/local\n\n---\n\nThank you for using and contributing to GPT4Free — together we make powerful AI tooling accessible, flexible, and community-driven.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtekky%2Fgpt4free","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxtekky%2Fgpt4free","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtekky%2Fgpt4free/lists"}