Nymrel Agent

Nymrel Agent ist ein erklärbarer Multi-Modell-Router mit einem deterministischen Vertrag über eine öffentliche API, lokale CLI, MCP-Server und eine Ausführungsumgebung mit geringer Verwahrung.

Sie stellen einen Modellkatalog und explizite Anforderungen bereit. Nymrel Agent lehnt Kandidaten ab, die Gesundheits-, Risiko-, Fähigkeits-, Datengrenz-, Kontext-, Modalitäts-, Kosten- oder Latenzbeschränkungen verletzen; ordnet die zulässige Menge unter einem ausgewogenen, Qualitäts-, Kosten- oder Latenzziel; und gibt die vollständige Erklärung zurück.

Der gehostete Router akzeptiert nur Modellmetadaten. Er akzeptiert keine Prompts, Anbieteranmeldeinformationen, Dateien oder Kundenkennungen und führt keine Modellaufrufe aus.

Schnellstart

Der öffentliche Routing-Endpunkt erfordert kein Konto und keinen Schlüssel:

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

Routen Sie dieselbe Nutzlast lokal:

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

Vollständige Dokumentation: https://nymrel-agent.vercel.app/docs

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

Maschinenlesbarer Produktkontext: https://nymrel-agent.vercel.app/llms.txt

Related MCP server: bus-scheduling-mcp

Was das Ergebnis bedeutet

Das Routing hat zwei Stufen:

1. Fail-closed-Eignungsfilter lehnen inkompatible Profile mit stabilen Grundcodes ab.

2. Zulässige Profile erhalten sichtbare, ganzzahlige Bewertungskomponenten und eine deterministische Gleichstandsauflösung.

Das ausgewählte Ziel ändert explizite Gewichte. Explizite Kosten- und Latenzobergrenzen verankern auch ihre entsprechenden Bewertungskomponenten, sodass eine Änderung der nicht zusammenhängenden Katalogmitgliedschaft eine verankerte Komponente nicht allein durch Verschieben des Normalisierungsbereichs ändern kann. Wenn eine Obergrenze weggelassen wird, fällt diese Komponente auf die Normalisierung der zulässigen Menge zurück. Ohne die geschlossene v1-Antwortform zu ändern, meldet jeder Routenbeleg die gewählten Modi in decisionCodes und die numerischen Grenzen in explanation. Modellqualität, Zuverlässigkeit, Kosten, Latenz, Grenze und Fähigkeitsfakten sind vom Aufrufer bereitgestellte Nachweise; Nymrel Agent erklärt, wie es sie verwendet hat, zertifiziert sie jedoch nicht.

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

Lokales Routing ist die Standardeinstellung. --endpoint sendet die Nur-Metadaten-Nutzlast an einen gehosteten Router.

MCP

Der stdio-MCP-Server stellt zwei schreibgeschützte Tools bereit:

• route_models — validiert und routet eine nymrel.agent.route/v1-JSON-Nutzlast.

• explain_contract — gibt den stabilen Routing- und Verwahrungsgrenzvertrag zurück.

Beispielclientkonfiguration nach dem Erstellen aus dem Quellcode:

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

Kundenseitige Ausführung

v0.1 enthält einen OpenAI-Responses-Adapter für schreibgeschützte lokale Ausführungen. Die lokale Konfiguration speichert einen Umgebungsvariablennamen, niemals den Schlüsselwert:

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

Der Adapter ruft POST /v1/responses vom Rechner des Kunden auf, erfordert eine abgeschlossene Antwort, setzt store: false, begrenzt Zeit und Antwortgröße, bereinigt Providerfehler und hält Aufgaben-/Ausgabetexte aus Belegen heraus. Ein Profil, das local_only-Verwahrung beansprucht, wird nur mit einer Loopback-Basis-URL akzeptiert. Der öffentliche Worker ist nie in diesem Pfad.

Das Beispiel enthält YOUR_MODEL_ID; ersetzen Sie es und seine vom Aufrufer bereitgestellten Profilfakten durch ein Modell, das Ihr Konto verwenden kann. Nymrel liefert keine Benchmark-Behauptungen im Beispiel.

Sicherheitsgrenze

• Öffentliche API: nur Routing-Metadaten, keine Prompt- oder Providerausführung, gestreamte 256-KiB- und 100-Modell-Obergrenzen, strikte Ablehnung unbekannter Felder, WAF-Ratenbegrenzung auf Vercel-Bereitstellungsebene (oder eine Cloudflare-Edge-Standortbindung), Exakt-Quell-Bereitschaft und deterministische JSON-Fehler.

• Lokale Laufzeit: nur schreibgeschützte Ausführung, explizite Adapter, begrenzte Providerereignisse/-ausgaben, belegfreie Belege.

• Nicht enthalten: gehostete Schlüssel, Konten, Abrechnung, Kundendatenpersistenz, Shell- oder Dateisystem-Schreibtools, Öffentlichkeitsarbeit, Käufe, Bereitstellungstools oder autonome Nebenwirkungen.

• SHA-256-Werte in Belegen sind Korrelations-Digests, keine Verschlüsselungs- oder Vertraulichkeitskontrollen.

Siehe SECURITY.md für die Richtlinie zur Meldung und unterstützten Versionen.

Nymrel-Implementierungsservice

Nymrel kann nachweisgestützte Kataloge, Routing-Richtlinien, Evals, kundenseitige Adapter und operative Belege um einen echten Workflow herum konfigurieren. Gehostete Ausführung, Datenaufbewahrung, Anmeldeinformationen und schreibfähige Tools erfordern einen separaten Umfang und eine Sicherheitsüberprüfung. Preise werden auf Anfrage unter https://nymrel.com/brief bereitgestellt.

Entwicklungs- und Release-Nachweis

Erfordert Node.js 22, 23 oder 24.

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

npm run verify führt Typprüfung, die Offline-/Integrationstestsuite, den Release-Manifest- und Secret-Scan sowie einen Cloudflare-Bereitstellungs-Trockenlauf aus. Der Produktions-Vercel-Adapter wird von derselben kompilierten Integrationstestsuite und durch Vorschauverifizierung vor der Promotion getestet. Phase-0-Nachweise bleiben unter docs/PHASE0_CONTRACT.md und evidence/phase0-receipt.json als historische Herkunft, nicht als aktueller Produktstatus.

Lizenz

MIT. Siehe LICENSE.