gpt4free AI技能包

Requirements & compatibility

• Python 3.10+ recommended.
• Google Chrome/Chromium for providers using browser automation.
• Docker for containerized deployment.
• Works on x86_64 and arm64 (slim image supports both).
• Some provider adapters may require platform-specific tooling (Chrome/Chromium, etc.). Check provider docs for details.

---

Installation

Docker (recommended)

1. Install Docker: https://docs.docker.com/get-docker/ 2. Create persistent directories: - Example (Linux/macOS):

     mkdir -p ${PWD}/har_and_cookies ${PWD}/generated_media
     sudo chown -R 1200:1201 ${PWD}/har_and_cookies ${PWD}/generated_media
     

   docker pull hlohaus789/g4f
   

   docker run -p 8080:8080 -p 7900:7900 \
     --shm-size="2g" \
     -v ${PWD}/har_and_cookies:/app/har_and_cookies \
     -v ${PWD}/generated_media:/app/generated_media \
     hlohaus789/g4f:latest
   

Slim Docker image (x64 & arm64)

mkdir -p ${PWD}/har_and_cookies ${PWD}/generated_media
chown -R 1000:1000 ${PWD}/har_and_cookies ${PWD}/generated_media

docker run \
  -p 1337:8080 -p 8080:8080 \
  -v ${PWD}/har_and_cookies:/app/har_and_cookies \
  -v ${PWD}/generated_media:/app/generated_media \
  hlohaus789/g4f:latest-slim

Python Installation (pip / from source / partial installs)

Prerequisites: - Python 3.10+ (https://www.python.org/downloads/) - Chrome/Chromium for some providers.

Install from PyPI (recommended):

pip install -U g4f[all]

Partial installs - To install only specific functionality, use optional extras groups. See docs/requirements.md in the project docs.

Install from source:

git clone https://github.com/xtekky/gpt4free.git
cd gpt4free
pip install -r requirements.txt
pip install -e .

Notes: - Some features require Chrome/Chromium or other tools; follow provider-specific docs.

---

Windows Guide (.exe)

👉 Check out the Windows launcher for GPT4Free: 🔗 https://github.com/gpt4free/g4f.exe 🚀

1. Download the release artifact g4f.exe.zip from: https://github.com/xtekky/gpt4free/releases/latest 2. Unzip and run g4f.exe. 3. Open GUI at: http://localhost:8080/chat/ 4. If Windows Firewall blocks access, allow the application.

Examples & common patterns

• Streaming completions, stopping criteria, system messages, and tool-calling patterns are documented in:
• docs/client.md
• docs/async_client.md
• docs/requests.md
• Integrations (LangChain, PydanticAI): docs/pydantic_ai.md
• Legacy examples: docs/legacy.md

---

Appendix: Quick commands & examples

Install (pip):

pip install -U g4f[all]

Run GUI (Python): ```bash python -m g4f.cli gui --port 8080 --debug

Optional provider login (desktop within container)

- Accessible at:

  http://localhost:7900/?autoconnect=1&resize=scale&password=secret
  

---

Configuration & customization

• Configure via environment variables, CLI flags, or config files. See docs/config.md.
• To reduce install size, use partial requirement groups. See docs/requirements.md.
• Provider selection: learn how to set defaults and override per-request at docs/selecting_a_provider.md.
• Persistence: HAR files, cookies, and generated media persist in mapped directories (e.g., har_and_cookies, generated_media).

---

FastAPI / Interference API

- Start FastAPI server:

python -m g4f --port 8080 --debug

Interference API (OpenAI‑compatible)

• The Interference API enables OpenAI-like workflows routed through GPT4Free provider selection.
• Docs: docs/interference-api.md
• Default endpoint (example slim docker): http://localhost:1337/v1
• Swagger UI: http://localhost:1337/docs

---

Or using Python module

python -m g4f.mcp

**Starting the MCP server (HTTP mode):**