OmniRoute 本地安装与启动验证

本页面面向第一次接触 OmniRoute 的 HagiCode 用户：先用最短路径把本地服务跑起来，再验证 http://localhost:20128/v1 可用，并确认 Dashboard 与 API 都已经正常启动。

安装前准备

本机已安装 Node.js。建议先完成安装 Node.js。
预留可访问的本地端口 20128，避免被其他服务占用。
准备至少一个你要通过 OmniRoute 统一接入的上游模型提供方账号。
计划接入 HagiCode、CLI 或 SDK 时，先把“Dashboard 地址”和“API Base URL”区分清楚：
- Dashboard：http://localhost:20128
- OpenAI 兼容 Base URL：http://localhost:20128/v1

本地安装与启动

推荐先走全局 npm 安装路径：

npm install -g omniroute
omniroute

启动后，按下面的顺序检查：

打开浏览器访问 http://localhost:20128，确认 Dashboard 可以正常加载。
在 Dashboard 中进入 Endpoints 页面，创建或复制一个 API Key。
记下稍后要提供给工具的 Base URL：http://localhost:20128/v1。

启动后验证

验证一：确认模型目录可读

先把刚才在 Endpoints 页面拿到的 Key 放进环境变量：

export OMNIROUTE_API_KEY="替换为你在 Endpoints 页面复制的 Key"

然后请求 /v1/models：

curl http://localhost:20128/v1/models \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}"

如果返回模型列表，说明 OpenAI 兼容端点和鉴权已经可用。

验证二：发一次最小聊天请求

curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为 /v1/models 返回的模型 ID",
    "messages": [
      { "role": "user", "content": "Reply with ok." }
    ]
  }'

这一步的重点不是提示词，而是确认你选择的模型已经能从 OmniRoute 正常路由出去。

下一步

安装 Node.js

AI Agent CLI 安装

OmniRoute 上游项目