Nymrel Agent

Nymrel Agent es un enrutador multimodelo explicable con un contrato determinista a través de una API pública, CLI local, servidor MCP y un entorno de ejecución de baja custodia.

Usted proporciona un catálogo de modelos y requisitos explícitos. Nymrel Agent rechaza los candidatos que violan las restricciones de salud, riesgo, capacidad, límite de datos, contexto, modalidad, costo o latencia; clasifica el conjunto elegible bajo un objetivo equilibrado, de calidad, costo o latencia; y devuelve la explicación completa.

El enrutador alojado acepta solo metadatos de modelos. No acepta prompts, credenciales de proveedor, archivos ni identificadores de cliente, y no ejecuta llamadas a modelos.

Inicio rápido

El endpoint público de enrutamiento no requiere cuenta ni clave:

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

Enrute la misma carga útil localmente:

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

Documentación completa: https://nymrel-agent.vercel.app/docs

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

Contexto del producto legible por máquina: https://nymrel-agent.vercel.app/llms.txt

Related MCP server: bus-scheduling-mcp

Qué significa el resultado

El enrutamiento tiene dos etapas:

1. Los filtros de elegibilidad de cierre ante fallos rechazan perfiles incompatibles con códigos de motivo estables.

2. Los perfiles elegibles reciben componentes de puntuación enteros y visibles y un desempate determinista.

El objetivo seleccionado cambia los pesos explícitos. Los techos explícitos de costo y latencia también anclan sus componentes de puntuación correspondientes, de modo que cambiar la pertenencia al catálogo no relacionada no puede cambiar un componente anclado simplemente moviendo el rango de normalización. Cuando se omite un techo, ese componente vuelve a la normalización del conjunto elegible. Sin cambiar la forma de respuesta v1 cerrada, cada recibo de ruta informa los modos elegidos en decisionCodes y los límites numéricos en explanation. Los hechos de calidad, fiabilidad, costo, latencia, límite y capacidad del modelo son evidencia proporcionada por el llamador; Nymrel Agent explica cómo los usó pero no los certifica.

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

El enrutamiento local es el predeterminado. --endpoint envía la carga útil de solo metadatos a un enrutador alojado.

MCP

El servidor MCP stdio expone dos herramientas de solo lectura:

• route_models — valida y enruta una carga útil JSON nymrel.agent.route/v1.

• explain_contract — devuelve el límite estable de enrutamiento y custodia.

Ejemplo de configuración de cliente después de compilar desde el código fuente:

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

Ejecución local del cliente

v0.1 incluye un adaptador de OpenAI Responses para ejecuciones locales de solo lectura. La configuración local almacena un nombre de variable de entorno, nunca el valor de la clave:

$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 -

El adaptador llama a POST /v1/responses desde la máquina del cliente, requiere una respuesta completada, establece store: false, limita el tiempo y el tamaño de la respuesta, sanea los errores del proveedor y mantiene los cuerpos de tarea/salida fuera de los recibos. Un perfil que afirma custodia local_only se acepta solo con una URL base de bucle invertido. El Worker público nunca está en esta ruta.

El ejemplo contiene YOUR_MODEL_ID; reemplácelo y sus hechos de perfil proporcionados por el llamador con un modelo que su cuenta pueda usar. Nymrel no incluye afirmaciones de referencia en el ejemplo.

Límite de seguridad

• API pública: solo metadatos de enrutamiento, sin ejecución de prompts ni de proveedor, límites de 256 KiB y 100 modelos en streaming, rechazo estricto de campos desconocidos, limitación de velocidad WAF en toda la implementación de Vercel (o un enlace de ubicación perimetral de Cloudflare), preparación de fuente exacta y errores JSON deterministas.

• Tiempo de ejecución local: solo ejecución de solo lectura, adaptadores explícitos, eventos/salida de proveedor limitados, recibos sin cuerpo.

• No incluido: claves alojadas, cuentas, facturación, persistencia de datos del cliente, herramientas de shell o escritura en sistema de archivos, divulgación, compras, herramientas de implementación o efectos secundarios autónomos.

• Los valores SHA-256 de los recibos son resúmenes de correlación, no controles de cifrado ni de confidencialidad.

Consulte SECURITY.md para la política de informes y versiones compatibles.

Servicio de implementación de Nymrel

Nymrel puede configurar catálogos respaldados por evidencia, política de enrutamiento, evaluaciones, adaptadores locales del cliente y recibos operativos en torno a un flujo de trabajo real. La ejecución alojada, la retención de datos, las credenciales y las herramientas con capacidad de escritura requieren un alcance y una revisión de seguridad separados. Los precios se proporcionan a petición en https://nymrel.com/brief.

Desarrollo y prueba de lanzamiento

Requiere Node.js 22, 23 o 24.

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

npm run verify ejecuta la comprobación de tipos, la suite de pruebas fuera de línea/integración, el manifiesto de lanzamiento y el escaneo de secretos, y una prueba en seco de implementación de Cloudflare. El adaptador de producción de Vercel se ejercita con la misma suite de integración compilada y con la verificación de vista previa antes de la promoción. La evidencia de la Fase 0 permanece en docs/PHASE0_CONTRACT.md y evidence/phase0-receipt.json como procedencia histórica, no como estado actual del producto.

Licencia

MIT. Consulte LICENSE.