Hermes (赫尔墨斯) is this project's Network Operations Agent. Named after the Greek god of roads, crossings, and messengers, Hermes' overall job is to handle network connectivity problems — keeping your connections to the outside world alive and fast, diagnosing and fixing whatever gets in the way. Proxy forwarding is just one slice of that; the same mindset applies to any network issue you'd rather not babysit by hand.
Today Hermes ships with these capabilities:
- Real-traffic node testing — verifies whether each proxy node can actually carry traffic, not just whether TCP reaches the server (catches expired credentials, failed handshakes, and nodes that can't reach the internet).
- Smart node selection — picks the fastest usable node by latency and bandwidth, with three strategies: latency-only, speed-only, or a hybrid that leads with bandwidth and falls back on latency.
- Automatic failover — the moment the current node degrades, Hermes switches to a better one; when all nodes go down, it refreshes subscriptions and retries.
- Flexible routing — sends specific domains (GitHub, OpenAI, Google …) through specific nodes while everything else uses the default.
This repository is the Hermes Agent project — the agent's identity, capabilities, and operating playbook. The tooling itself lives in a separate repository:
| Repository | Purpose |
|---|---|
| xhqing/XPilot | The XPilot CLI tool — a Python CLI that makes it easy to use Xray-core, invoked as the xpilot command. All of Hermes' proxy capabilities are implemented here. |
The tool and all of its documentation live in the separate XPilot repository:
- Installation & usage: see XPilot/README.md
- 中文安装与使用文档: XPilot/README_cn.md
git clone https://github.com/xhqing/XPilot.git
cd XPilot
pip install -e .
xpilot --helpRun the commands yourself, or hand them to your AI assistant — either way, Hermes does the work.
This project is licensed under the MIT License.
Copyright (c) 2026 All Contributors.
If you reuse or redistribute any part of this project, please:
- Retain the above copyright notice and the MIT license text.
- Credit the project by linking back to its source.
Project URL: https://github.com/xhqing/NetOpsAgent