| 123456789101112131415161718192021222324252627282930313233 |
- name: hermes-vpn
- repo: https://github.com/Maytrella007/Hermes-VPN
- sha: adc6ba81afe3071223d50cde18c41e1adee25261
- 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."
- maintainer: Maytrella007
- tier: community
- category: web
- requires_hermes: ">=0.22.0"
- docs_url: https://github.com/Maytrella007/Hermes-VPN#readme
- version: "0.3.0"
- platforms:
- - linux
- readme: true
- capabilities:
- provides_tools:
- - net_exits
- - net_use
- - net_where
- - net_harden
- - net_places
- - net_lock
- - net_failover
- - net_tor_connect
- - net_new_circuit
- - net_doctor
- - net_providers
- - net_provider_setup
- - net_open
- - net_close
- provides_hooks: []
- provides_middleware:
- - tool_execution
- requires_env: []
|