Paimon，让你能在浏览器里跟所有 Pi 实例对话。

📸 截图

✨ 特性

• 💬 实时对话流 — 流式输出、思考过程、工具调用全展示
• 🖼️ 图片支持 — 粘贴或上传图片发送给 LLM，历史消息中可查看大图
• 🔄 多实例切换 — 一个页面管理所有 pi 会话
• 🌐 多机支持 — 中心化 Hub + 分布式 Edge，管理多台服务器上的 pi 实例
• ➕ 页面创建实例 — 选择 Edge 节点 + 路径选择器
• 📋 Session 管理 — 浏览历史 session，一键新建或切换
• 🔒 访问认证 — Access Token 保护所有 API 和 WebSocket 连接
• 🎨 毛玻璃风格界面 — 清爽的 macOS 风格设计
• 🌐 多语言支持 — 中文/英文界面，设置页一键切换
• 📱 响应式设计 — 桌面/移动端自适应，iOS Safe Area 适配

📋 前置要求

• Pi >= 0.78.1
• Node.js >= 18（npm 安装方式）或 Bun（从源码安装）

🚀 快速开始

Paimon 采用三层架构：

• Hub — 中心服务，服务 Web UI，接收 Edge 上报
• Edge — 每台机器上的代理，管理本机 pi 实例
• Extension — pi 插件，自动连接本机 Edge

安装

npm 安装（推荐）

npm install -g @tyanxie/paimon    # 安装 paimon CLI
pi install npm:@tyanxie/paimon   # 安装 pi 插件

从源码安装

git clone https://github.com/tyanxie/paimon.git && cd paimon
bun install       # 安装依赖
bun run build     # 构建前端
bun link          # 安装 paimon CLI
pi install .      # 安装 pi 插件

使用

# 启动 Hub
paimon hub start

# 启动 Edge
paimon edge start

# 启动 pi（任意目录）
pi

# 打开浏览器（首次需输入启动时输出的 Access Token）
open http://localhost:8080

多机部署

# 机器 A（Hub 所在机器）
paimon hub start --host 0.0.0.0
paimon edge start --hub ws://localhost:8080

# 机器 B（远程服务器，需指定 Hub 的 token）
paimon edge start --hub ws://<hub-ip>:8080 --token <access-token>

🔒 --host 0.0.0.0 会暴露服务到公网。当前不支持 TLS，token 明文传输可被网络嗅探，建议仅在可信网络使用或通过反向代理（nginx/caddy）提供 TLS。

📄 License

MIT