geminicli2api
A FastAPI proxy that transforms Google's Gemini CLI into OpenAI-compatible and native Gemini API endpoints for easy integration.
What is geminicli2api?
Gemini CLI to API Proxy is a FastAPI-based server that converts Google's Gemini CLI tool into standard API endpoints. It provides both OpenAI-compatible and native Gemini API interfaces, allowing developers to integrate Gemini's AI capabilities into applications using familiar API patterns. The proxy enables access to Google's free Gemini API quota through a standardized interface.
Developers and teams building AI-powered applications who want to use Google's Gemini models through API interfaces compatible with OpenAI's format or direct Gemini API calls.
It provides a drop-in replacement for OpenAI's API while leveraging Google's free Gemini quota, offers both streaming and multimodal support, and is containerized for easy self-hosting. The proxy eliminates the need to adapt tools specifically for Gemini's CLI, enabling broader integration.
Overview
Gemini CLI to API Proxy is a FastAPI-based server that converts the Gemini CLI tool into standard API endpoints. It enables developers to use Google's free Gemini API quota through familiar OpenAI API interfaces or direct Gemini API calls, making it simple to integrate Gemini capabilities into existing applications.
Key Features
- OpenAI-Compatible API — Drop-in replacement for OpenAI's chat completions API, allowing seamless integration with tools expecting OpenAI's format.
- Native Gemini API — Direct proxy to Google's Gemini API, supporting all its endpoints and features.
- Streaming Support — Real-time streaming responses for both API formats, enabling interactive applications.
- Multimodal Support — Handles text and image inputs, leveraging Gemini's multimodal capabilities.
- Authentication Flexibility — Supports multiple auth methods including Bearer tokens, Basic auth, query parameters, and Google API headers.
- Model Variants — Automatically creates model variants with Google Search grounding and thinking/reasoning controls.
- Docker Ready — Containerized for easy deployment and includes Hugging Face Spaces compatibility.
Philosophy
The project aims to bridge the gap between Google's Gemini CLI and the broader ecosystem of AI tools by providing a standardized, easy-to-deploy API layer that maintains compatibility with popular interfaces.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
