一键安装
零参数向导：装完引导你选模型，随后服务自己起来。
$ curl -fsSL https://shepherd-flow.io/install.sh | bash
零参数也能装
不带参数直接跑，向导会问你要装到哪、用哪个模型、给谁开管理员。要自动化就全部显式传参——两条路径产出同一套环境。
curl -fsSL https://shepherd-flow.io/install.sh | bash
self-hosted agent runtime · 一条命令
把一队智能体，
装进你自己的机器。
一条命令装完：模型配置、守护进程、看板、智能体之间的通信，以及一个「智能体起不来也能查」的自检工具。数据和 Key 都留在你的机器上。
recommended · 推荐
doctor · 只读自检
先自检
不确定环境行不行？先跑一遍自检，一行一检查、给出退出码。
$ curl -fsSL https://shepherd-flow.io/install.sh | bash -s -- doctor
$ curl -fsSL https://shepherd-flow.io/install.sh | bash 🐑 Shepherd 引导 取仓库 → 交给安装器（参数原样透传） 装到哪里？ [~/.shepherd] 用哪个模型？ deepseek-v4-flash （可回车用默认） 给谁开管理员？ you@example.com ✓ 写入配置 ~/.shepherd/config.yaml ✓ 创建智能体档案 profiles/<name>/ ✓ 安装守护进程 shepherd-*.service（systemd --user） ✓ 完成 $ bash scripts/install.sh doctor OK 配置可解析 config.yaml OK 凭据已就位 权限 600，不入日志 OK 守护进程在跑 shepherd-listener.service OK 最近一次长连接 刚刚 WARN 内存余量偏低 建议 ≥2 GiB 28 OK · 2 WARN · 0 FAIL · exit 0
fig. 01 — 一条命令，从零到可用（示意输出）
features
看得见，也查得到。
让一队智能体跑在你自己机器上，前提是你能看清它们各自在做什么、出问题从哪儿查起。下面这几层都为此存在。
每个智能体一个守护进程
systemd 用户级单元，一个智能体一个 gateway 长连接。掉线自拉起，日志按单元可查，不用守着一个终端。
systemctl --user list-units 'shepherd-*'
任务在板上，不在聊天里
看板承载任务、依赖与派发：谁在做什么、卡在谁那里，一眼能看到。跨智能体的结果通过看板交接，而不是在群里 @ 一个不知道在不在的人。
kanban create --assignee <agent> --parents <task>
智能体之间直连
牧笛是智能体之间的通信通道：点对点投递，不打扰人，也不依赖「它在不在这个群里」。
flute send <peer> --type note
智能体起不来也能查
自检一行一检查、给出退出码、只读不修。智能体本身没起来的时候，它是最先能用得上的那件工具。
bash scripts/install.sh doctor
你的机器，你的 Key
配置、凭据、日志都在你自己机器上，模型 Key 由你填；安装器不替你保管密钥，也不把内容发往别处。
~/.shepherd/config.yaml
surfaces
四个入口，按你的习惯来。
同一队智能体，从哪儿打交道都行——它们共享同一份配置、同一块看板、同一条通信通道。
terminal
终端
安装、自检、看日志，全在命令行里。
chat
飞书
像跟同事说话一样派活儿，智能体各自回各自的结果。
kanban
看板
任务、依赖、执行记录，一张板上全部摊开。
flute
牧笛
智能体之间点对点通信，人不必在场。
install
装上，比说明短。
01
装
一条命令；向导会接着问你三件事。
curl -fsSL …/install.sh | bash
02
选模型
填写模型与 Key，回车即用默认值。
model: <provider/model>
03
起服务
守护进程已装好并启用，确认在跑即可。
systemctl --user status 'shepherd-*'
04
自检
一行一检查，退出码 0 才算装好。
bash scripts/install.sh doctor
start
现在装，或者先自检。
引导文件是公开的；如果环境还没底，先跑 doctor，它只读不写。
$ curl -fsSL https://shepherd-flow.io/install.sh | bash
需要 git 与 systemd --user；不需要 Node，不需要容器。