Written by @xtekky
Important
By using this repository or any code related to it, you agree to the legal notice. The author is not responsible for the usage of this repository nor endorses it, nor is the author responsible for any copies, forks, re-uploads made by other users, or anything else related to GPT4Free. This is the author's only account and repository. To prevent impersonation or irresponsible actions, please comply with the GNU GPL license this Repository uses.
Warning
"gpt4free" serves as a PoC (proof of concept), demonstrating the development of an API package with multi-provider requests, with features like timeouts, load balance and flow control.
Note
Latest version: 
Stats: 
pip install -U g4f[all]docker pull hlohaus789/g4f- For comprehensive details on new features and updates, please refer to our Releases page
- Join our Telegram Channel: 📨 telegram.me/g4f_channel
- Join our Discord Group: 💬🆕️ https://discord.gg/5E39JUWUFa
Is your site on this repository and you want to take it down? Send an email to takedown@g4f.ai with proof it is yours and it will be removed as fast as possible. To prevent reproduction please secure your API. 😉
Is a proof-of-concept API package for multi-provider AI requests. It showcases features such as:
- Load balancing and request flow control.
- Seamless integration with multiple AI providers.
- Comprehensive text and image generation support.
Explore the Visit GPT4Free on HuggingFace Space for a hosted version or Duplicate GPT4Free Space it for personal use.
- 🆕 What's New
- 📚 Table of Contents
- ⚡ Getting Started
- 💡 Usage
- 🚀 Providers and Models
- 🔗 Powered by gpt4free
- 🤝 Contribute
- 🙌 Contributors
- ©️ Copyright
- ⭐ Star History
- 📄 License
-
Install Docker: Download and install Docker.
-
Set Up Directories: Before running the container, make sure the necessary data directories exist or can be created. For example, you can create and set ownership on these directories by running:
mkdir -p ${PWD}/har_and_cookies ${PWD}/generated_images chown -R 1000:1000 ${PWD}/har_and_cookies ${PWD}/generated_images
-
Run the Docker Container: Use the following commands to pull the latest image and start the container:
docker pull hlohaus789/g4f docker run -p 8080:8080 -p 1337:1337 -p 7900:7900 \ --shm-size="2g" \ -v ${PWD}/har_and_cookies:/app/har_and_cookies \ -v ${PWD}/generated_images:/app/generated_images \ hlohaus789/g4f:latest
-
Running the Slim Docker Image: Use the following command to run the Slim Docker image. This command also updates the
g4fpackage at startup and installs any additional dependencies:docker run \ -p 1337:1337 \ -v ${PWD}/har_and_cookies:/app/har_and_cookies \ -v ${PWD}/generated_images:/app/generated_images \ hlohaus789/g4f:latest-slim \ rm -r -f /app/g4f/ \ && pip install -U g4f[slim] \ && python -m g4f --debug
-
Access the Client Interface:
- To use the included client, navigate to: http://localhost:8080/chat/ or http://localhost:1337/chat/
- Or set the API base for your client to: http://localhost:1337/v1
-
(Optional) Provider Login: If required, you can access the container's desktop here: http://localhost:7900/?autoconnect=1&resize=scale&password=secret for provider login purposes.
To ensure the seamless operation of our application, please follow the instructions below. These steps are designed to guide you through the installation process on Windows operating systems.
Installation Steps:
- Download the Application: Visit our releases page and download the most recent version of the application, named
g4f.exe.zip. - File Placement: After downloading, locate the
.zipfile in your Downloads folder. Unpack it to a directory of your choice on your system, then execute theg4f.exefile to run the app. - Open GUI: The app starts a web server with the GUI. Open your favorite browser and navigate to http://localhost:8080/chat/ to access the application interface.
- Firewall Configuration (Hotfix): Upon installation, it may be necessary to adjust your Windows Firewall settings to allow the application to operate correctly. To do this, access your Windows Firewall settings and allow the application.
By following these steps, you should be able to successfully install and run the application on your Windows system. If you encounter any issues during the installation process, please refer to our Issue Tracker or try to get contact over Discord for assistance.
- Install Python 3.10+ from python.org.
- Install Google Chrome for certain providers.
pip install -U g4f[all]How do I install only parts or do disable parts? Use partial requirements: /docs/requirements
git clone https://github.com/xtekky/gpt4free.git
cd gpt4free
pip install -r requirements.txtHow do I load the project using git and installing the project requirements? Read this tutorial and follow it step by step: /docs/git
from g4f.client import Client
client = Client()
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "Hello"}],
web_search=False
)
print(response.choices[0].message.content)Hello! How can I assist you today?
from g4f.client import Client
client = Client()
response = client.images.generate(
model="flux",
prompt="a white siamese cat",
response_format="url"
)
print(f"Generated image URL: {response.data[0].url}")
Run the GUI using Python:
from g4f.gui import run_gui
run_gui()Or, run via CLI:
python -m g4f.cli gui -port 8080 -debugLearn More About the GUI: For detailed instructions on how to set up, configure, and use the GPT4Free GUI, refer to the GUI Documentation . This guide includes step-by-step details on provider selection, managing conversations, using advanced features like speech recognition, and more.
The Interference API enables seamless integration with OpenAI's services through G4F, allowing you to deploy efficient AI solutions.
- Documentation: Interference API Docs
- Endpoint:
http://localhost:1337/v1 - Swagger UI: Explore the OpenAPI documentation via Swagger UI at
http://localhost:1337/docs
This API is designed for straightforward implementation and enhanced compatibility with other OpenAI integrations.
Run the Web UI on your smartphone for easy access on the go. Check out the dedicated guide to learn how to set up and use the GUI on your mobile device: Run on Smartphone Guide
- Client API from G4F: /docs/client
- AsyncClient API from G4F: /docs/async_client
- Requests API from G4F: /docs/requests
- File API from G4F: /docs/file
- Legacy API with python modules: /docs/legacy
We welcome contributions from the community. Whether you're adding new providers or features, or simply fixing typos and making small improvements, your input is valued. Creating a pull request is all it takes – our co-pilot will handle the code review process. Once all changes have been addressed, we'll merge the pull request into the main branch and release the updates at a later time.
- Read: Create Provider Guide
- Read: AI Assistance Guide
A list of all contributors is available here
- The
Vercel.pyfile contains code from vercel-llm-api by @ading2210 - The
har_file.pyhas input from xqdoo00o/ChatGPT-to-API - The
PerplexityLabs.pyhas input from nathanrchn/perplexityai - The
Gemini.pyhas input from dsdanielpark/Gemini-API - The
MetaAI.pyfile contains code from meta-ai-api by @Strvm - The
proofofwork.pyhas input from missuo/FreeGPT35
Having input implies that the AI's code generation utilized it as one of many sources.
This program is licensed under the GNU GPL v3
xtekky/gpt4free: Copyright (C) 2023 xtekky
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
 This project is licensed under GNU_GPL_v3.0. |
