fallback.py 1.3 KB

12345678910111213141516171819202122232425
  1. """``hermes fallback`` subcommand parser."""
  2. from __future__ import annotations
  3. def build_fallback_parser(subparsers) -> None:
  4. """Attach the ``fallback`` subcommand to ``subparsers``."""
  5. from hermes_cli.fallback_cmd import cmd_fallback
  6. fallback_parser = subparsers.add_parser(
  7. "fallback", help="Manage fallback providers (tried when the primary model fails)",
  8. description="Manage the fallback provider chain. Fallback providers are tried "
  9. "in order when the primary model fails with rate-limit, overload, or "
  10. "connection errors. See: "
  11. "https://hermes-agent.nousresearch.com/docs/user-guide/features/fallback-providers")
  12. fallback_subparsers = fallback_parser.add_subparsers(dest="fallback_command")
  13. fallback_subparsers.add_parser(
  14. "list", aliases=["ls"], help="Show the current fallback chain (default when no subcommand)")
  15. fallback_subparsers.add_parser(
  16. "add",
  17. help="Pick a provider + model (same picker as `hermes model`) and append to the chain")
  18. fallback_subparsers.add_parser(
  19. "remove", aliases=["rm"], help="Pick an entry to delete from the chain")
  20. fallback_subparsers.add_parser("clear", help="Remove all fallback entries")
  21. fallback_parser.set_defaults(func=cmd_fallback)