首页00月度趋势榜01新星榜02增速榜03HF热榜04总表05搜索06

diegosouzapw/OmniRoute

OmniRoute 是一个免费、自托管的 AI 网关,把 Claude Code、Codex、Cursor、Cline 等 AI 编程工具统一接到本地端点 `http://localhost:20128/v1`,自动路由到 353 个提供商(其中 90 多个免费用量层)、1200 多个模型,并在配额耗尽或故障时自动降级,主打"Never stop coding"、零美元起步(宣传约每月 151 亿免费 token 池)。

语言
TypeScript
⭐ 总星标
55,922
📅 创建
早期项目
🍴 Forks
0
许可证
未标注
🔥 本月净增
+25,758
在 GitHub 打开 回到总表

配图

信息卡

项目内容
仓库diegosouzapw/OmniRoute
语言 / 许可证TypeScript / MIT
总星标⭐ 55,922
本月净增星标+25,758
榜单GitHub 官方月度趋势榜 第2名;星标增速榜 第17名

一句话定位

OmniRoute 是一个免费、自托管的 AI 网关,把 Claude Code、Codex、Cursor、Cline 等 AI 编程工具统一接到本地端点 `http://localhost:20128/v1`,自动路由到 353 个提供商(其中 90 多个免费用量层)、1200 多个模型,并在配额耗尽或故障时自动降级,主打"Never stop coding"、零美元起步(宣传约每月 151 亿免费 token 池)。

趋势解读:为什么火

各家编程代理厂商推出的官方套餐额度普遍紧张且价格不菲,开发者迫切需要一个把白嫖额度聚合起来、还能自动切换兜底的中间层。OmniRoute 用一个 OpenAI 兼容端点就把多提供商池化、故障转移和成本优化全部解决,直接命中"省钱不断线"这一刚需,因此本月净增两万五千余星、冲上月度榜第二。

核心功能拆解

架构与技术栈浅析

项目以 Node.js 22/24 LTS 运行时为基础,核心代码 100% TypeScript,前端采用 Next.js 16 + React 19 + Tailwind CSS 4;数据层用 better-sqlite3(WAL 模式)加 LowDB,含 FTS5 全文检索与向量量化记忆;测试规模可观——Vitest 下 5100 多个测试文件、39000 多条断言;另有 Electron 桌面版、Termux 安卓部署与 PWA 形态。

安装与环境要求

需要 Node.js >=22.22.2 且 <23,或 >=24 系列。最快路径是 npm 全局安装;Docker 镜像为 `diegosouzapw/omniroute:latest`;另有 pnpm、Arch AUR(omniroute-bin)、Termux、Nix/Bun 等多种安装源。

npm install -g omniroute && omniroute          # 最快方式
docker run -d --name omniroute --restart unless-stopped \
  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

快速上手示例

启动后无需任何配置即可调用:

curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

omniroute run claude --model openai/gpt-5.4   # 一条命令让 Claude Code 走网关
omniroute configure codex                     # 直接写入 Codex 自身配置

进阶使用要点

典型应用场景

同类生态位对比

相比 LiteLLM、One API 这类通用 LLM 代理,OmniRoute 明显更面向"编程工具接入"场景做了特化:Combos 组合路由、token 压缩和一键写入各类编码代理配置的能力是其差异化卖点。

资源导航

← 上一篇mattpocock/skills下一篇 →stablyai/orca