routsi documentation

One OpenAI-compatible endpoint that routes each request to the right model or agent. Get it, point an SDK at it, and let it decide.

npm install -g @muthuishere/routsi                 # npm (recommended)
# or: download a release binary from github.com/muthuishere/routsi/releases
# or: git clone ... && task build && task install   # from source

Where to go

Sections mirror the sidebar. Start top-to-bottom if you're new; jump straight to Scenarios if you just want working commands to copy.

• Install — npm, release binary, or from source.
• Quick start — config, run, first curl.
• Core concepts — auto routing, bypass, dynamic groups, sticky escalate-only.
• Who it's for — five concrete profiles and exactly what each one gets, live-verified.
• models.yaml — the full config reference.
• Routing & stickiness — dynamic groups and conversation pinning.
• How auto decides — the exact low/medium/high classification rules.
• Agents as models — devin/codex/copilot/claude as first-class models.
• Pull-workers — remote agents answer via a broker queue.
• Auth & mTLS — bearer tokens, client certs, secrets.
• Dashboard & metrics — live UI, /stats, /metrics, running as a service.
• HTTP API — endpoints and streaming behavior.
• Scenarios — copy-paste recipes, tested end to end.