Hugging Face's logo

engineofperplexity
/
gemini-openai-proxy

Model card Files Community
gemini-openai-proxy
File size: 2,154 Bytes 
44bbff3
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# Gemini ↔︎ OpenAI Proxy

Serve **Google Gemini 2.5 Pro** (or Flash) through an **OpenAI-compatible API**.  
Plug-and-play with clients that already speak OpenAI—SillyTavern, llama.cpp, LangChain, the VS Code *Cline* extension, etc.

---

## ✨ Features

| ✔ | Feature | Notes |
|---|---------|-------|
| `/v1/chat/completions` | Non-stream & stream (SSE) | Works with curl, ST, LangChain… |
| Vision support | `image_url` → Gemini `inlineData` | |
| Function / Tool calling | OpenAI “functions” → Gemini Tool Registry | |
| Reasoning / chain-of-thought | Sends `enable_thoughts:true`, streams `<think>` chunks | ST shows grey bubbles |
| 1 M-token context | Proxy auto-lifts Gemini CLI’s default 200 k cap | |
| CORS | Enabled (`*`) by default | Ready for browser apps |
| Zero external deps | Node 22 + TypeScript only | No Express |

---

## 🚀 Quick start (local)

```bash
git clone https://huggingface.co/engineofperplexity/gemini-openai-proxy
cd gemini-openai-proxy
npm ci                        # install deps & ts-node

# launch on port 11434
npx ts-node src/server.ts
Optional env vars
PORT=3000 change listen port
GEMINI_API_KEY=<key> use your own key

Minimal curl test
bash
Copy
Edit
curl -X POST http://localhost:11434/v1/chat/completions \
     -H "Content-Type: application/json" \
     -d '{
       "model": "gemini-2.5-pro-latest",
       "messages":[{"role":"user","content":"Hello Gemini!"}]
     }'
SillyTavern settings
Field	Value
API Base URL	http://127.0.0.1:11434/v1
Model	gemini-2.5-pro-latest
Streaming	On
Reasoning	On → grey <think> lines appear

🐳 Docker
bash
Copy
Edit
# build once
docker build -t gemini-openai-proxy .

# run
docker run -p 11434:11434 \
           -e GEMINI_API_KEY=$GEMINI_API_KEY \
           gemini-openai-proxy
🗂 Project layout
pgsql
Copy
Edit
src/
  server.ts        – minimalist HTTP server
  mapper.ts        – OpenAI ⇄ Gemini transforms
  chatwrapper.ts   – thin wrapper around @google/genai
  remoteimage.ts   – fetch + base64 for vision
package.json       – deps & scripts
Dockerfile
README.md
📜 License
MIT – free for personal & commercial use.