higress-group / HiRoute
git clone https://github.com/higress-group/HiRoute.git
v0.3.1 · 11d ago
Make Codex and Claude Code subscriptions go further: a local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts.
+13
stars, 24h · #2,681
+~75
stars, 7 days · #2,783
+~320
stars, 30 days · #2,543
316
★ total · +31% this week
31
forks · 19 open issues
Star history (as recorded here)
LanguageRust
LicenseApache-2.0
Created2026-09-12 (1mo ago)
Last pushtoday
Watchers2
OwnerOrganization
GitHub topics
ai-agentsai-gatewayclaude-codecodexcoding-agentcost-optimizationdeepseekllm-gatewayllm-routerlocal-firstmodel-routingrusttask-routingtauri
Links
- GitHub: github.com/higress-group/HiRoute
- Homepage: https://hiroute.ai
- Releases · Issues · Hacker News mentions
README excerpt
简体中文 Make Codex and Claude Code subscriptions go further. A local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts. Website · Download · Documentation · Decision models · Contributing Keep using Codex, Claude Code, Qoder, Pi or DeepSeek Harness. With a difficulty-routing plan, HiRoute judges each new message: routine work such as reading code or gathering facts can go to an economical model, while design decisions and difficult fixes stay with your subscription or primary model. Subscriptions, API keys and local models are managed in one place, and each session shows which model actually ran, its usage and its cost. Independent tasks can also be delegated to other agents. Tool calls within a turn usually keep that turn's decision, so the growing context prefix stays cacheable. HiRoute decides again on a new user message, or when a context rebuild breaks the previous continuation, and may keep the same model; cache reuse depends on the provider. HiRoute runs locally as a Desktop application or a headless CLI and daemon. ## News - **Latest stable release** — macOS Desktop and Linux headless packages for x86_64 and ARM64. Release notes · Download - **2026-10-14** — Switching Models Loses Cache, Not the Savings. Website article - **2026-10-04** — GPT-6 Astra × Qwen-3.8 Flash: same quality at 90% lower cost. Website article · Experiments - HiRoute Is Open Source: Help Your Agents Do More and Your Subscriptions Go Further. Website article - All news ## Why HiRoute | | | | --- | --- | | **Route long tasks by stage** | Use the model that fits the work ahead instead of committing an entire task to one model. | | **Protect quality while saving** | Use observed competence to block risky downgrades, while task complexity creates opportunities to use economical models. | | **Keep handoffs bounded** | Enforce capability requirements, ordered candidates, and explicit exhaustion instead of silently changing behavior. | | **Learn from execution** | Retain the task category, actual model group and candidate, tool outcomes, accepted output, and optional stage competence for later decisions. | HiRoute currently provides four routing modes: fixed model, difficulty routing, custom branches, and free first. Each mode uses the plan's ordered candidates for bounded failover. It also provides agent work plans and Worker delegation; local session, usage, cost, and competence views; and a custom extension API for connecting your own decision service. ## Get started ### macOS Desktop Download the current DMG from hiroute.ai, drag HiRoute into Applications, and follow the self-signed package instructions if macOS asks for manual approval. HiRoute supports macOS 15 or later on Apple silicon (`arm64`) and Intel (`x86_64`). ### Linux headless Install the current-user CLI and daemon on Linux `x86_64` or ARM64 (`aarch64`) without `sudo`: [code] The installer verifies the published package manifest and che