skills.rest
CHENHUI-X
CHENHUI-XCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hermes-peer-networking

Configure peer-to-peer networking between Hermes gateway instances via api_server and peer protocol.

Updated Jul 3, 2026
Search Tags:#multi-agent#ssh tunnel#gateway#hermes#api server#vps deployment#peer networking
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-peer-networking-chenhui-x
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-peer-networking
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/autonomous-ai-agents/hermes-peer-networking
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-peer-networking-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Connecting two Hermes agent gateways across servers fails in confusing ways: peer dm returns 404 when pointed at the wrong port, api_server silently binds to 127.0.0.1, cloud firewalls block new ports, and gateway restarts get intercepted by self-protection. This Skill provides the exact configuration steps, port layout, and troubleshooting playbook for linking Hermes gateways over the standard api_server + peer protocol. ## Core Features & Use Cases - Dual-side peer setup: Configure api_server (host 0.0.0.0, custom port, API_SERVER_KEY) on the new node and register it from the host with hermes peer add, then verify with hermes peer dm. - Cloud firewall handling: Detect the cloud provider (GCP/AWS metadata endpoints), attempt self-service firewall rules via gcloud SDK and metadata tokens, and fall back to SSH reverse tunnels when permissions are insufficient. - Troubleshooting playbook: Distinguish peer dm timeouts from channel failures via /health checks, work around gateway restart self-protection with at-scheduled scripts, and fix streaming truncation and multi-node config drift. - Use Case: You bought a new VPS and want a second Hermes agent to talk to your main one. Follow the checklist to enable api_server on both sides, exchange peer registrations, and verify a bidirectional closed loop. ## Quick Start Set up peer networking between my main Hermes gateway and the new VPS so the two agents can exchange messages.

Frequently Asked Questions about hermes-peer-networking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect two Hermes gateways on different servers?▼

Enable the api_server platform on the new node with host 0.0.0.0 and a chosen port, set API_SERVER_KEY in .env, then run hermes peer add with the remote URL and key from the host. Verify with hermes peer dm and a curl to the /health endpoint.

Why does hermes peer dm return 404?▼

A 404 means the request hit the a2a port (default 9900) instead of api_server, or api_server is not running or still bound to 127.0.0.1. The peer protocol only uses the OpenAI-compatible api_server HTTP endpoints, not the a2a JSON-RPC platform.

How do I open a GCP firewall port without admin scopes?▼

Install the gcloud SDK, obtain a token from the metadata server, and test the compute API to confirm the 403 scope limitation. If self-service fails, use an SSH reverse tunnel with a systemd service so the remote peer reaches the host via 127.0.0.1 without touching the firewall.

Why does hermes peer dm time out even though the channel works?▼

The remote agent processes one conversation at a time, so peer dm requests queue while it handles another chat. Check the channel directly with curl to the /health endpoint; if it responds, the request is merely queued and a longer timeout will succeed.

How do I restart a remote Hermes gateway blocked by self-protection?▼

Commands containing the restart string are intercepted even over SSH. Write the restart command into a script file and schedule it with at now plus one minute, then verify with systemctl is-active and the port health check.

What should I check when the server IP address changes?▼

Update the DNS A record via the Cloudflare API, adjust tunnel service configs and peer add URLs to the new IP, and re-verify both directions with curl health and a reverse peer dm. Domain-based addressing keeps clients unaffected by IP migrations.

Related Skills

Explore More Software Engineering Skills→
paarths-collabpaarths-collab
13

hermes-memory

Configure Hermes memory on a self-hosted agent over SSH.

Community
Advanced
Xipher-LabsXipher-Labs
6

syncthing-cli

Configure Syncthing folders on a remote hub via REST API over SSH.

Official
Intermediate
GitnappGitnapp

sing-box-node-discovery

Discover and verify sing-box proxy nodes from generated configurations and subscription sources.

Community
Advanced
ldmrepoldmrepo
3

a2a-protocol

Build AI agents that communicate via the Agent2Agent protocol using JSON-RPC.

Community
Advanced