Skip to content

README.fil.md

Latest commit

 

History

History
119 lines (83 loc) · 7.08 KB

README.fil.md

File metadata and controls

119 lines (83 loc) · 7.08 KB
Raw

pi-web (Remote Control Your Pi)

I-drive ang iyong pi 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 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 → para sa isang buong tour ng mga feature, mga hakbang sa pag-install, at mga tip. (Ibang mga wika →)

Mga Screenshot

Desktop
Desktop

Mobile PWA
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

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.

Malayuang access sa macOS: I-install at buksan ang Tailscale nang interactive, aprubahan ang administrator prompt, at mag-sign in. Pagkatapos ay patakbuhin ang /pi-web restart, na susundan ng /remote.

Para sa mga manu-manong pag-install, pag-download ng binary, o pagbuo mula sa source, tingnan ang user-docs/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.

Development

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