This project provides a self-hostable API proxy that unifies access to GPT/ChatGPT, Grok/xAI, and Gemini web capabilities. It targets developers and power users seeking an OpenAI-compatible interface for these services, simplifying integration and enabling account management within a single deployment.

How It Works

The system employs a FastAPI backend and a Next.js web management interface. It acts as a reverse proxy, abstracting the underlying web interactions of various AI models into standard API endpoints, primarily mimicking the OpenAI API structure. Key features include dynamic account pooling for GPT, Grok, and Gemini, support for Gemini's native API, and Grok's image generation/editing features. Provider modules (GPT, Grok, Gemini) allow for independent maintenance and integration.

Quick Start & Requirements

Deployment is primarily via Docker (CLI or Compose). The default login secret is admin. The Docker image includes necessary components like Chromium for the Browser Bridge. Users may need to configure proxy URLs if containers require host network access. Access is available at http://localhost:83 (service) and http://localhost:83/v1 (API base URL).

Highlighted Details

• Unified API: Offers OpenAI-compatible endpoints (/v1/chat/completions, etc.) and Gemini native API.
• Account Management: Robust pooling for GPT, Grok, Gemini accounts, including remote injection and tier-aware selection.
• Grok Integration: Supports Grok app-chat for text/image generation/editing, with advanced network profiles and Cloudflare bypass attempts (FlareSolverr, Browser Bridge).
• Image Capabilities: Handles image generation and editing for GPT and Grok.
• Data Management: Supports local, WebDAV, Git storage, and R2 backups.

Maintenance & Community

The project acknowledges inspiration from grok2api and chatgpt2api. Community discussion and feedback are welcomed on the linux.do forum.

Licensing & Compatibility

The project is explicitly stated to be for personal learning, technical research, and non-commercial exchange only. Commercial resale, mass abuse, or use violating upstream terms of service are strictly prohibited. Users assume all risks, including account restrictions or bans. This licensing restricts commercial use and integration into closed-source products.

Limitations & Caveats

This project relies on reverse-engineered web interfaces, prone to upstream changes. Cloudflare/WAF bypass attempts (FlareSolverr, Browser Bridge, Turnstile solver) are "best effort" and not guaranteed. Users assume all risks, including account bans and legal issues, and are responsible for adhering to upstream service terms.