hermes-agent/website/static/api/model-catalog.json
teknium1 f2d88c820c fix(model-catalog): fall through to raw.github when Vercel 403s; swap step-3.5-flash for step-3.7-flash on OpenRouter+Nous
The docs site (Vercel) serves /docs/api/model-catalog.json behind a bot
mitigation rule that returns HTTP 403 + x-vercel-mitigated: challenge for
non-browser User-Agents — including urllib (what the CLI uses) and curl.
When that happens, get_catalog() falls back to the stale disk cache and
new model releases (Opus 4.8, etc.) never reach the /model picker even
though they're already in OPENROUTER_MODELS and the live OpenRouter API.

Adds a fallback URL chain: when the primary catalog URL fails, walk
DEFAULT_CATALOG_FALLBACK_URLS — currently the raw.githubusercontent.com
copy of the same file. GitHub raw doesn't bot-gate, so the manifest stays
reachable through Vercel firewall hiccups. Per-provider override URLs
keep their direct-fetch semantics (operators configure those specifically,
no implicit fallback).

Also swaps stepfun/step-3.5-flash for stepfun/step-3.7-flash in the
OpenRouter + Nous Portal curated picker lists. Native stepfun provider
configuration (api.stepfun.ai) is left alone — that depends on what
stepfun.ai itself serves, not what OpenRouter routes.

Test plan: 5 new TestFallbackChain tests cover primary-success,
primary-failure-fallback-success, all-fail, primary==fallback-dedup, and
end-to-end get_catalog routing through the new helper. Existing 23 tests
in test_model_catalog.py still pass (28 total). Wider tests/hermes_cli/
sweep: 5701/5701 pass.
2026-05-29 00:25:36 -07:00

233 lines
5.3 KiB
JSON

{
"version": 1,
"updated_at": "2026-05-29T06:55:44Z",
"metadata": {
"source": "hermes-agent repo",
"docs": "https://hermes-agent.nousresearch.com/docs/reference/model-catalog"
},
"providers": {
"openrouter": {
"metadata": {
"display_name": "OpenRouter",
"note": "Descriptions drive picker badges. Live /api/v1/models filters curated ids by tool-calling support and free pricing."
},
"models": [
{
"id": "anthropic/claude-opus-4.8",
"description": ""
},
{
"id": "anthropic/claude-opus-4.8-fast",
"description": "2x price, higher output speed"
},
{
"id": "anthropic/claude-opus-4.7",
"description": ""
},
{
"id": "anthropic/claude-opus-4.6",
"description": ""
},
{
"id": "anthropic/claude-sonnet-4.6",
"description": ""
},
{
"id": "moonshotai/kimi-k2.6",
"description": "recommended"
},
{
"id": "openrouter/pareto-code",
"description": "auto-routes to cheapest coder meeting openrouter.min_coding_score"
},
{
"id": "qwen/qwen3.7-max",
"description": ""
},
{
"id": "anthropic/claude-haiku-4.5",
"description": ""
},
{
"id": "openai/gpt-5.5",
"description": ""
},
{
"id": "openai/gpt-5.5-pro",
"description": ""
},
{
"id": "openai/gpt-5.4-mini",
"description": ""
},
{
"id": "openai/gpt-5.4-nano",
"description": ""
},
{
"id": "openai/gpt-5.3-codex",
"description": ""
},
{
"id": "xiaomi/mimo-v2.5-pro",
"description": ""
},
{
"id": "tencent/hy3-preview",
"description": ""
},
{
"id": "google/gemini-3-pro-image-preview",
"description": ""
},
{
"id": "google/gemini-3-flash-preview",
"description": ""
},
{
"id": "google/gemini-3.1-pro-preview",
"description": ""
},
{
"id": "google/gemini-3.1-flash-lite-preview",
"description": ""
},
{
"id": "qwen/qwen3.6-35b-a3b",
"description": ""
},
{
"id": "stepfun/step-3.7-flash",
"description": ""
},
{
"id": "minimax/minimax-m2.7",
"description": ""
},
{
"id": "z-ai/glm-5.1",
"description": ""
},
{
"id": "x-ai/grok-4.20",
"description": ""
},
{
"id": "x-ai/grok-4.3",
"description": ""
},
{
"id": "nvidia/nemotron-3-super-120b-a12b",
"description": ""
},
{
"id": "deepseek/deepseek-v4-pro",
"description": ""
},
{
"id": "openrouter/elephant-alpha",
"description": "free"
},
{
"id": "openrouter/owl-alpha",
"description": "free"
},
{
"id": "tencent/hy3-preview:free",
"description": "free"
},
{
"id": "nvidia/nemotron-3-super-120b-a12b:free",
"description": "free"
},
{
"id": "inclusionai/ring-2.6-1t:free",
"description": "free"
}
]
},
"nous": {
"metadata": {
"display_name": "Nous Portal",
"note": "Free-tier gating is determined live via Portal pricing (partition_nous_models_by_tier), not this manifest."
},
"models": [
{
"id": "anthropic/claude-opus-4.8"
},
{
"id": "anthropic/claude-opus-4.7"
},
{
"id": "anthropic/claude-opus-4.6"
},
{
"id": "anthropic/claude-sonnet-4.6"
},
{
"id": "moonshotai/kimi-k2.6"
},
{
"id": "qwen/qwen3.7-max"
},
{
"id": "anthropic/claude-haiku-4.5"
},
{
"id": "openai/gpt-5.5"
},
{
"id": "openai/gpt-5.5-pro"
},
{
"id": "openai/gpt-5.4-mini"
},
{
"id": "openai/gpt-5.4-nano"
},
{
"id": "openai/gpt-5.3-codex"
},
{
"id": "xiaomi/mimo-v2.5-pro"
},
{
"id": "tencent/hy3-preview"
},
{
"id": "google/gemini-3-pro-preview"
},
{
"id": "google/gemini-3-flash-preview"
},
{
"id": "google/gemini-3.1-pro-preview"
},
{
"id": "google/gemini-3.1-flash-lite-preview"
},
{
"id": "qwen/qwen3.6-35b-a3b"
},
{
"id": "stepfun/step-3.7-flash"
},
{
"id": "minimax/minimax-m2.7"
},
{
"id": "z-ai/glm-5.1"
},
{
"id": "x-ai/grok-4.3"
},
{
"id": "nvidia/nemotron-3-super-120b-a12b"
},
{
"id": "deepseek/deepseek-v4-pro"
}
]
}
}
}