Skip to content
This repository was archived by the owner on May 6, 2026. It is now read-only.

Commit bebee5f

Browse files
yysjasmineclaude
yysjasmine
and
claude
committed
docs: expand platform prereqs into step lists, link GitHub Releases downloads
- Split Windows / macOS / Linux prerequisites into numbered setup steps with the exact commands users have to run (wsl --install, xcode-select --install, brew install, brew shellenv). - Switch the download table to link at releases/latest/download/<file>, so README never needs a version bump. - Keep the Linux bash one-liner pointing at linux/install.sh on main. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 5368db8 commit bebee5f

2 files changed

Lines changed: 87 additions & 23 deletions

File tree

‎README.md‎

Lines changed: 44 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -43,23 +43,55 @@ When the installer detects a China region (or `AGENTPACK_CN=1` is set), it prefi
4343

4444
## Platform Prerequisites
4545

46-
Platform-level prerequisites are NOT auto-installed; the installer prompts the user to install them manually with a link.
46+
Platform-level prerequisites are **not** auto-installed — install them manually once, then run the Agent Pack installer. Runtime dependencies (Python, Node.js, uv, git, build tools) **are** auto-installed by the product installers, so you don't need those.
4747

48-
| Platform | Prerequisite | Link |
49-
|----------|--------------|------|
50-
| Windows | WSL2 + a Linux distro | https://learn.microsoft.com/windows/wsl/install |
51-
| macOS | Xcode Command Line Tools | https://developer.apple.com/download/all/ |
52-
| macOS | Homebrew | https://brew.sh |
48+
### Windows
5349

