Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

docs: add pipx/venv guidance for Homebrew Python installs

robert.chen59b594eccce8
diff --git a/docs/install.md b/docs/install.md
index ba5d1331..5f6d87bc 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -51,12 +51,24 @@ All Agent Reach files go in dedicated directories — **never in the agent works
**Default (fully automatic):**
```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
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.
+> 💡 **macOS / Homebrew Python 提示 `externally-managed-environment`?**
+> 这是 PEP 668 保护,不是 Agent Reach 本身的问题。优先用 `pipx install ...`,或先创建 `venv` 再安装。
+
+
**Safe mode (no automatic system changes):**
If the user asked for safe mode, or you're on a production machine: