🚀 Hyperagent Local API Proxy

---

Tip

New to Hyperagent? Sign up using the referral link: https://hyperagent.com/refer/KEBGPXKE to unlock access to next-generation models!

A high-performance, cross-platform, OpenAI-compatible proxy server for Hyperagent.com. This proxy dynamically redirects API requests to Hyperagent's backend, allowing you to use advanced models (including Claude Opus 4.8, GPT 5.6, Gemini 3.5, Grok 4.5, and more) directly within your favorite developer environments and tools such as OpenCode, Continue, Cursor, or custom API clients.

---

⚡ Prerequisites

To capture session cookies correctly, you must have at least one Chromium-based browser installed on your system:

• 💻 Microsoft Edge (Recommended)
• 🌐 Google Chrome
• 🦁 Brave Browser
• 📦 Chromium

Note

Firefox is supported, but its CDP (Chrome DevTools Protocol) remote debugging mode is experimental.

---

📦 Quick Installation

Install the lightweight Python dependencies required to run the server:

pip install fastapi uvicorn httpx playwright
playwright install chromium

---

💻 Running the Launcher

You can start the interactive console directly on Linux or Windows by executing:

python3 start.py

🔍 Launch Pipeline Sequence

1. Platform Detection: The launcher automatically checks whether it is running on Linux or Windows.
2. Quota/Session Reset: Prompts you to clear cookies in case you ran out of model quota or want to sign in with a different account.
3. API Key Setup: Interactively asks if you want to enforce a security API key (leave blank to accept any key).
4. Browser Autodiscovery: Scans your system, identifies all installed browsers, and lets you choose which one to open.
5. Countdown Sync: Launches your browser in debugging mode and counts down to allow you to log in to https://hyperagent.com.
6. Split-Screen Dashboard: Renders local/global IPs, ports, and reference instructions. Press any key to reveal live traffic logs.
7. Reset Hotkey: Hit Ctrl + N while logs are active to instantly reset cookies, restart, and sign in again.

---

🛠️ OpenCode Desktop Configuration

Follow these steps to configure the proxy inside your OpenCode Desktop client:

1️⃣ Open Configuration File

Locate and open your local configuration file:

• Linux/macOS: ~/.config/opencode/opencode.jsonc
• Windows: %APPDATA%\opencode\opencode.jsonc

2️⃣ Add Hyperagent Provider

Insert the following provider block under the "provider" object:

"provider": {
  "hyperagent": {
    "name": "Hyperagent Proxy",
    "npm": "@ai-sdk/openai-compatible",
    "options": {
      "baseURL": "http://localhost:<PORT>/v1",
      "apiKey": "<YOUR_API_KEY>"
    },
    "models": {
      "opus-latest": { "name": "Claude Opus 4.8" },
      "sonnet-5": { "name": "Claude Sonnet 5" },
      "gpt-5.6-sol": { "name": "GPT 5.6 Sol" },
      "gemini-3.5-flash": { "name": "Gemini 3.5 Flash" },
      "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
      "grok-4.5": { "name": "Grok 4.5" }
    }
  }
}

Important

• Replace <PORT> with the random port displayed in the launcher terminal.
• Replace <YOUR_API_KEY> with your enforced key (or any string if key enforcement is disabled).

3️⃣ Usage inside OpenCode

Once saved, you can use the models by selecting them in the OpenCode dropdown menu, or referencing them in your configuration settings using the format: hyperagent/opus-latest or hyperagent/gpt-5.6-sol.

---

🤖 Supported Models

Provider	OpenCode Model Identifier	Hyperagent Engine
Anthropic	hyperagent/opus-latest	Claude Opus 4.8
Anthropic	hyperagent/sonnet-5	Claude Sonnet 5
Anthropic	hyperagent/haiku-4	Claude Haiku 4.5
Anthropic	hyperagent/fable	Fable 5
OpenAI	hyperagent/gpt-5.6-sol	GPT 5.6 Sol (Reasoning)
OpenAI	hyperagent/gpt-5.6-terra	GPT 5.6 Terra
OpenAI	hyperagent/gpt-5.6-luna	GPT 5.6 Luna
Google	hyperagent/gemini-3.5-flash	Gemini 3.5 Flash
DeepSeek	hyperagent/deepseek-v4-pro	DeepSeek V4 Pro
xAI	hyperagent/grok-4.5	Grok 4.5
Alibaba	hyperagent/qwen3.7-plus	Qwen 3.7 Plus
Moonshot	hyperagent/kimi-k2.6	Kimi K2.6
Zhipu	hyperagent/glm-5.2-fast	GLM 5.2 Fast
Other	hyperagent/fugu-ultra	Fugu Ultra