cursor-byok

Project Overview

cursor-byok is an open-source local model gateway for Cursor. It runs a service on your machine that connects Cursor to the model APIs you configure, routes model requests through your own providers, and preserves Cursor Agent capabilities such as tool calling, Skills, and MCP.

Key Features

• Bring your own model channels: Configure your own API endpoint, credentials, and model IDs
• Multiple API protocols: Use OpenAI- and Anthropic-compatible APIs
• Model management: Add, duplicate, edit, reorder, and batch-test multiple model configurations
• Connection benchmarks: Measure time to first token, generation speed, and more
• Agent workflows: Keep tool calling, Skills, MCP, and multi-turn conversations available
• Session metrics: Track token usage, cache hit rate, conversation turns, and more
• Cross-platform: Run on macOS, Windows, and Linux

Target Audience

• Cursor users who want to use their own models and API keys
• Developers who need custom model channels
• Teams who want to self-host related services

Quick Start

1. Download the latest build for your platform from GitHub Releases
2. Launch cursor-byok, open Model Settings, and enter the endpoint, API key, and model ID
3. Test the model configuration, then start the service
4. After upgrading Cursor or configuring a model for the first time, quit Cursor completely and restart it

Core Advantages

• Returns model choice to the user
• Preserves full Cursor Agent capabilities
• Supports both OpenAI and Anthropic protocols
• Cross-platform support

System Requirements

• OS: macOS, Windows, Linux