hermes-vpn.yaml 2.2 KB

123456789101112131415161718192021222324252627282930313233
  1. name: hermes-vpn
  2. repo: https://github.com/Maytrella007/Hermes-VPN
  3. sha: adc6ba81afe3071223d50cde18c41e1adee25261
  4. description: "Named network exits for the agent's browser: ask it to browse from another country and it switches, then verifies by reading back the address the far end actually saw, never trusting a label. Any VPN, WireGuard config or proxy works as a local exit; gluetun containers are discovered automatically and one can be brought up on demand. VPN credentials never reach the agent, the chat or the model. Disclosure -- a root-owned helper, installed out of band by the user through a narrow exact-path sudoers rule, is the only thing that reads the credentials and writes them to a root-only file (the agent names a country, never the key), and it pulls the gluetun image pinned by digest; the helper manages gluetun Docker containers, bringing exits up and down; the plugin registers a tool_execution middleware that holds browser_* calls when no verified exit is up (the kill switch, and optional cross-provider failover); it verifies exits by calling public IP-geolocation services (ipinfo, ifconfig.co, ip2location, cloudflare); credential entry is CLI-only, with no model tool for it -- `hermes vpn provider <name> --set` (interactive) or `--from-ref`, which resolves a WireGuard config from pass/gopass or a host file host-side and never returns it to the model; opening a .onion needs `hermes vpn allow-onion`, a terminal command a person runs (no model tool) that turns off Hermes's own internal-address check so onion names resolve and restarts Hermes, and the plugin never writes that setting itself; the active profile comes from the plugin context (ctx.profile_name), not a private core import."
  5. maintainer: Maytrella007
  6. tier: community
  7. category: web
  8. requires_hermes: ">=0.22.0"
  9. docs_url: https://github.com/Maytrella007/Hermes-VPN#readme
  10. version: "0.3.0"
  11. platforms:
  12. - linux
  13. readme: true
  14. capabilities:
  15. provides_tools:
  16. - net_exits
  17. - net_use
  18. - net_where
  19. - net_harden
  20. - net_places
  21. - net_lock
  22. - net_failover
  23. - net_tor_connect
  24. - net_new_circuit
  25. - net_doctor
  26. - net_providers
  27. - net_provider_setup
  28. - net_open
  29. - net_close
  30. provides_hooks: []
  31. provides_middleware:
  32. - tool_execution
  33. requires_env: []