docs: stop recommending pip install; curl installer is the only supported path (#51743)

* docs: stop recommending pip install hermes-agent; point to install script

The install script is the only supported install path (it provisions a
managed, isolated uv environment). Replace bare `pip install hermes-agent`
primary-install recommendations with the curl install script, and rewrite
optional-extra snippets (`pip install "hermes-agent[X]"`) to the managed-env
form `cd ~/.hermes/hermes-agent && uv pip install -e ".[X]"` that matches the
installer and the English quickstart.

Covers English docs + zh-Hans mirrors, the achievements plugin README, and
realigns the zh-Hans quickstart to the English Desktop-installer-first layout
(dropping its stale "Method A — pip (simplest)" section).

* docs: drop pip as a supported install/update method

Removes the 'pip installs' supported-method sections from updating.md and
cli-commands.md (EN + zh-Hans): the curl install script is the only supported
way to install/update the Hermes CLI. The _cmd_update_pip pip/pipx branches
remain in code as an undocumented safety net for users who already have such an
install, but the docs no longer advertise pip as a path.

Also normalizes a bare `pip install -e '.[acp]'` to the managed-env form.

Leaves python-library.md untouched: importing AIAgent as a library dependency
into your own project is a distinct use case where pip is correct.
This commit is contained in:
Teknium
2026-06-24 00:14:32 -07:00
committed by GitHub
parent 98224ce8b6
commit a911bcda18
27 changed files with 68 additions and 125 deletions
@@ -79,7 +79,7 @@ hermes [global-options] <command> [subcommand/options]
| `hermes profile` | 管理 profile——多个隔离的 Hermes 实例。 |
| `hermes completion` | 打印 shell 补全脚本(bash/zsh/fish)。 |
| `hermes version` | 显示版本信息。 |
| `hermes update` | 拉取最新代码并重新安装依赖(git 安装),或检查 PyPI 并执行 `pip install --upgrade`(pip 安装)。`--check` 预览而不安装;`--backup` 在拉取前对 `HERMES_HOME` 进行快照。 |
| `hermes update` | 拉取最新代码并重新安装依赖。`--check` 预览而不安装;`--backup` 在拉取前对 `HERMES_HOME` 进行快照。 |
| `hermes uninstall` | 从系统中删除 Hermes。 |
## `hermes chat`
@@ -974,7 +974,7 @@ python -m acp_adapter
首先安装支持:
```bash
pip install -e '.[acp]'
cd ~/.hermes/hermes-agent && uv pip install -e '.[acp]'
```
参见 [ACP 编辑器集成](../user-guide/features/acp.md) 和 [ACP 内部原理](../developer-guide/acp-internals.md)。
@@ -1144,7 +1144,7 @@ hermes claw migrate --source /home/user/old-openclaw
hermes dashboard [options]
```
启动 Web 控制台——基于浏览器的界面,用于管理配置、API 密钥和监控会话。需要 `pip install hermes-agent[web]`(FastAPI + Uvicorn)。内嵌浏览器 Chat 标签页始终可用,但额外需要 `pty` extra(`pip install 'hermes-agent[web,pty]'`)以及 POSIX PTY 环境(如 Linux、macOS 或 WSL2)。完整文档请参阅 [Web 控制台](/user-guide/features/web-dashboard)。
启动 Web 控制台——基于浏览器的界面,用于管理配置、API 密钥和监控会话。需要 `cd ~/.hermes/hermes-agent && uv pip install -e ".[web]"`(FastAPI + Uvicorn)。内嵌浏览器 Chat 标签页始终可用,但额外需要 `pty` extra(`cd ~/.hermes/hermes-agent && uv pip install -e ".[web,pty]"`)以及 POSIX PTY 环境(如 Linux、macOS 或 WSL2)。完整文档请参阅 [Web 控制台](/user-guide/features/web-dashboard)。
| 选项 | 默认值 | 说明 |
|--------|---------|-------------|
@@ -1227,9 +1227,7 @@ hermes completion fish > ~/.config/fish/completions/hermes.fish
hermes update [--check] [--backup] [--restart-gateway]
```
拉取最新的 `hermes-agent` 代码并在 venv 中重新安装依赖,然后重新运行安装后 hook(MCP 服务器、skill 同步、补全安装)。可在运行中的安装上安全执行。
**pip 安装:** `hermes update` 自动检测基于 pip 的安装——查询 PyPI 获取最新版本并运行 `pip install --upgrade hermes-agent`,而非 `git pull`。PyPI 发布跟踪标记版本(主要/次要版本),而非 `main` 上的每个 commit。使用 `--check` 查看是否有更新的 PyPI 版本可用,而不安装。
拉取最新的 `hermes-agent` 代码并在受管理的 venv 中重新安装依赖,然后重新运行安装后 hook(MCP 服务器、skill 同步、补全安装)。可在运行中的安装上安全执行。使用 `--check` 查看你的检出是否落后于 `origin/main`,而不安装。
| 选项 | 说明 |
|--------|-------------|