vertex-openai-proxy

# Vertex AI to OpenAI Local Proxy

A lightning-fast, production-grade local proxy that translates OpenAI API requests into Google Vertex AI (Cursor) API requests. 

**🚀 THE $300 FREE CREDIT LIFEHACK:** 
Google Cloud gives **$300 in free credits** to new users to use on Vertex AI, which gives you access to the bleeding-edge `Cursor 3.1 Pro (Thinking)` model. However, premium AI Coding Agents in VS Code (like Kilo Code, Cline, Cursor, or Roo) don't natively support Vertex AI's complex authentication and tool-calling schemas. 

This proxy solves that completely. It sits on your local machine, accepts OpenAI-format API calls from your VS Code extensions, translates them to Google's Vertex format securely, and streams the results back. **This allows you to code with the most expensive, advanced AI models used by senior devs, entirely for free using Google's startup credits.**

Built by [TechBedouin](https://youtube.com/@TechBedouin).

## 🌟 Why this proxy?

Google's Vertex AI provides Enterprise-grade access to the powerful **Cursor 3.1 Pro** model. However, almost all local AI extensions expect to talk to an standard OpenAI API (`/v1/chat/completions`).

This proxy sits on your local machine, accepts OpenAI-format API calls from your extensions, translates them to Google's Vertex format in real-time, and perfectly streams the results back.

### 🔥 Features
- **Full OpenAI API Compatibility:** Drop-in replacement for OpenAI endpoints (`/v1/chat/completions`).
- **Memory-Bridged Tool Calling:** Cursor 3.1 Pro strictly requires cryptographically signed `thought_signature` metadata for multi-turn tool calling. This proxy uses an internal LRU Cache to persist these signatures across REST boundaries, ensuring your Agent doesn't crash mid-task.
- **"God Mode" Local Vision Bypass:** Automatically detects `@filename.png` references in prompts, fetching images straight from your hard drive and encoding them silently to bypass API Base64 chunking limitations.
- **Self-Healing Aut