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: bus-scheduling-mcp

결과의 의미

라우팅에는 두 단계가 있습니다:

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 관리를 주장하는 프로필은 루프백 기본 URL이 있는 경우에만 수락됩니다. 공개 Worker는 이 경로에 절대 포함되지 않습니다.

예제에는 YOUR_MODEL_ID가 포함되어 있습니다. 이를 계정에서 사용할 수 있는 모델과 해당 호출자 제공 프로필 사실로 교체하십시오. Nymrel은 예제에 벤치마크 주장을 포함하지 않습니다.

보안 경계

• 공개 API: 라우팅 메타데이터만, 프롬프트 또는 공급자 실행 없음, 스트리밍 256 KiB 및 100개 모델 상한, 엄격한 알 수 없는 필드 거부, Vercel 배포 전체 WAF 속도 제한(또는 Cloudflare 엣지 위치 바인딩), 정확한 소스 준비, 결정적 JSON 오류.

• 로컬 런타임: 읽기 전용 실행만, 명시적 어댑터, 제한된 공급자 이벤트/출력, 본문 없는 영수증.

• 포함되지 않음: 호스팅 키, 계정, 청구, 고객 데이터 영속성, 셸 또는 파일 시스템 쓰기 도구, 아웃리치, 구매, 배포 도구 또는 자율 부작용.

• 영수증 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 어댑터는 동일한 컴파일된 통합 스위트와 프로모션 전 미리보기 검증으로 테스트됩니다. Phase 0 증거는 현재 제품 상태가 아닌 과거 출처로 docs/PHASE0_CONTRACT.md 및 evidence/phase0-receipt.json에 남아 있습니다.

라이선스

MIT. LICENSE를 참조하십시오.