Nymrel Agent

Nymrel Agent 是一个可解释的多模型路由器，在公共 API、本地 CLI、MCP 服务器和低托管执行框架之间提供一份确定性契约。

您提供模型目录和明确要求。Nymrel Agent 会拒绝违反健康、风险、能力、数据边界、上下文、模态、成本或延迟约束的候选模型；在平衡、质量、成本或延迟目标下对合格集合进行排序；并返回完整解释。

托管路由器仅接受模型元数据。它不接受提示词、提供商凭据、文件或客户标识符，也不执行模型调用。

快速开始

公共路由端点无需账户或密钥：

curl -sS https://nymrel-agent.vercel.app/v1/route \
  -H "content-type: application/json" \
  --data-binary @examples/route-request.json

在本地路由相同的负载：

npm ci
npm run compile
node dist/src/bin/nymrel-agent.js route --file examples/route-request.json

完整文档：https://nymrel-agent.vercel.app/docs

OpenAPI 3.1：https://nymrel-agent.vercel.app/openapi.json

机器可读的产品上下文：https://nymrel-agent.vercel.app/llms.txt

Related MCP server: semantic-runtime

结果的含义

路由分为两个阶段：

1. 失败关闭的资格过滤器会拒绝不兼容的配置文件，并给出稳定的原因代码。

2. 符合条件的配置文件会获得可见的整数分数组件和确定性的平局决胜。

所选目标会改变显式权重。显式的成本和延迟上限也会锚定其对应的分数组件，因此更改无关的目录成员资格不会仅仅通过移动归一化范围来改变已锚定的组件。当省略上限时，该组件回退到合格集合归一化。在不改变封闭的 v1 响应形状的情况下，每个路由回执都会在 decisionCodes 中报告所选模式，并在 explanation 中报告数值边界。模型质量、可靠性、成本、延迟、边界和能力事实是调用方提供的证据；Nymrel Agent 解释它如何使用这些证据，但不认证它们。

CLI

nymrel-agent route --file PAYLOAD.json [--endpoint https://host]
nymrel-agent models doctor [--config CONFIG.json]
nymrel-agent run --config CONFIG.json (--task TEXT | --task-file FILE|-)
nymrel-agent contract
nymrel-agent demo

本地路由是默认设置。--endpoint 将仅元数据的负载发送到托管路由器。

MCP

stdio MCP 服务器暴露两个只读工具：

• route_models — 验证并路由 nymrel.agent.route/v1 JSON 负载。

• explain_contract — 返回稳定的路由和托管边界。

从源码构建后的示例客户端配置：

{
  "mcpServers": {
    "nymrel-agent": {
      "command": "node",
      "args": ["/absolute/path/to/nymrel-agent/dist/src/bin/nymrel-agent-mcp.js"]
    }
  }
}

客户本地执行

v0.1 包含一个 OpenAI Responses 适配器，用于只读的本地运行。本地配置存储环境变量名，绝不存储密钥值：

$env:OPENAI_API_KEY = "set-this-in-your-secret-aware-shell"
node dist/src/bin/nymrel-agent.js run --config examples/openai-local-config.example.json --task-file -

该适配器从客户机器调用 POST /v1/responses，要求完成响应，设置 store: false，限制时间和响应大小，清理提供商错误，并将任务/输出主体排除在回执之外。声称 local_only 托管的配置文件仅在接受回环 base URL 时被接受。公共 Worker 绝不在此路径中。

示例包含 YOUR_MODEL_ID；请将其及其调用方提供的配置文件事实替换为您的账户可以使用的模型。Nymrel 不在示例中提供基准声明。

安全边界

• 公共 API：仅路由元数据，无提示词或提供商执行，流式 256 KiB 和 100 模型上限，严格拒绝未知字段，Vercel 部署级 WAF 速率限制（或 Cloudflare 边缘位置绑定），精确来源就绪，以及确定性 JSON 错误。

• 本地运行时：仅只读执行，显式适配器，有界提供商事件/输出，无主体回执。

• 不包括：托管密钥、账户、计费、客户数据持久化、shell 或文件系统写入工具、外联、购买、部署工具或自主副作用。

• 回执 SHA-256 值是关联摘要，不是加密或机密性控制。

参见 SECURITY.md 了解报告和支持版本政策。

Nymrel 实施服务

Nymrel 可以围绕真实工作流配置基于证据的目录、路由策略、评估、客户本地适配器和运营回执。托管执行、数据保留、凭据和可写工具需要单独的范围和安全审查。定价可按需提供，请访问 https://nymrel.com/brief。

开发和发布证明

需要 Node.js 22、23 或 24。

npm ci
npm run verify
npm pack --dry-run
git show --check --oneline HEAD

npm run verify 运行类型检查、离线/集成测试套件、发布清单和秘密扫描，以及 Cloudflare 部署试运行。生产 Vercel 适配器由相同的编译集成套件和提升前的预览验证进行测试。阶段 0 证据保留在 docs/PHASE0_CONTRACT.md 和 evidence/phase0-receipt.json 下，作为历史来源，而非当前产品状态。

许可证

MIT。参见 LICENSE。