getpaseo/paseo

Paseo – 代码助手代理的自托管中心

Paseo 是一个开源平台，允许您在您自己的机器上运行 AI 驱动的代码助手代理（Claude Code、OpenAI Codex、GitHub Copilot、OpenCode、Pi），并通过桌面、网页、移动设备或命令行进行控制。

功能

• 运行本地守护进程 – 协调一个或多个代理，并暴露基于 WebSocket 的 API。
• 统一界面 – 相同的 UI/CLI 适用于所有支持的提供者，因此您可以为每个任务选择最适合的模型。
• 跨设备访问 – 通过加密中继、TCP、Tailscale 等方式，将手机、平板或远程服务器与守护进程配对。
• 语音模式 – 无需动手即可口述任务或讨论问题。
• 隐私优先 – 所有数据均保留在您的硬件上；无遥测数据，无强制登录。
• 通过插件扩展 – 使用可信的 TypeScript 插件添加主题、面板、自定义命令或新的代理提供者。

使用方法

1. 安装所需的代理 CLI（Claude Code、Codex、Copilot、OpenCode、Pi），并配置其凭据。
2. 启动 Paseo 守护进程 – 可通过启动桌面应用、运行全局 npm CLI（npm i -g @getpaseo/cli && paseo），或使用提供的 Docker 镜像。
3. 连接客户端 – 桌面、移动、网页或 CLI。客户端通过安全通道与守护进程通信。
4. 运行以下命令：

   paseo run --provider codex/gpt-5.5 "实现功能 X"
   paseo ls                     # 列出活动代理
   paseo attach abc123          # 流式输出实时结果
   

5. 通过 TypeScript SDK（@getpaseo/client）进行程序化集成，创建代理、输入提示并获取结果。

可扩展性

• 插件（通过 paseo plugin add <source> 安装）可提供新的 UI 面板、工作区工具或额外的代理后端。
• 技能 – 小型命令行助手（npx skills add getpaseo/paseo）可添加快捷方式，如 /paseo-handoff（在代理间移交工作）或 /paseo-committee（运行一对代理进行分析）。

部署选项

• 原生 – 在 macOS/Linux/Windows 上直接运行守护进程。
• Docker – 提供即用型容器（ghcr.io/getpaseo/paseo:latest），在端口 6767 上暴露网页 UI，并可按需扩展所需的代理 CLI。

适用人群

• 希望使用 AI 代码辅助但希望代码和凭证保留在本地的开发者。
• 需要一个可从任何设备访问的共享、自托管 AI 助手的团队。
• 希望尝试多种代码代理模型，又不想管理多个独立工具的任何人。

许可证

Apache-2.0 – 免费使用、修改和重新分发。

---

总结：Paseo 将主要 AI 代码助手整合为一个统一、自托管、注重隐私的系统，具备统一界面、语音控制以及通过插件和 TypeScript SDK 实现的可扩展性。