model-fallback-heuristic.yaml 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. name: model-fallback-heuristic
  2. title: "Fallback — Model Switching Heuristics"
  3. repo: https://github.com/tomkubik/hermes-fallback
  4. sha: ce150572ea10de682a2c67902b314590b55683b3
  5. version: "0.2.0"
  6. description: >-
  7. Multi-provider heuristic model fallback and automatic failover routing across all configured
  8. providers (parameter count, context window, release recency, flash tier, tool support, provider
  9. preference, and reasoning effort) — works seamlessly with or without an LLM call. Disclosure —
  10. session-start and API-error hooks rewrite fallback_providers and plugin settings in
  11. ~/.hermes/config.yaml (primary model replacement is opt-in via
  12. auto_switch_primary_when_unavailable); queries public model catalog endpoints
  13. (models.dev/api.json, openrouter.ai/api/v1/models, and
  14. inference-api.nousresearch.com/v1/portal/models) to rank candidate models and check free-tier
  15. availability; optional interactive CLI setup saves user-entered provider API keys via
  16. hermes_cli.config.save_env_value when explicitly requested.
  17. maintainer: tomkubik
  18. tier: community
  19. category: models
  20. requires_hermes: ">=0.19"
  21. docs_url: https://github.com/tomkubik/hermes-fallback#readme
  22. image: https://raw.githubusercontent.com/tomkubik/hermes-fallback/ce150572ea10de682a2c67902b314590b55683b3/assets/cover.png
  23. readme: true
  24. platforms: []
  25. capabilities:
  26. provides_tools:
  27. - fallback_heuristic_resolve
  28. - fallback_heuristic_switch
  29. - fallback_heuristic_configure
  30. - fallback_heuristic_providers
  31. provides_hooks:
  32. - on_session_start
  33. - pre_llm_call
  34. - api_request_error
  35. provides_middleware:
  36. - llm_request
  37. - llm_execution
  38. requires_env: []