pjandro/OmniRoute
1
0
Fork 0
mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-08-14 19:22:32 +03:00
Code Issues Packages Projects Releases Wiki Activity

feat(providers): integrate audited free-tier gateways (#9210)

Browse Source 
* feat(providers): add Zylo UnoRouter and Poolside registries

* feat(providers): integrate audited free-tier gateways

* feat: add wave2 free-tier provider registries

* feat(providers): add Mixlayer Speka and TokenReply registries

* feat: add wave 2 free-tier provider registries

* fix: align meganova provider slug

* feat(providers): integrate wave2 free-tier gateways

* feat(providers): add Wave 3-A free-tier registries

* feat(providers): add HelyxAI Auriko and Poixe registries

* feat(providers): add Naga AI and Chat Oripe registries

* feat(providers): integrate wave3 free-tier gateways

* feat(providers): add FreeInference registry

* feat(providers): add Free.ai registry

* feat(providers): integrate wave4 free-tier gateways

* docs: synchronize provider and free-tier inventories

* refactor(providers): split audited gateway catalog

* feat(providers): add audited Void AI and HelixMind gateways

* feat(providers): finalize audited free-tier integration

* test(providers): update APIKEY split count to 229 after rebase onto release/v3.8.50

The rebase merged the release catalog (201 APIKEY providers) with the PR's
28 free-tier additions, yielding 229 total. Correct the characterization
count so the partition assertion reflects the true merged state.

---------

Co-authored-by: diegosouzapw <diegosouzapw@users.noreply.github.com>
Co-authored-by: backryun <bakryun0718@proton.me>
This commit is contained in:
Diego Rodrigues de Sa e Souza
2026-08-12 16:19:25 -03:00
committed by GitHub
parent f6ccd3cf9f
commit ecc89eef14
345 changed files with 9108 additions and 9012 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/guides/FEATURES.md
View File

@@ -18,7 +18,7 @@ Visual guide to every section of the OmniRoute dashboard.
The v3.7.x → v3.8.0 cycle added zero-config auto routing, new providers, OAuth flows, deeper resilience, and a much richer CLI experience. Headline features below — full details further in the document and in linked specs.
- 🤖 **Auto Combo / Zero-config auto-routing** — use prefixes `auto/coding`, `auto/fast`, `auto/cheap`, `auto/offline`, `auto/smart`, `auto/lkgp`. Backed by a 9-factor scoring engine and 4 curated **mode packs** (ship-fast, cost-saver, quality-first, offline-friendly)
- 🤖 **Auto Combo / Zero-config auto-routing** — use prefixes `auto/coding`, `auto/fast`, `auto/cheap`, `auto/offline`, `auto/smart`, `auto/lkgp`. Backed by a 13-factor scoring engine and 4 curated **mode packs** (ship-fast, cost-saver, quality-first, offline-friendly)
- 🆕 **Command Code provider** (#2199) — first-class registration with model catalog and quota tracking
- 🆕 **Z.AI provider** — new free-tier provider with quota labels
- 🎬 **KIE media expansion** — extended catalog including video generation models
@@ -61,7 +61,7 @@ OpenRouter connections can store a per-connection `preset` in Advanced Settings.
## 🎨 Combos
Create model routing combos with 17 strategies: priority, weighted, fill-first, round-robin, p2c (power-of-two-choices), random, least-used, cost-optimized, reset-aware, reset-window, headroom, strict-random, auto, lkgp (last-known-good-provider), context-optimized, context-relay, and **fusion** (fan out to a panel of models in parallel, then synthesize one answer via a judge). Each combo chains multiple models with automatic fallback and includes quick templates and readiness checks.
Create model routing combos with 19 public strategies: priority, weighted, round-robin, context-relay, fill-first, p2c (power-of-two choices), random, least-used, cost-optimized, reset-aware, reset-window, headroom, strict-random, auto, lkgp (last-known-good-provider), context-optimized, cache-optimized, **fusion** (fan out to a panel of models in parallel, then synthesize one answer via a judge), and **pipeline**. Each combo chains multiple models with automatic fallback and includes quick templates and readiness checks.
Recent combo improvements:

11
docs/guides/FREE_PROVIDER_RANKINGS.md
View File

@@ -1,7 +1,7 @@
---
title: "Free Provider Rankings (Arena ELO)"
version: 3.8.40
lastUpdated: 2026-06-28
version: 3.8.50
lastUpdated: 2026-08-02
---
# Free Provider Rankings (Arena ELO)
@@ -15,7 +15,8 @@ lastUpdated: 2026-06-28
## What It Is
OmniRoute aggregates 160+ providers, many of which expose a **free tier** (no-auth,
OmniRoute registers 329 providers, including 155 catalog entries marked **free/no-auth**
(no-auth,
free-tier OAuth, or free-tier API key — see the
[Free Tiers Guide](../getting-started/FREE-TIERS-GUIDE.md) and the full
[Free Tiers directory](../reference/FREE_TIERS.md)). The catch: free providers vary
@@ -237,7 +238,7 @@ provider that ships at least one strong free model.
`user_override → arena_elo → models_dev_tier → static table`). So after you connect
the top free providers, routing with `model: "auto"` (e.g. `auto/coding`) will
automatically prefer the higher-quality free models per request. See
[Auto-Combo](../routing/AUTO-COMBO.md) for the full 9-factor scoring.
[Auto-Combo](../routing/AUTO-COMBO.md) for the full 13-factor scoring.
---
@@ -247,7 +248,7 @@ provider that ships at least one strong free model.
providers, no credit card required.
- [Free Tiers directory](../reference/FREE_TIERS.md) — full catalog of free providers
and their limits.
- [Auto-Combo](../routing/AUTO-COMBO.md) — the 9-factor routing engine that consumes the
- [Auto-Combo](../routing/AUTO-COMBO.md) — the 13-factor routing engine that consumes the
same Arena ELO task-fitness data.
- [Environment variables](../reference/ENVIRONMENT.md) — `ARENA_ELO_SYNC_ENABLED` /
`ARENA_ELO_SYNC_INTERVAL` reference.

2
docs/guides/SETUP_GUIDE.md
View File

@@ -243,7 +243,7 @@ Add to your MCP settings:
}
```
**Full MCP documentation:** [MCP Server README](../../open-sse/mcp-server/README.md) — 87 tools, IDE configs, Python/TS/Go clients.
**Full MCP documentation:** [MCP Server README](../../open-sse/mcp-server/README.md) — 107 tools, IDE configs, Python/TS/Go clients.
### A2A Setup (Agent-to-Agent Protocol)

2
docs/guides/TIERS.md
View File

@@ -66,7 +66,7 @@ rate limits — circuit breaker recovers them on backoff.
Dashboard → **Tiers** → assign your providers. Defaults (from `tierDefaults.json`) are
sensible; edit when you have specific subscriptions to prioritize or providers to exclude.
Auto-Combo's 9-factor scoring also considers tier. See
Auto-Combo's 13-factor scoring also considers tier. See
[`docs/routing/AUTO-COMBO.md`](../routing/AUTO-COMBO.md).
## Telemetry

28
docs/guides/USER_GUIDE.md
View File

@@ -54,8 +54,8 @@ Complete guide for configuring providers, creating combos, integrating CLI tools
| **💰 CHEAP** | GLM-4.7 | $0.6/1M | Daily 10AM | Budget backup |
| | MiniMax M2.1 | $0.2/1M | 5-hour rolling | Cheapest option |
| | Kimi K2 | $9/mo flat | 10M tokens/mo | Predictable cost |
| **🆓 FREE** | Qoder | $0 | Unlimited | 8 models free |
| | Qwen | $0 | Unlimited | 3 models free |
| **🆓 FREE** | Qoder | $0 | Provider limits apply | Verify current catalog |
| | Qwen | $0 | Provider limits apply | Verify current catalog |
| | Kiro | $0 | ~50 credits/mo | Claude free |
---
@@ -81,12 +81,12 @@ vs. $20 + hitting limits = frustration
**Problem:** Can't afford subscriptions, need reliable AI coding
```
Combo: "free-forever"
1. if/kimi-k2.7-code (unlimited free)
Combo: "zero-cost"
1. if/kimi-k2.7-code (listed free access; rate limits may apply)
2. kr/qwen3-coder-next (Kiro free fallback)
Monthly cost: $0
Quality: Production-ready models
Quality: verify the model, limits, privacy, and SLA for your workload
```
### Case 3: "I need 24/7 coding, no interruptions"
@@ -99,9 +99,9 @@ Combo: "always-on"
2. cx/gpt-5.5 (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/deepseek-v4-flash (free unlimited)
5. if/deepseek-v4-flash (listed free access; rate limits may apply)
Result: 5 layers of fallback = zero downtime
Result: 5 fallback layers broaden resilience; upstream availability is not guaranteed
Monthly cost: $20-200 (subscriptions) + $10-20 (backup)
```
@@ -111,9 +111,9 @@ Monthly cost: $20-200 (subscriptions) + $10-20 (backup)
```
Combo: "openclaw-free"
1. if/qwen3.8-max-preview (unlimited free)
2. if/deepseek-v4-flash (unlimited free)
3. if/kimi-k2.7-code (unlimited free)
1. if/qwen3.8-max-preview (listed free access; rate limits may apply)
2. if/deepseek-v4-flash (listed free access; rate limits may apply)
3. if/kimi-k2.7-code (listed free access; rate limits may apply)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
@@ -213,7 +213,7 @@ removes its models from `/v1/models`.
#### Qoder (9 FREE models)
```bash
Dashboard → Connect Qoder → OAuth login → Unlimited usage
Dashboard → Connect Qoder → OAuth login → Access is subject to current provider limits
Models: if/qwen3.8-max-preview, if/qwen3.7-max, if/qwen3.7-plus, if/kimi-k3, if/kimi-k2.7-code, if/glm-5.2, if/deepseek-v4-pro, if/deepseek-v4-flash, if/minimax-m3
```
@@ -251,10 +251,10 @@ Use in CLI: premium-coding
```
Name: free-combo
Models:
1. if/kimi-k2.7-code (unlimited)
1. if/kimi-k2.7-code (listed free access; provider limits may apply)
2. kr/qwen3-coder-next (Kiro free fallback)
Cost: $0 forever!
Cost: currently listed as $0; terms and availability may change
```
---
@@ -1094,7 +1094,7 @@ Use the SSE URL `http://localhost:20128/api/mcp/sse` and a Bearer API key genera
### Scopes
MCP tools are grouped into 10 scopes: `analytics`, `auth`, `billing`, `combos`, `health`, `keys`, `memory`, `models`, `providers`, `system`. Each Bearer key can be limited to specific scopes — see [MCP-SERVER.md](../frameworks/MCP-SERVER.md) for the full tool catalog and [A2A-SERVER.md](../frameworks/A2A-SERVER.md) for the JSON-RPC schema.
MCP currently defines 32 named scopes. Each Bearer key can be limited to specific scopes — see [MCP-SERVER.md](../frameworks/MCP-SERVER.md) for the authoritative scope and tool inventory and [A2A-SERVER.md](../frameworks/A2A-SERVER.md) for the JSON-RPC schema.
---