Xiaoma AI Hermes Chinese Enhancement Pack
A one-command Chinese localization patch for Hermes Desktop, TUI and CLI, auto-matched to your Hermes version so Chinese users can read every screen.
- Source repo
- fresh-claw/hermes-zh-cn
- Stars
- ★ 18
- Last updated
- 3mo ago
- License
- MIT
- Primary language
- Shell
- FA score
- Insufficient evidence
At a glance
- Works with
- Platform-specific
- You'll need
- Typical use
- Chinese newcomers to Hermes who cannot read the English startup screen and quick commands.
- Main limitation
- Only useful within the Hermes ecosystem; it does nothing for other agent frameworks.
- Website
- useai.live/hermes ↗ set on GitHub
- Maintenance
- Commits in the last 6 monthslast commit 2026-08-22latest release v2026.05.26.1 (2026-05-27)
- Source review
- Insufficient evidence 8 safety controls not found
What does this agent do, and when should you use it?
The Xiaoma AI Hermes Chinese Enhancement Pack (fresh-claw/hermes-zh-cn) is a localization patch and installer for Hermes Desktop, the Hermes Agent TUI, and the Hermes CLI. The intended flow is that the user sends one sentence to Hermes, which reads the useai.live/hermes page and follows its installation guide. The installer detects or installs the official desktop app first, identifies the local Hermes version within 4 seconds, selects a matching pack for 0.15.x, 0.14.x, or 0.13.x, and falls back to a legacy compatibility pack otherwise. After verifying SHA256 checksums, the patch installs to ~/.xiaoma-hermes/current and modifies Hermes program files such as hermes_cli/banner.py and ui-tui sources (with backup) to localize the startup banner, quick commands, gateway status, and approval prompts. The project is MIT-licensed and runs on Windows, macOS, Linux, and WSL2.
The repository consists of installer entry points under web/ and per-version Chinese packs under packages/. The flow: Hermes reads the body text, agent.json, and latest.json served at useai.live/hermes; the Windows entry (install.ps1) detects the official desktop app and invokes official install parameters if missing; the macOS (install.command), Linux, and WSL2 entry (install.sh) detects a local Hermes and runs the official install script if absent. The installer then matches packages/0.15.x, 0.14.x, 0.13.x, or legacy zh-CN packs to the detected version, verifies SHA256, installs to ~/.xiaoma-hermes/current, sets display.language=zh (or updates ~/.hermes/config.yaml directly), and backs up then modifies hermes_cli/banner.py, skin_engine.py, tips.py, commands.py, bundles.py, mcp_picker.py, secrets_cli.py, acp_adapter/*.py, gateway/platforms/*.py, and ui-tui/src/**/*.ts. It also writes ~/.hermes/skills/xiaoma-hermes-zh/SKILL.md and provides a wrapper at ~/.xiaoma-hermes/bin/hermes that checks latest.json before launch to apply updates.
- Chinese newcomers to Hermes who cannot read the English startup screen and quick commands.
- Users who installed localization but still see English in skill categories, gateway status, or approval prompts.
- Beginners on Windows, macOS, Linux, or WSL2 who want one command to install the desktop app and the Chinese patch together.
- Users running Hermes versions outside 0.13.x–0.15.x who need the legacy compatibility pack.
- Heavy users who want the Chinese pack to auto-update before each Hermes launch.
Key setup facts
Pulled from the install and usage notes below. The project README has the current values.
- Environment variables
XIAOMA_HERMES_BASE_URL- Config files
latest.json~/.xiaoma-hermes/bin/hermes- Install notes cover
- Windows · macOS
How do you install or deploy this agent?
The recommended path is sending one sentence to Hermes, which reads the official site and installs automatically:
text
请访问 useai.live/hermes 安装汉化补丁
You can also run the one-shot installer from a terminal:
bash
bash web/install.shWindows uses the PowerShell entry install.ps1; macOS can double-click install.command. All installation methods, system requirements, and troubleshooting are documented at the official site: https://useai.live/hermesHow do you use this agent?
After installation, the patch sets display.language=zh; restart Hermes and the startup banner, quick commands, tool sets, and gateway status appear in Chinese. Optional auto-update runs through the wrapper command, which checks latest.json before launch and re-runs the installer when a new version exists:
bash
~/.xiaoma-hermes/bin/hermesFor local testing, point the installer at a local base URL:
bash
XIAOMA_HERMES_BASE_URL=http://127.0.0.1:4173 bash web/install.shWhat are this agent's strengths and limitations?
- One command covers Windows, macOS, Linux, and WSL2, and auto-installs the official desktop app if missing.
- Matches Chinese packs to Hermes versions (0.15.x/0.14.x/0.13.x/legacy) with automatic fallback to the compatibility pack.
- Verifies SHA256 before install and backs up files before modification, reducing patch risk.
- Built-in update mechanism via SKILL.md and the wrapper command keeps the Chinese pack current through latest..
- Only useful within the Hermes ecosystem; it does nothing for other agent frameworks.
- Modifies hermes_cli and ui-tui program files, so Hermes upgrades may require reinstalling the patch.
- Installation and updates depend on the online useai.live/hermes page and latest.json, so it cannot run fully offline.
- Troubleshooting and version-fit details live mainly on the website rather than in the repository, which has thin docs.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Xiaoma AI Hermes Chinese Enhancement Pack This agent | Insufficient evidence | — | ★ 18 | 3mo ago | Shell | — |
| Agetor | 76 · Good | — | ★ 137 | today | TypeScript | Codex · Claude Code |
| Hermes Agent CN Desktop | 55 · Major gaps | Desktop appFree + model costs | ★ 1.9k | 1d ago | TypeScript | — |
| Ordewell | 87 · Good | CLIFree + model costs | ★ 211 | today | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
How does FollowAgents rate this agent?
- Not found in source: least-privilege scopingGrant only what the task needs: a dedicated account or read-only token, scoped to specific directories and repos.
- Not found in source: confirmation before actingTurn on (or add) a confirmation step before it acts, and try it in a sandbox or test environment before real data.
- Not found in source: data-flow disclosureWatch which external services it contacts (proxy or firewall logs) and keep sensitive data out until you know where it goes.
- Not found in source: sensitive-data handlingUse dedicated, low-privilege, revocable API keys — never production credentials — and keep secrets out of logs.
- Not found in source: dependency securityPin versions and run a dependency audit (npm audit, pip-audit) before installing; prefer running it in a container.
- Not found in source: disclosed external effectsEstablish which external systems it writes to, sends to or changes, and verify with test accounts or repos before production.
- Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
- Not found in source: verifiable attributionInstall from the official repo or registry and check the publisher and URL to avoid look-alike packages.
- The supplied material is insufficient to review the installer's and patch packages' actual behavior; treat claims that they do not read conversations or API keys as unverified documentation claims.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
v2026.05.26.1 Hermes 中文增强包 2026.05.26.1:补齐网关用户可见中文
Release notes excerpt
本版补齐主频道提醒、私信配对码、多会话话题、平台连接、网关服务和配对管理等用户可见中文。\n\n安装入口: https://useai.live/hermes/\n\n安装命令:\n\n``bash\ncurl -fsSL https://useai.live/hermes/install.sh | bash\n``View on GitHub ↗ -
v2026.05.19.2 Hermes 中文增强包 2026.05.19.2:一条命令安装中文补丁
Release notes excerpt
Hermes Agent 中文用户可以直接用这一版安装中文增强包。 官网入口: https://useai.live/hermes/ 一句话安装: ```text 请访问 useai.live/hermes 安装汉化补丁 ``` 命令行安装: ```bash curl -fsSL https://useai.live/hermes/install.sh | bash ``` 这版重点: - 支持 Hermes Agent v0.14.x、0.13.x 和 legacy 老版本兼容路径。 - 覆盖启动页、TUI、快捷指令、工具分类、网关状态、ACP 权限、配对配置和审批提示。 - 没安装 Hermes 时,安装器会先安装官方版,再应用中文补丁。 - 有安装问题、版本适配、中文补丁未生效,或者想讨论 Hermes 在真实业务里的用法,请到官网首页扫码加入「Hermes交流答疑群」。 适合转发给: - 刚开始用 Hermes 的中文用户。 - 看不懂英文启动页和快捷指令的新手。 - 安装后仍有部分界面没有变成中文的人。View on GitHub ↗
FAQ
Is Xiaoma AI Hermes Chinese Enhancement Pack open source?
Is Xiaoma AI Hermes Chinese Enhancement Pack still maintained?
Who makes Xiaoma AI Hermes Chinese Enhancement Pack?
What is Xiaoma AI Hermes Chinese Enhancement Pack's official website?
Thanks — we use this to improve the page.