
PilotDeck
把 AI 变成能自动完成任务的数字员工
PilotDeck 是一个面向任务型 AI Agent 的生产力平台,用 TypeScript 构建。它把分散的 AI 能力组织成可执行的工作流,让用户以任务为中心调度多个智能体协作,而不是停留在单轮对话。核心能力包括任务编排、Agent 调度、工具调用与结果交付,目标是把 AI 从聊天助手升级为能真正完成工作的执行者。适合需要把重复性知识工作自动化的团队,例如资料整理、内容生成、数据查询与流程处理。项目提供统一界面管理任务状态与产出,降低多工具切换成本。当前星标约 4000,处于成长阶段,社区和文档仍在完善中,但方向明确:让 AI 承担完整任务闭环,而非只做问答。
项目数据
使用教程
环境要求
- Node.js 22.13+ 且小于 23(内置 SQLite 运行时需要)
- macOS 需可用 Xcode Command Line Tools 和带 distutils 的 Python
- Linux 安装系统包需 sudo 与受支持的包管理器
- Windows 需 PowerShell(可选 winget 安装缺失依赖)
- Docker 环境(选择 Docker Compose 方式时)
安装与启动步骤
-
1确认运行环境
先准备好 Node.js 22.13+ 且低于 23 的运行时;macOS 用户确认 Xcode Command Line Tools 与 Python distutils 可用。
-
2macOS/Linux 一键安装
官方推荐方式:脚本会检查 Node.js、克隆仓库、安装依赖并构建前端,Linux 上可自动补装系统包。
curl -fsSL https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.sh | bash -
3网络慢时用镜像
若 Node.js 或 npm 包下载缓慢,可在安装命令前设置镜像环境变量后再执行。
curl -fsSL https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.sh | PILOTDECK_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node NPM_CONFIG_REGISTRY=https://registry.npmmirror.com bash -
4Windows 一键安装
以普通用户运行 PowerShell 执行该命令;安装到 %USERPROFILE%.pilotdeck,完成后自动启动并打印地址。
powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.ps1 | iex" -
5启动与查看状态
启动服务(默认 http://localhost:3001),再用 status 检查运行时状态;Windows 需先新开 PowerShell 窗口。
pilotdeck pilotdeck status -
6打开界面完成引导
复制脚本打印的地址到浏览器,按引导配置模型 provider 和 API Key;Windows 也可用命令直接打开。
Start-Process http://localhost:3001 -
7Docker Compose 部署
已装 Docker 时可用 Compose 启动,完整 Docker 配置参见仓库内 README_DOCKER.md。
docker compose up -d --build
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
PILOTDECK_NODE_DIST_MIRROR | 否 | 指定 Node.js 下载镜像,加速安装 | https://npmmirror.com/mirrors/node |
NPM_CONFIG_REGISTRY | 否 | 指定 npm 包源地址,加速依赖安装 | https://registry.npmmirror.com |
PILOTDECK_NODE_DIST_FALLBACK_MIRRORS | 否 | 保留官方源为主并启用备用镜像 | https://npmmirror.com/mirrors/node |
provider + API Key | 是 | 首次引导页需填写的模型提供方与密钥 | 按页面引导填写 |
如何确认成功
运行 pilotdeck status 能查看运行时状态,并在浏览器打开 http://localhost:3001 看到界面、完成 provider 与 API Key 引导。
常见问题
Q:安装脚本下载 Node.js 或依赖很慢怎么办?
A:在运行安装脚本前设置 PILOTDECK_NODE_DIST_MIRROR 与 NPM_CONFIG_REGISTRY 指向可达的镜像,或用 PILOTDECK_NODE_DIST_FALLBACK_MIRRORS 保留官方源并启用备用镜像。
Q:macOS 安装前需要额外准备什么?
A:需确保 Xcode Command Line Tools 可用,并有一个带 distutils 的 Python 可用;满足后脚本才能正常构建。
Q:安装后为什么找不到 pilotdeck 命令?
A:可能是当前 shell 尚未加载更新后的 PATH,开一个新终端或先 source 你的 shell 配置;Windows 可直接运行 %USERPROFILE%.pilotdeckinpilotdeck.cmd。
Q:Windows 安装完成后浏览器没有自动打开?
A:脚本只打印 UI 地址(通常 http://localhost:3001)不自动开浏览器,手动复制到浏览器,或执行 Start-Process http://localhost:3001 打开。
Q:Git LFS 超时会导致安装失败吗?
A:不会,安装器会跳过 Git LFS 媒体资源继续安装,这些演示视频/GIF 对核心应用不是必需的。
注意事项
- 服务默认监听 http://localhost:3001,安装脚本不会自动打开浏览器
- 至少已配置一项模型 provider 与 API Key 后才能正常使用
- Windows 安装路径为 %USERPROFILE%.pilotdeck,启动器在该目录的 bin 下
- 项目采用 AGPL 3.0 许可,来源分支的安装脚本才是一键安装入口
核心亮点
- 以任务为单位的编排模型,比单纯对话更贴近真实工作流
- TypeScript 技术栈,前端集成和二次开发门槛低
- 支持多 Agent 协作与工具调用,可扩展性较好
不足之处
- 项目处于成长阶段,文档和生态成熟度有限
- 复杂任务的稳定性和错误恢复机制仍需验证
适用场景
- 团队自动化处理重复性知识工作
- 个人用多 Agent 协作完成资料调研与整理
- 企业内部搭建任务型 AI 工作流平台
替代项目
AutoGPT、Dify
项目介绍
同类项目推荐
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···