pi-web (Remote Control Your Pi)
[](https://github.com/ygncode/pi-web/stargazers)
[](https://www.npmjs.com/package/@ygncode/pi-web)
[](../../LICENSE)
[](https://t.me/+NJvFOTTa0wNjNTc9)
[English](../../README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [中文](README.zh.md) · [日本語](README.ja.md) · [Bahasa Indonesia](README.id.md) · [Bahasa Melayu](README.ms.md) · [Tiếng Việt](README.vi.md) · [ไทย](README.th.md) · **Filipino** · [မြန်မာ](README.my.md) · [ភាសាខ្មែរ](README.km.md) · [ລາວ](README.lo.md)
I-drive ang iyong [pi](https://pi.dev) coding agent mula sa iyong telepono, tablet, o laptop — kahit saan sa iyong network, o malayuan sa pamamagitan ng Tailscale.
Isa itong ganap na PWA, kaya maaari mo itong i-install at gamitin tulad ng isang native app sa anumang device. Isipin mo ito bilang iyong sariling personal na AI workspace — tulad ng Cowork ng Claude, ngunit may iba't ibang modelo — mag-chat sa iba't ibang modelo, mag-code mula sa iyong telepono, o gawin itong isang [personal assistant](user-docs/en/personal-assistant.md) na naninirahan sa iyong makina.
Gawin itong sa iyo: magpalit ng mga tema at font, at gamitin ito sa iyong sariling wika — ang pi-web ay may kasamang maraming wika at maaari kang magdagdag ng sarili mo. Marami pang mga feature ang paparating, ngunit hindi ito magiging bloated: anumang hindi mo kailangan ay maaaring i-off sa settings.
> [!WARNING]
> Ang pi-web ay kasalukuyang nasa **beta**. Magbabago at masisira ang mga bagay!
> [!TIP]
> Bago ka ba dito? **[Basahin ang user guide →](user-docs/en/README.md)** para sa isang buong tour ng mga feature, mga hakbang sa pag-install, at mga tip. ([Ibang mga wika →](../README.md))
## Mga Screenshot
Desktop — dark mode
Desktop — light mode
Mobile PWA
## Paano Ito Nagkakasya
```
pi (terminal) Browser (telepono / tablet / laptop)
│ │
│ sumusulat ng JSONL │ HTTP + SSE
▼ ▼
~/.pi/agent/sessions/ ←─── pi-web (Go HTTP server)
│
┌─────────────────┼─────────────────┐
│ │ │
pi --mode rpc fsnotify tailscale serve
(per‑session (live reload) (remote HTTPS
chat worker) sa pamamagitan
ng MagicDNS)
```
- **pi** ay sumusulat ng conversation JSONL sa `~/.pi/agent/sessions/` habang ito ay gumagana.
- **pi-web** ay isang Go server na nagbabasa ng mga file na iyon, nire-render ang mga ito sa browser, at nag-stream ng mga live update sa pamamagitan ng SSE.
- Ang mga **pi --mode rpc** worker ay humahawak ng chat na pinasimulan ng browser — isa bawat session, tinatanggal pagkatapos ng 10 minutong idle.
- **fsnotify** ay binabantayan ang sessions directory upang ang browser ay mag-reload sa loob ng millisecond ng bagong output.
- **Tailscale Serve** ay nagpa-publish ng localhost server bilang isang HTTPS endpoint sa iyong tailnet.
## Pag-install
```bash
pi install npm:@ygncode/pi-web@beta
```
Iyon na — dina-download nito ang katugmang binary, nagse-set up ng auto‑start, at nirerehistro ang `/web`, `/pi-web`, `/remote`, at `/refresh` na mga command.
Kapag na-install na, buksan ang `http://127.0.0.1:31415` sa iyong browser. Mula sa pi, gamitin ang `/web` upang buksan agad ang kasalukuyang session sa iyong browser. Kung tumatakbo ang Tailscale sa iyong makina, awtomatikong nagpa-publish ang pi-web ng isang HTTPS endpoint sa iyong tailnet — gamitin ang `/remote` mula sa pi upang makakuha ng QR code at URL para sa anumang device sa iyong tailnet.
Para sa mga manu-manong pag-install, pag-download ng binary, o pagbuo mula sa source, tingnan ang [user-docs/install.md](user-docs/en/install.md).
## Integrasyon ng Pi
Pagkatapos ng `pi install npm:@ygncode/pi-web@beta`, makukuha mo ang:
| Command | Kung ano ang ginagawa nito |
|---------|----------------------------|
| `/web` | Binubuksan ang kasalukuyang session sa iyong browser (may kamalayan sa SSH: nilalaktawan ang browser at ipinapakita lamang ang URL) |
| `/pi-web` | Ipinapakita ang katayuan, bersyon, pagsisimula/paghinto/pag-restart ng server, o pag-update |
| `/remote` | Ipinapakita ang isang QR code at URL para sa malayuang pag-access sa pamamagitan ng Tailscale |
| `/refresh` | Kinukuha ang mga bagong mensaheng isinulat mula sa mga remote browser pabalik sa terminal session |
Ang **auto-titling** ng session ay nakapaloob mismo sa pi-web at naka-configure sa pahina ng `/settings`. Ito ay **naka-on bilang default** at awtomatikong pinapangalanan ang mga session. Maaari kang pumili:
- **Kailan mag-title** — isang beses bawat session, o sa bawat bagong mensahe (ang default).
- **Modelo ng titulo** — isang libre, agarang **built-in word heuristic (walang AI)** bilang default, o pumili ng modelo (hal. isang maliit/mabilis) para sa mas matalinong, mga titulong isinulat ng modelo.
Ang package ay nag-i-install din ng pi-web binary sa `~/.pi/agent/bin/pi-web` at nagse-set up ng auto-start sa pag-login.
## Auto-Start sa Pag-login
Ang command na `pi install npm:@ygncode/pi-web@beta` ay awtomatikong nagse-set up nito:
| OS | Mekanismo |
|----|-----------|
| macOS | launchd plist sa `~/Library/LaunchAgents/com.pi-web.plist` |
| Linux | systemd user service sa `~/.config/systemd/user/pi-web.service` |
Upang magtakda ng token para sa malayuang pag-access, lumikha ng `~/.config/pi-web/env`:
```
PI_WEB_TOKEN=ang-iyong-token-dito
```
Para sa higit pang mga detalye (manu-manong pag-setup, mga custom port, mga non-loopback bind), tingnan ang [user-docs/install.md](user-docs/en/install.md).
## Development
```bash
make setup # i-install ang frontend deps at i-download ang Go modules
make check # frontend test/build + Go test/vet
make build # setup kung kinakailangan, i-build ang frontend, pagkatapos ay i-build ang ./pi-web
```