Skip to content

kodelyx/free-gemini-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

28 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Free Gemini API Banner

πŸ”“ Free Gemini API

High-performance OpenAI-compatible Go server that bridges Google Gemini's web client. Supports text chat, image generation (Imagen 3), video generation, and music synthesis β€” all with automatic watermark removal.

✨ Features

  • πŸ’¬ Chat β€” /v1/chat/completions with SSE streaming
  • 🎨 Image Generation β€” /v1/images/generations (Imagen 3, auto watermark cleaned)
  • 🎬 Video Generation β€” Cinematic 2-10s video outputs
  • 🎡 Music Synthesis β€” YouTube Lyria-powered audio beats
  • πŸ”Œ Chrome Cookie-Sync β€” Auto session capture via browser extension
  • πŸ€– MCP Server β€” Built-in stdio MCP with retry logic, health checks & robust error handling

πŸš€ Quick Start

1. Run via Docker

docker compose up -d

API runs on http://localhost:8002, WebSocket cookie bridge on 9226.

2. Install Chrome Extension

  1. Go to chrome://extensions/ β†’ Enable Developer mode
  2. Load unpacked β†’ select gemini-extension/ folder
  3. Open gemini.google.com and login β€” cookies sync automatically

3. MCP Server (for Cursor/Claude/Antigravity IDE)

go build -o gemini-mcp mcp_server.go

Add to your MCP config:

{
  "mcpServers": {
    "flow-agent": {
      "command": "/path/to/gemini-mcp",
      "args": []
    }
  }
}

πŸ“‹ Requirements

  • Docker (for API server)
  • Chrome + Extension (for cookie sync)
  • Go 1.21+ (for MCP server compilation)

About

πŸ”“ Use Google Gemini for FREE β€” Text, Image, Video & Music Generation API. No API key needed. Built in Go.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors