router README

The project's README from github.com/weave-os/router. As one markdown file: README.md.

Group 1(1)

One endpoint. Every model. Always the right one.

A drop-in proxy for Anthropic, OpenAI, and Gemini that picks the best model for every request: using a tiny on-box embedder, not a vibes-based prompt.

Weave Badge Go Tests License: ELv2 Managed deployment

Built by Weave: The #1 engineering intelligence platform, loved by Robinhood, PostHog, Reducto, and hundreds of others.


What it does

Point Claude Code, Codex, Cursor, or your own app at localhost:8080. The router:

30-second quickstart

The fastest way: point Claude Code, Codex, opencode, or pi at the hosted Weave Router with one command. No clone, no Docker, no Postgres.

npx @weave-os/router

That's it. The installer asks which tool (Claude Code, Codex, opencode, or pi), walks you through scope (user vs. project), grabs a router key, and wires the right config file. Other flavors:

npx @weave-os/router --claude              # skip the picker, Claude Code
npx @weave-os/router --codex               # skip the picker, OpenAI Codex CLI
npx @weave-os/router --opencode            # skip the picker, opencode
npx @weave-os/router --pi                  # skip the picker, pi + Loom UI
npx @weave-os/router --scope project       # per-repo, commits settings.json (or .codex/ / opencode.json)
npx @weave-os/router --local               # self-hosted localhost:8080
npx @weave-os/router --base-url https://router.acme.internal
npx @weave-os/[email protected]                 # pin a version

Requires Node ≥ 18 (Claude Code, opencode, and pi paths also need jq). Full flag reference: install/npm/README.md.

The npm package is published as @weave-os/router. The former @workweave/router package remains available as a compatibility alias and continues to receive the same releases.

Or: self-host the whole stack

If you want the router (and dashboard) running on your own box:

# 1. Drop a provider key in. OpenRouter is the recommended baseline.
echo "OPENROUTER_API_KEY=sk-or-v1-..." >> .env.local

# 2. Set a dashboard password. Without one, inference still runs but
# dashboard a

router (weave-os/router)

Searching Database…

5.6K ·GitHub
Что это такое?Прокси-сервер, который подключается без доработок и направляет каждый промпт от вашего агента для программирования или приложения к лучшей доступной модели среди Anthropic, OpenAI, Gemini и открытых моделей через OpenRouter. Стоимость инференса снижается на 40–70% простой заменой адреса API.
Это библиотека, которую я подключаю, или сервер, на который я направляю запросы?Это автономный прокси-сервер на Go. Вы направляете Claude Code, Codex, Cursor или своё приложение на localhost:8080 (или на размещённый эндпоинт), а не встраиваете библиотеку.
Как мне его запустить?Самый быстрый путь — установщик одной командой, который подключает Claude Code, Codex, opencode или pi к размещённому Weave Router. Клонировать репозиторий, ставить Docker или Postgres не нужно. Чтобы развернуть полный стек у себя, добавьте ключ провайдера в .env.local и запустите через Docker Compose.
Что нужно установить перед установкой?Для быстрого установщика нужен Node >=18, а также jq для путей установки Claude Code, opencode и pi. Если вы разворачиваете у себя, нужен API-ключ провайдера; рекомендуется OpenRouter как базовый вариант.
В чём подвох, если развернуть его у себя?Самостоятельное развёртывание означает настройку собственного ключа провайдера и пароля к панели. Инференс продолжает работать даже без пароля, но тогда панель остаётся незащищённой.
Куда попадают мои ключи API провайдеров?Ключи хранятся на вашей машине и по умолчанию шифруются при хранении (BYOK). Они не передаются Weave и не сохраняются им.
Как роутер на самом деле решает, какую модель использовать?Кластерный оценщик, основанный на подходе Avengers-Pro, классифицирует каждый запрос к API провайдера и выбирает для него лучшего подключённого провайдера. Он заменяет классификатор промптов, работающий на интуиции. Маршрутизация происходит для каждого действия, а не для каждой реплики в диалоге.
Работает ли он с открытыми моделями вроде DeepSeek или Qwen?Да, он может направлять запросы к DeepSeek, Kimi, GLM, Qwen, Llama и Mistral через OpenRouter или любой эндпоинт, совместимый с OpenAI, наряду с Anthropic, OpenAI и Gemini.
Могу ли я видеть, какие запросы делает роутер?Да, он из коробки выдаёт трассировки OTLP. Их можно смотреть в панели Weave или передавать в Honeycomb, Datadog, Grafana или любой другой инструмент, совместимый с OTLP.
Creator
weave-os
Size
29 MB
Stars
5.6K
Updated
CommitOct 17
Age
5mo
Commits · 90 Days