sawz/Agent-Reach
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add pipx/venv guidance for Homebrew Python installs

Browse Source
This commit is contained in:
robert.chen
2026-03-12 19:27:09 +08:00
committed by GitHub
parent 3416c0f6d3
commit 59b594eccc
1 changed files with 12 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/install.md
+12
View File
@@ -51,12 +51,24 @@ All Agent Reach files go in dedicated directories — **never in the agent works
**Default (fully automatic):** **Default (fully automatic):**
```bash ```bash
# 推荐：pipx（最省心）
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
# 如果你的 Python 来自 Homebrew / 遇到 PEP 668（externally-managed-environment）
# 用虚拟环境安装：
python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install https://github.com/Panniantong/agent-reach/archive/main.zip pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto agent-reach install --env=auto
``` ```
This auto-installs system dependencies (gh CLI, Node.js, mcporter, xreach), configures Exa search, detects environment, and tests all channels. This auto-installs system dependencies (gh CLI, Node.js, mcporter, xreach), configures Exa search, detects environment, and tests all channels.
> 💡 **macOS / Homebrew Python 提示 `externally-managed-environment`？**
> 这是 PEP 668 保护，不是 Agent Reach 本身的问题。优先用 `pipx install ...`，或先创建 `venv` 再安装。
**Safe mode (no automatic system changes):** **Safe mode (no automatic system changes):**
If the user asked for safe mode, or you're on a production machine: If the user asked for safe mode, or you're on a production machine: