PilotDeck

📦 Installation & Quick Start

We provide one-line installers for macOS / Linux and Windows PowerShell, plus a source-based workflow for developers.

Option A: One-line install (recommended, macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.sh | bash

The script checks/uses the supported Node.js 22 runtime (22.13+ and <23, required for the built-in SQLite runtime), clones the repo, installs dependencies, and builds the frontend. On Linux it can install missing system packages when sudo and a supported package manager are available. On macOS, make sure Xcode Command Line Tools and a Python with distutils are usable before running the installer. Once it finishes:

If Node.js or npm package downloads are slow or unreliable on your network, set reachable mirrors before running the installer:

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

You can also keep the official Node.js host as the primary source and opt in to one or more trusted fallback mirrors with PILOTDECK_NODE_DIST_FALLBACK_MIRRORS.

pilotdeck            # starts the server at http://localhost:3001
pilotdeck status     # check runtime status

To open PilotDeck again later on macOS / Linux, run pilotdeck in a terminal and open the printed URL in your browser. If your shell has not picked up the PATH update yet, open a new terminal or source your shell profile first.

```bash pilotdeck

Option A2: One-line install (Windows PowerShell)

Run PowerShell as a normal user, then execute:

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.ps1 | iex"

The PowerShell installer uses Windows-native paths under %USERPROFILE%\.pilotdeck, checks Node.js 22.13+ with node:sqlite, installs missing prerequisites with winget when available, builds PilotDeck, and creates a pilotdeck.cmd launcher in %USERPROFILE%\.pilotdeck\bin. Git LFS media assets are optional for the core app; if Git LFS is unavailable or times out, the installer continues without demo videos/GIFs.

After installation, the script starts PilotDeck and prints the UI URL, usually http://localhost:3001. It does not automatically open a browser, so copy that URL into your browser to finish onboarding (provider + API key). You can also open it from PowerShell:

Start-Process http://localhost:3001

If this is your first install, open a new PowerShell window after the script updates your user PATH, then run:

pilotdeck            # starts the server at http://localhost:3001
pilotdeck status     # check runtime status

To open PilotDeck again later, run pilotdeck from a new PowerShell window, then open the printed URL in your browser. If pilotdeck is not yet on PATH, run the launcher directly:

& "$HOME\.pilotdeck\bin\pilotdeck.cmd"

Windows PowerShell FAQ

npm.ps1 cannot be loaded because running scripts is disabled

This can still happen when you run development commands such as npm run dev directly in Windows PowerShell for the first time. PowerShell may resolve npm to npm.ps1, and the default execution policy can block that shim.

Fix it once for the current user, then reopen PowerShell:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

If you do not want to change the user policy, run the cmd shim explicitly instead:

npm.cmd run dev

Native dependency build errors (node-gyp, MSBuild, or Python not found)

The installer normally uses prebuilt packages for native dependencies such as node-pty, better-sqlite3, bcrypt, and sharp. On a fresh Windows machine, if npm cannot download a matching prebuild and falls back to compiling from source, install Visual Studio Build Tools with the C++ workload and Python, then rerun the installer.

GitHub returns 429: Too Many Requests while downloading install.ps1

GitHub may rate-limit repeated raw.githubusercontent.com requests from shared networks. Wait a few minutes and rerun the one-line command, or download install.ps1 from the repository and run it locally with powershell -ExecutionPolicy Bypass -File .\install.ps1.

Option C: Docker Compose

If Docker is installed, you can start PilotDeck with:

docker compose up -d --build

For full Docker configuration, see README_DOCKER.md.

---

Use Cases

All demos below are generated entirely by edge-side models via PilotDeck's Smart Routing — no cloud-side frontier model required.

Work Document Generation

"Survey the Chinese LLM application market and turn it into a formal HTML white paper."

Process	Result

Mini-Game Development

"Walk me through building an iOS AR mini-game Ball Finder in Vibe Coding mode."

Process	Result

AI Engineering Platform Development

"Build a low-code embedding fine-tuning platform from scratch."

Process	Result

Audio-Video Editing & Social Media Operations

"Push this English podcast to a global audience in Chinese / Japanese / French / Korean / Spanish / Arabic."

Process

Result (with audio)

https://github.com/user-attachments/assets/a7245467-ee3c-4939-a055-c56576ac56d1 </td> </tr> </table> --- 🖥️ UI & Demo PilotDeck ships an out-of-the-box Web UI with full WorkSpace management, white-box memory editing, and visualization of multi-agent collaboration. Option B: From source (for developers) Need platform-specific dependency installation commands? See the Source Installation Guide. 1. Clone and install dependencies By default, skip large Git LFS demo media to keep the source install lightweight. If you need the demo videos/GIFs later, run git lfs pull after cloning. GIT_LFS_SKIP_SMUDGE=1 git clone https://github.com/OpenBMB/PilotDeck.git cd PilotDeck node --version # must be v22.13.0 or newer, and below v23 corepack enable # enables the pinned pnpm version from package.json corepack pnpm install --frozen-lockfile --filter pilotdeck --filter pilotdeck-ui PilotDeck uses the committed pnpm-lock.yaml for reproducible source installs. The filters keep Electron packaging dependencies out of Web-only installs. Prefer the corepack pnpm ... command above instead of npm install; on macOS, this also avoids unnecessary native rebuild fallbacks when matching prebuilt packages are available. 2. Configure a model provider PilotDeck reads ~/.pilotdeck/pilotdeck.yaml. You can create it manually, or just open the Web UI and configure providers visually in onboarding. Supported protocols include OpenAI, Anthropic, native Google Gemini, DeepSeek, Qwen, Kimi, MiniMax and other OpenAI-compatible endpoints. If the config file is missing, PilotDeck starts the Web UI without the Gateway and opens onboarding. Saving a valid provider, API key, and model writes the config and starts the Gateway automatically. schemaVersion: 1 agent: model: deepseek/deepseek-v4-pro model: providers: deepseek: protocol: openai url: https://api.deepseek.com/v1 apiKey: sk-your-api-key Native Gemini can be configured with protocol: google: schemaVersion: 1 agent: model: google/gemini-3.1-pro-preview model: providers: google: protocol: google url: https://generativelanguage.googleapis.com apiKey: ${GEMINI_API_KEY} models: gemini-3.1-pro-preview: {} Local Ollama models can be configured without an API key. PilotDeck uses Ollama's OpenAI-compatible /v1/chat/completions endpoint: ollama serve ollama pull qwen3:0.6b schemaVersion: 1 agent: model: ollama/qwen3:0.6b model: providers: ollama: protocol: openai url: http://localhost:11434/v1 models: qwen3:0.6b: {} 3. Start the services ```bash cd ui && npm run dev # dev mode (HMR), visit http://localhost:5173 🛠️ Extension Protocol PilotDeck has an open plugin architecture with a strict boundary between the open-source core and plugin customization. Extending the system is a plugin.json away: MCP Servers — first-class integration with any Model Context Protocol server. Tools & Skills — register custom tools, or pull community skills via ClawHub. Lifecycle Hooks — intercept PreToolUse, UserPromptSubmit, and other critical lifecycle events. Custom Memory — plug in your own memory store provider. --- 🇨🇳 中文文档镜像 AI 翻译 2026-07-06 英文原文章节由系统翻译为中文摘要，便于快速理解。完整原文见上方 "📑 README 深度解析"。 📌 简介 PilotDeck 是一个以“WorkSpace”为核心概念的开源 Agent 操作系统。它由清华大学 THUNLP、ModelBest、OpenBMB 及 AI9Stars 联合开发，旨在应对通用、多任务的复杂场景。通过引入 WorkSpace 设计，PilotDeck 重新定义了 AI Agent 的操作边界与记忆演进方式，为开发者提供了一个高效、可扩展的任务导向型 AI Agent 生产力平台。 ⚡ 功能介绍 PilotDeck 实现了 WorkSpace 级别的隔离与增量机制。每个项目都拥有独立的 File System、Memory Store 和 Skill Set，确保并行任务之间互不干扰。这种设计有效避免了全局上下文污染，使检索范围保持在受控边界内，并允许技能随任务的增长自然累积，实现能力的持续进化。 🛠 安装步骤（Docker/pip/源码） PilotDeck 提供多种安装方式以适应不同用户。推荐 macOS/Linux 用户使用一键安装脚本，该脚本会自动配置 Node.js 22.13+ 环境、克隆仓库并构建前端。对于容器化部署，支持通过 Docker Compose 快速启动。开发者也可以选择从源码构建，以获得更高的定制灵活性。 🚀 使用教程 PilotDeck 支持通过 Smart Routing 技术调用边缘侧模型完成复杂任务，无需依赖云端前沿模型。例如，用户可以要求 Agent “调研中国 LLM 应用市场并将其转化为正式的 HTML 白皮书”，系统将自动完成从信息检索到文档生成的全流程自动化操作。 ⚙️ 配置说明（含 MCP / env） 开发者可以通过源码模式进行深度定制。在克隆仓库时，建议安装 Git LFS 以获取大型媒体资产；若仅需核心功能，可通过设置 GIT_LFS_SKIP_SMUDGE=1 来跳过资源下载。系统架构设计清晰，方便开发者根据需求调整开发环境与配置。 🔄 工作流/模块 PilotDeck 采用开放的插件架构，在开源核心与插件定制之间建立了严格的边界。通过 Extension Protocol，用户可以轻松扩展系统功能：支持与任何 MCP (Model Context Protocol) Server 进行一级集成，并允许通过注册自定义 Tools & Skills 来扩展 Agent 的能力边界。 🎯 aiskill88 AI 点评 A 级 2026-06-01 高质量的开源AI工作流平台 📚 实用指南（长尾问题） 适合谁 需要让 Claude / Cursor 操作本地工具的 AI 工程师 构建多智能体协作系统的 Agent 开发者 构建企业知识库 / RAG 检索应用的团队 最佳实践 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant Agent 任务先做 dry-run 验证工具调用链，再开启自主执行 常见错误 API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore） MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效 容器内无法访问宿主机 localhost — 使用 host.docker.internal embedding 模型与查询模型不一致导致检索失效 部署方案 Docker：PilotDeck 提供官方镜像，docker compose up 一键启动 CLI：直接 npm install -g / pip install，命令行调用 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台 相关搜索 PilotDeck 中文教程PilotDeck 安装报错怎么办PilotDeck MCP 配置PilotDeck Docker 部署PilotDeck Agent 工作流PilotDeck 与同类工具对比PilotDeck 最佳实践PilotDeck 适合谁用 ⚡ 核心功能 可视化 Agent 工作流编排，无需编写复杂代码 支持多步骤自动化任务链，实现全流程无人值守 与外部 API、数据库和第三方服务无缝集成 内置错误处理与自动重试机制，保障稳定运行 提供可复用的自动化模板，快速在同类场景部署 👥 适合谁 需要让 Claude / Cursor 操作本地工具的 AI 工程师 构建多智能体协作系统的 Agent 开发者 构建企业知识库 / RAG 检索应用的团队 ⭐ 最佳实践 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant Agent 任务先做 dry-run 验证工具调用链，再开启自主执行 ⚠️ 常见错误 API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore） MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效 容器内无法访问宿主机 localhost — 使用 host.docker.internal embedding 模型与查询模型不一致导致检索失效 👥 适合人群 自动化工程师和运维人员项目经理和业务分析师希望减少重复性工作的专业人士数字化转型团队 🎯 使用场景 自动化日常重复性工作，将精力集中于创造性任务 构建数据采集 → 处理 → 输出的完整自动化管线 实现跨平台、跨系统的数据流转和业务协同 ⚖️ 优点与不足 ✅ 优点 +大幅减少重复性人工操作 +可视化流程，清晰直观 +可扩展性强，支持复杂场景 ⚠️ 不足 −初始配置和调试需投入一定时间 −强依赖外部服务的稳定性 −复杂场景需具备一定技术基础 ⚠️ 使用须知 该工具使用 AGPL-3.0 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。 AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。 建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。 📄 License 说明 ⚠️ AGPL 3.0 — 最严格的 Copyleft，网络服务端使用也需开源，SaaS 使用受限。 🔗 相关工具推荐 browser-use Agent工作流 Agent工作流 Activepieces 开源工作流自动化 Agent工作流 LLM资源合集（精选） 精选100+可直接运行的AI Agent和RAG应用集合。包含完整工作流示例、智能代理框架和检索增强生成系统。适合AI开 Sim AI智能工作流引擎 Agent工作流 📚 相关教程推荐 Agent 工作流入门 帮助中心 · AI Skill Hub Agent 工作流 帮助中心 · AI Skill Hub AI 写作提效工作流：从 Prompt 设计到批量内容生产 帮助中心 · AI Skill Hub n8n vs Make vs Zapier 2025：哪款工作流自动化工具最适合 AI 时代 帮助中心 · AI Skill Hub 📰 相关 AI 新闻 AI Agent 自主化能力最新进展 AI 资讯 · 知识关联 AI Agent 自主化能力最新进展 AI 资讯 · 知识关联 AI 前沿资讯：I built an AI that acts withou… AI 资讯 · 知识关联 AI 前沿资讯：Is your AI strategy burning ca… AI 资讯 · 知识关联 🍿 AI 圈相关吃瓜 配了5个 MCP 工具，Claude 一个都没用 AI 圈观察 AutoGPT 自主完成了任务：把我的文件夹全部重命名了 AI 圈观察 Filesystem MCP 帮 Claude 找文件，找了整个 node_modules AI 圈观察 🗺️ 相关解决方案 mcp mcp-server-setup agent ai-agent-workflow workflow ai-workflow-templates docker docker-deploy 🧩 你可能还需要 基于当前 Skill 的能力图谱，自动补全的工具组合 gptme Agent工作流 MCP · Agent · 工作流 AI公司多智能体操作系统 为Claude Code设计的开源MCP工具集，包含108个MCP工具和40+智能体模板。支持多智能体协作编排，提供完整的自主代理框架。适合 Augustus LLM安全测试框架，检测prompt注入、越狱等 Eve Agent V2 本地AI编程助手 一个基于Ollama驱动的本地优先自主AI编程代理。它通过构建AI工作流实现代码编写与自动化任务，强调隐私保护与本地运行，非常适合希望在不依 natively-cluely-ai-assistant — Claude Skill 中文使用文档 免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。 LEANN AI技能包 MCP · Agent · 工作流 ❓ 常见问题 FAQ PilotDeck 是什么工具？− PilotDeck 是一款TypeScript开发的AI辅助工具。开源AI工作流：Task-oriented AI Agent productivity platform。⭐2.7k · TypeScript 主要应用场景包括：自动化工作流程。 PilotDeck 如何安装和开始使用？+ 访问 PilotDeck 的 GitHub 仓库或官方网站，按照 README 文档中的步骤安装依赖并运行。通常需要 Python 3.8+ 或 Node.js 16+ 基础环境。 PilotDeck 是否免费？许可证是什么？+ PilotDeck 完全免费，采用 AGPL-3.0 许可证开源发布，任何人都可以免费使用、修改和分发。 PilotDeck 适合哪些用户使用？+ PilotDeck 对初学者友好，无需深厚技术背景即可快速上手。同时也适合有经验的开发者和 AI 工程师进行深度定制。 PilotDeck 的社区活跃度和项目维护状况如何？+ PilotDeck 在 GitHub 上已获得 2,660 个 Star，拥有较好的社区基础，定期更新迭代。 什么是 Agent 工作流？和普通自动化有什么区别？+ Agent 工作流是以 AI 为核心决策节点的自动化流程，AI 可以根据上下文动态调整执行路径，而不是固定按顺序执行。与普通自动化（如 Zapier）相比，Agent 工作流能处理更复杂、需要判断的场景，但配置要求也相对更高。 导入工作流后，我需要修改哪些配置？+ 通常需要配置：① API Key（AI 模型和外部服务的访问密钥）；② 数据源地址（如数据库连接、Webhook URL）；③ 输出目标（邮件地址、Slack 频道、文件路径等）。具体配置项请参考工作流说明文档或 README 中的环境变量列表。 工作流运行失败了，如何排查问题？+ 常见失败原因：① API Key 过期或配额耗尽；② 外部服务暂时不可用；③ 输入数据格式不符合预期；④ 网络超时。建议先查看运行日志中的错误信息，定位失败的具体步骤，再针对性排查。 💡 AI Skill Hub 点评 经综合评估，PilotDeck 在Agent工作流赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。 ⬇️ 获取与下载 ⬇ 下载源码（GPL） 🤖 Agent 安装指令 ⚠️ 本工具使用 AGPL-3.0 协议。您可以自由下载和使用，但衍生作品必须以相同协议开源，不可商业闭源。使用前请确认符合协议要求。 📚 深入学习 PilotDeck 查看分步骤安装教程和完整使用指南，快速上手这款工具 ⚙️ 安装教程 📚 使用教程 🌐 原始信息 原始名称 PilotDeck 原始描述 开源AI工作流：Task-oriented AI Agent productivity platform。⭐2.7k · TypeScript Topics AI工作流TypeScript GitHub https://github.com/OpenBMB/PilotDeck License AGPL-3.0 语言 TypeScript 🔗 原始来源 🐙 GitHub 仓库  https://github.com/OpenBMB/PilotDeck 🌐 官方网站  https://pilotdeck.openbmb.cn 收录时间：2026-06-01 · 更新时间：2026-06-01 · License：AGPL-3.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。 🤖 交给 Agent 安装 · PilotDeck 选择 Agent 类型，复制安装指令后粘贴到对应客户端 Claude Code Claude Desktop Cursor 通用/自定义 claude skill install https://github.com/OpenBMB/PilotDeck 关闭 📋 复制 📺 订阅 AI Skill Hub Daily Telegram 频道 每天 8 条精选 AI Skill、MCP、Agent 与自动化工具推送 加入频道 →