Keyway

A lightweight self-hosted LLM routing gateway with OpenAI & Anthropic dual-protocol support.

English | 中文

Keyway routes LLM requests from any OpenAI/Anthropic-compatible client (Claude Code, Cursor, OpenAI SDK, etc.) to multiple upstream providers — all through a single self-issued db_sk_ API key.

Quick Start

pip

pip install keyway-router

# Generate a secret and create .env
python -c "import secrets; print('KEYWAY_SECRET=' + secrets.token_urlsafe(48))" > .env
echo "KEYWAY_ADMIN_TOKEN=my-admin-token" >> .env

# Run
keyway
# → http://localhost:9233

Docker

cd docker
cp .env.example .env   # edit: set KEYWAY_SECRET and KEYWAY_ADMIN_TOKEN
docker compose up -d
# → http://localhost:9233

From source

git clone https://github.com/DeconBear/keyway.git
cd keyway
pip install -e ".[dev]"
cp .env.example .env   # edit: set KEYWAY_SECRET (required) and KEYWAY_ADMIN_TOKEN
python -m keyway

Desktop app (Windows)

pip install -e ".[dev]"
pip install -r keyway-desktop/requirements.txt
python keyway-desktop/main.py
# or: cd keyway-desktop && pyinstaller Keyway.spec  → dist/Keyway.exe

Data and secrets persist under %APPDATA%\Keyway. See keyway-desktop/README.md.

Logo / icon assets live in src/keyway/web/assets/ and keyway-desktop/keyway.ico. Regenerate with:

python scripts/generate_logo_assets.py

Next Steps

• First-time setup (add providers, routes, keys): see Getting Started
• Multi-provider + Claude Code walkthrough: see Multi-Provider Setup
• Auto-select, adapter, fusion modes: see Multi-Mode Processing
• Upstream key pool + user quotas: see Key Pool
• Full API reference: see API Reference
• Architecture & development: see Architecture

License

MIT — see LICENSE.