gemini-business2api  by Dreamy-rain

OpenAI-compatible API for Gemini Business

Created 1 month ago
593 stars

Top 55.0% on SourcePulse

GitHubView on GitHub
Project Summary

Gemini Business2API offers an OpenAI-compatible API layer for Google's Gemini Business models. It targets developers and users needing to integrate Gemini's advanced multimodal and generative features into existing OpenAI API-reliant applications. The key benefit is enabling seamless adoption of Gemini Business capabilities, including load balancing and image generation, without major architectural changes.

How It Works

This project acts as a proxy, translating Gemini Business API calls into an OpenAI-compatible RESTful interface. It supports multiple Gemini accounts, distributing requests via round-robin or failover. Core features include streaming output, advanced multimodal input processing (handling 100+ file types like images, PDFs, Office docs, audio, video via URL/Base64), and configurable image generation. A built-in web management panel simplifies configuration, with optional PostgreSQL for persistent storage.

Quick Start & Requirements

Installation is recommended via deployment scripts (deploy.sh/deploy.bat). Manual setup involves cloning, building frontend (npm install/build), creating a Python venv, installing dependencies (pip install -r requirements.txt), and running python main.py after configuring .env. Docker is also supported. Prerequisites include Git, Node.js/npm, and Python. Configuration requires ADMIN_KEY; PostgreSQL can be enabled via DATABASE_URL. Access management panel at http://localhost:7860/.

Highlighted Details

  • Full OpenAI API compatibility.
  • Multi-account load balancing with failover.
  • Extensive multimodal input support (images, PDFs, Office, audio, video, code).
  • Image generation and image-to-image capabilities.
  • Integrated web management panel.
  • Optional PostgreSQL persistence.

Maintenance & Community

The project acknowledges contributions via pull requests and references related community discussions. Specific community channels or a formal roadmap are not detailed.

Licensing & Compatibility

Released under the MIT License. Crucially, it is strictly for learning and research purposes, prohibited for commercial use. Users must retain attribution and source link.

Limitations & Caveats

The primary limitation is the strict prohibition of commercial use, confining deployment to non-commercial, educational, or research contexts. Updates on platforms like HuggingFace may require re-deployment.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
30
Issues (30d)
29
Star History
566 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.