Proxima

Shows active maintenance signals

Follow these steps to configure and connect Proxima to your local environment.

1. Prerequisites

2. Install & Start

# Clone the repository
git clone https://github.com/Zen4-bit/Proxima.git
cd Proxima

# Install dependencies & start
npm install
npm start

💡 Windows Users: You can also download and run the latest .exe installer directly from the Releases page.

Once the desktop app opens:

1. Session mode: Log into ChatGPT, Claude, Gemini, or Perplexity in their respective tabs.
2. BYOK mode: Click Settings and paste your custom API keys or local host addresses.

3. Connect to Your Editor (MCP)

Add this server configuration block to your editor's MCP configuration settings (for example, in Cursor under Settings -> Features -> MCP):

{
  "mcpServers": {
    "proxima": {
      "command": "node",
      "args": [
        "C:/absolute/path/to/Proxima/src/mcp/index.js"
      ]
    }
  }
}

💡 Tip: You can copy the exact configuration block with your machine's absolute paths directly from the Settings ➔ MCP Configuration tab inside the Proxima desktop app window.

In late 2025, I hit a massive roadblock with AI coding tools. Outdated training data caused coding models to frequently hallucinate, guess wrong solutions, and ruin codebases. I tried setting up local agents using Model Context Protocol (MCP) APIs, but the results were disappointing. The API responses were subpar and inaccurate, all while running up a bill for every single prompt.

That’s when a wild idea struck: What if we could turn actual web-based models—like ChatGPT, Gemini, Claude, and Perplexity—into local MCP servers? By routing queries directly through free, logged-in browser accounts, I could give my local agents access to frontier reasoning models. No expensive API keys required.

Proxima was born as a personal utility. I used it heavily for months to streamline my own work with no plans to open-source it. However, seeing other developers struggle with the same API costs and model hallucinations, I decided to share it. Proxima was created to provide a local, privacy-focused routing engine that connects development tools to active sessions without requiring paid subscriptions or API plans.

• API Subscription Fatigue: Stacking multiple AI subscriptions (ChatGPT Plus, Claude Pro, Perplexity Pro) adds up fast.
• Costly Development Keys: Querying raw API endpoints directly from code editor extensions drains credits quickly on large codebases.
• Local-Model Privacy: When running fully local models via Ollama or LM Studio, your code never leaves your machine — no cloud provider, no data exposure.
• Fragmented Tooling: Constantly switching between browser windows, terminals, and editor panels disrupts your cognitive coding flow.

The Solution: Proxima

Proxima serves as a local development gateway that centralizes and runs all your AI models together on 127.0.0.1. By handling protocol translation and session routing in the background, it enables your coding agents and development clients to interact with multiple advanced providers or offline engines as a single, standard local endpoint.