How zexadev/gemini-web2api-go works
gemini-web2api-go is a self-hosted proxy that translates OpenAI-compatible requests into Gemini web-protocol calls, with an optional MCP search endpoint and admin dashboard. The main workflow is an API client sending a chat or response request, the HTTP handlers preparing a Gemini generation, and the service returning a compatible response; video and media generation are additional product branches. Cookie and proxy pools, request persistence, and admin operations support the runtime. Some capability links come from the README because their handler implementations were not sampled.
Main entry points: server.go HTTP handlers · gemini.go Gemini protocol · app.go Runtime bootstrap · db.go Request database
Components 24
API and MCP
- HTTP handlers
internal/app/server.go - Prompt and tools
internal/app/messages.go - MCP search
internal/app/mcp.go
Gemini generation
- Gemini protocol
internal/app/gemini.go - TLS transport
internal/app/client.go - Search citations
internal/app/search.go - Media generation
internal/app/media.go - Image understanding
internal/app/vision.go - File uploads
internal/app/upload.go - Long context
internal/app/context_file.go - Video jobs
internal/app/videos.go
Accounts and routing
- Runtime bootstrap
internal/app/app.go - Cookie pool
internal/app/cookie_pool.go - Proxy pool
internal/app/proxy.go - Rate limits
internal/app/ratelimit.go - Pool scheduling
internal/app/scheduler.go - Request database
internal/app/db.go - SQL dialects
internal/app/dbdialect.go
Administration
- Admin dashboard
internal/app/admin_ui.go - Admin API
internal/app/admin.go - Cookie management
internal/app/admin_cookies.go - API key auth
internal/app/apikey.go
Other components
- API client
- Gemini web app
Connections 28
- API client → HTTP handlers: sends requests
README.md - HTTP handlers → Gemini protocol: generates replies
internal/app/server.go - Gemini protocol → Gemini web app: calls web protocol
README.md - Gemini protocol → TLS transport: uses transport
- Gemini protocol → Cookie pool: selects account
internal/app/gemini.go - Gemini protocol → Proxy pool: selects egress
internal/app/gemini.go - Gemini protocol → Long context: prepares long context
internal/app/gemini.go - Long context → File uploads: uploads attachment
internal/app/context_file.go - HTTP handlers → Prompt and tools: formats messages
- HTTP handlers → Search citations: extracts sources
- HTTP handlers → MCP search: routes MCP
- MCP search → Gemini web app: searches web
README.md - HTTP handlers → Video jobs: serves video jobs
README.md - HTTP handlers → Media generation: supports media
- HTTP handlers → Image understanding: supports vision
- Runtime bootstrap → Request database: initializes store
internal/app/app.go - Runtime bootstrap → Proxy pool: loads pool
internal/app/app.go - Gemini protocol → Rate limits: acquires slots
- Pool scheduling → Cookie pool: rotates accounts
- Pool scheduling → Proxy pool: schedules egress
- HTTP handlers → Request database: records requests
- Request database → SQL dialects: selects backend
- Runtime bootstrap → Admin dashboard: registers dashboard
internal/app/app.go - Runtime bootstrap → Admin API: registers admin APIs
internal/app/app.go - Admin API → Request database: reads statistics
internal/app/admin.go - Admin API → Proxy pool: manages proxies
- Cookie management → Cookie pool: manages accounts
- Runtime bootstrap → API key auth: protects API routes