The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
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: []