54-
Runtime dependencies (Python, Node.js, uv, git, build tools) are auto-installed by the product installers.
50+
Requires **WSL2 + a Linux distro** (the Inno Setup installer calls `wsl.exe` under the hood).
51+
52+
1. Open **PowerShell as Administrator** and run:
53+
```powershell
54+
wsl --install
55+
```
56+
2. **Reboot** when prompted.
57+
3. On first boot, Windows launches the new Ubuntu distro — set a UNIX username and password.
58+
4. (Optional, only if `wsl --install` didn't pick one) install a distro from the Microsoft Store, e.g. Ubuntu.
59+
60+
Reference: <https://learn.microsoft.com/windows/wsl/install>
61+
62+
### macOS
63+
64+
Requires **Xcode Command Line Tools** (for `git`, `clang`) and **Homebrew** (used by the installer to `brew install` runtime deps).
65+
66+
1. Install the Command Line Tools:
67+
```bash
68+
xcode-select --install
69+
```
70+
2. Install Homebrew (skip if `brew --version` already prints a version):
71+
```bash
72+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
73+
```
74+
3. On Apple Silicon, add brew to your shell (the installer auto-sources this too, but do it once for your own shell):
75+
```bash
76+
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
77+
eval "$(/opt/homebrew/bin/brew shellenv)"
78+
```
79+
80+
References: <https://developer.apple.com/download/all/> · <https://brew.sh>
81+
82+
### Linux
83+
84+
No manual prerequisites — the installer handles `apt`/`yum` dependencies itself. You only need `bash`, `curl`, and `sudo` (standard on every mainstream distro).
5585

5686
## Download
5787

58-
| Platform | Format | How to Use |
59-
|----------|--------|------------|
60-
| Windows | `.exe` installer | Double-click and follow the wizard; installation runs inside WSL2, and the PowerShell window is taken over by the installed agent when setup finishes |
61-
| macOS | `.pkg` installer | Double-click, then complete setup in the Terminal window that opens; the same window becomes the agent's REPL / gateway once installation finishes |
62-
| Linux | bash script | `curl -fsSL https://URL/install.sh \| bash` — the shell that ran the installer is handed over to the agent via `exec` |
88+
Pre-built installers live on the [GitHub Releases page](https://github.com/SenseTime-FVG/agent_pack/releases/latest). Grab the one for your platform:
89+
90+
| Platform | Download | How to Use |
91+
|----------|----------|------------|
92+
| Windows | [`AgentPack-Setup-1.0.0.exe`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-Setup-1.0.0.exe) | Double-click and follow the wizard; installation runs inside WSL2, and the PowerShell window is taken over by the installed agent when setup finishes |
93+
| macOS | [`AgentPack-1.0.0.pkg`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0.pkg) | Double-click, then complete setup in the Terminal window that opens; the same window becomes the agent's REPL / gateway once installation finishes |
94+
| Linux | bash one-liner | `curl -fsSL https://raw.githubusercontent.com/SenseTime-FVG/agent_pack/main/linux/install.sh \| bash` — the shell that ran the installer is handed over to the agent via `exec` |
6395

6496
## Building from Source
6597

‎README.zh-CN.md‎

Lines changed: 43 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -42,23 +42,55 @@ Bundled skills 已经直接放进 `repos/hermes-agent/skills/` 和 `repos/opencl
4242

4343
## 平台级前提
4444

45-
平台级前提不会自动安装；安装器会提示用户自行安装并提供链接。
45+
平台级前提**不会**自动安装 —— 手动装一次，再运行 Agent Pack 安装器。运行时依赖（Python、Node.js、uv、git、构建工具）**会**由各产品的安装脚本自动处理，无需手动管。
4646

47-
| 平台 | 前提 | 链接 |
48-
|------|------|------|
49-
| Windows | WSL2 + Linux 发行版 | https://learn.microsoft.com/windows/wsl/install |
50-
| macOS | Xcode Command Line Tools | https://developer.apple.com/download/all/ |
51-
| macOS | Homebrew | https://brew.sh |
47+
### Windows
5248

53-
运行时依赖（Python、Node.js、uv、git、构建工具）由各产品的官方安装脚本自动安装。
49+
需要 **WSL2 + 一个 Linux 发行版**（Inno Setup 安装器底层通过 `wsl.exe` 执行所有操作）。
50+
51+
1. **以管理员身份**打开 PowerShell，运行：
52+
```powershell
53+
wsl --install
54+
```
55+
2. 按提示**重启**电脑。
56+
3. 重启后 Windows 会启动新装的 Ubuntu —— 按提示设置 UNIX 用户名和密码。
57+
4. （可选，仅当 `wsl --install` 没有自动选一个发行版时）从 Microsoft Store 装一个，比如 Ubuntu。
58+
59+
参考：<https://learn.microsoft.com/windows/wsl/install>
60+
61+
### macOS
62+
63+
需要 **Xcode Command Line Tools**（提供 `git`、`clang`）和 **Homebrew**（安装器用 `brew install` 拉运行时依赖）。
64+
65+
1. 装 Command Line Tools：
66+
```bash
67+
xcode-select --install
68+
```
69+
2. 装 Homebrew（如果 `brew --version` 已经能输出版本号就跳过）：
70+
```bash
71+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
72+
```
73+
3. Apple Silicon 机器需要把 brew 加到 shell 启动文件里（安装器内部也会自动 source，但自己 shell 也装一下方便日常使用）：
74+
```bash
75+
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
76+
eval "$(/opt/homebrew/bin/brew shellenv)"
77+
```
78+
79+
参考：<https://developer.apple.com/download/all/> · <https://brew.sh>
80+
81+
### Linux
82+
83+
没有需要手动装的前提 —— `apt`/`yum` 相关的依赖安装器自己处理。只需要系统自带的 `bash`、`curl` 和 `sudo`（主流发行版标配）。
5484

5585
## 下载
5686

57-
| 平台 | 格式 | 使用方式 |
87+
预编译的安装器发布在 [GitHub Releases 页面](https://github.com/SenseTime-FVG/agent_pack/releases/latest)，挑自己平台的那一个：
88+
89+
| 平台 | 下载 | 使用方式 |
5890
|------|------|---------|
59-
| Windows | `.exe` 安装器 | 双击运行向导；安装过程在 WSL2 中执行，安装完成后当前 PowerShell 窗口会被接管，直接跑起 agent |
60-
| macOS | `.pkg` 安装器 | 双击后在自动打开的 Terminal 窗口中完成安装；安装结束后同一个窗口会变成 agent 的 REPL / gateway |
61-
| Linux | bash 脚本 | `curl -fsSL https://URL/install.sh \| bash` — 安装结束后会在当前 shell 里 `exec` 拉起 agent |
91+
| Windows | [`AgentPack-Setup-1.0.0.exe`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-Setup-1.0.0.exe) | 双击运行向导；安装过程在 WSL2 中执行，安装完成后当前 PowerShell 窗口会被接管，直接跑起 agent |
92+
| macOS | [`AgentPack-1.0.0.pkg`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0.pkg) | 双击后在自动打开的 Terminal 窗口中完成安装；安装结束后同一个窗口会变成 agent 的 REPL / gateway |
93+
| Linux | bash 一行命令 | `curl -fsSL https://raw.githubusercontent.com/SenseTime-FVG/agent_pack/main/linux/install.sh \| bash` — 安装结束后会在当前 shell 里 `exec` 拉起 agent |
6294

6395
## 从源码构建
6496

0 commit comments

Comments
 (0)