Watch Β· Interact Β· Control
δΈζ | English
Paimon lets you talk to all your [Pi](https://pi.dev/) instances from the browser.
## πΈ Screenshots
## β¨ Features
- π¬ **Real-time Streaming** β Streaming output, thinking process, and tool calls fully displayed
- πΌοΈ **Image Support** β Paste or upload images to send to LLM, view full-size in history
- π **Multi-instance Switching** β Manage all pi sessions in one page
- π **Multi-machine Support** β Centralized Hub + distributed Edge, manage pi instances across servers
- β **Create Instances from UI** β Select Edge node + path picker
- π **Session Management** β Browse session history, create or switch with one click
- π **Access Control** β Access Token protects all API and WebSocket connections
- π¨ **Frosted Glass UI** β Clean macOS-style design
- π **Multi-language** β Chinese/English interface, switchable in settings
- π± **Responsive Design** β Desktop/mobile adaptive, iOS Safe Area support
## π Prerequisites
- [Pi](https://pi.dev/) >= 0.78.1
- Node.js >= 18 (for npm install) or [Bun](https://bun.sh/) (for source install)
## π Quick Start
Paimon uses a three-layer architecture:
- **Hub** β Central server, serves Web UI, receives Edge reports
- **Edge** β Agent on each machine, manages local pi instances
- **Extension** β Pi plugin, automatically connects to local Edge
### Installation
**npm (recommended)**
```bash
npm install -g @tyanxie/paimon # Install paimon CLI
pi install npm:@tyanxie/paimon # Install pi extension
```
**From source**
```bash
git clone https://github.com/tyanxie/paimon.git && cd paimon
bun install # Install dependencies
bun run build # Build frontend
bun link # Install paimon CLI
pi install . # Install pi extension
```
### Usage
```bash
# Start Hub
paimon hub start
# Start Edge
paimon edge start
# Start pi (any directory)
pi
# Open browser (enter Access Token printed at startup on first visit)
open http://localhost:8080
```
### Multi-machine Deployment
```bash
# Machine A (where Hub runs)
paimon hub start --host 0.0.0.0
paimon edge start --hub ws://localhost:8080
# Machine B (remote server, specify Hub's token)
paimon edge start --hub ws://:8080 --token
```
> π `--host 0.0.0.0` exposes the service publicly. TLS is not currently supported β tokens are transmitted in plaintext and can be sniffed. Use only on trusted networks or behind a reverse proxy (nginx/caddy) with TLS.
## π License
MIT