Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
docs: add pipx/venv guidance for Homebrew Python installs
robert.chen59b594eccce8
diff --git a/docs/install.md b/docs/install.mdindex 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/activatepip install https://github.com/Panniantong/agent-reach/archive/main.zipagent-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: