dushaobindoudou/dsh-freeroute
dsh-freeroute registers a freeroute model provider backed by a pool of free-quota upstreams (OpenCode Zen / B.AI / OpenRouter / SenseNova built in): it exposes freeroute/auto failover and pinned freeroute/<upstream>/<model> picks, rotates up to eight keys per upstream, and serves the same pool to any client over a local OpenAI-compatible endpoint.
dsh-freeroute is free-tier model aggregation for DeepSeek Harness: it registers a freeroute model provider backed by a pool of free-quota upstreams (OpenCode Zen / B.AI / OpenRouter / SenseNova built in, plus remote catalogs and custom gateways). The model picker exposes freeroute/auto (automatic failover) and pinned freeroute/<upstream>/<model>; a request that hits a rate limit, a dead upstream or a lost key fails over to the next candidate before the first token reaches your session. Each upstream accepts up to eight keys and rotates them individually on AUTH/rate-limit failures, failures cool down by class (auth/config 10 min, rate limit 60 s, others exponential capped at 10 min), and a pinned single model degrades to the auto chain rather than aborting the turn. A three-layer config (builtin catalog -> remote catalog -> user patch) plus a Settings -> Models free/default tab hosts per-upstream key editing, connectivity tests and model probes, and a local OpenAI-compatible endpoint at http://127.0.0.1:<port>/freeroute/v1 lets any other agent or tool reuse the same free pool.
Install
dsh plugin --profile web add dsh-freerouteCopied verbatim from the README's Install block. npm package dsh-freeroute at 0.8.24 (registry check 2026-10-16; the registry repository field resolves back to this repo).
Compatibility
The plugin registers an LLM adapter (freeroute) rather than editing any provider block, and the host provides llm / timer while settings / credentials / subprocess / webServer / commands / agentDefaultModel are optional and degrade gracefully when absent. Keys live only in the credentials service, never in plaintext config. The README states plainly that "free" means providers' legitimate free tiers with keys you register yourself - it is not a shared-account pool and does not bypass paid APIs.
Details
- Repo: dushaobindoudou/dsh-freeroute
- Category: Models & Providers
- Stars: 15
- Version: GitHub repo dushaobindoudou/dsh-freeroute (15*); npm package dsh-freeroute at 0.8.24 (registry check 2026-10-16; the registry repository field resolves back to this repo). MIT licensed; Node.js >= 18. English README with a README.zh-CN.md Chinese translation and a CI workflow.
Alternatives
1624318455/dsh-plugin-adapter · aa2246740/dsh-antigravity-oauth · AmmarByFar/dsh-trustedrouter