pi-web (Remote Control Your Pi)
[](https://github.com/timmygod/pi-web/stargazers)
[](https://www.npmjs.com/package/@timmygod/pi-web-local)
[](../../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.fil.md) · **မြန်မာ** · [ភាសាខ្មែរ](README.km.md) · [ລາວ](README.lo.md)
သင့် [pi](https://pi.dev) coding agent ကို သင့်ဖုန်း၊ တက်ဘလက် သို့မဟုတ် လက်ပ်တော့မှ မောင်းနှင်ပါ — သင့်ကွန်ရက်ပေါ်ရှိ မည်သည့်နေရာမှမဆို သို့မဟုတ် Tailscale မှတစ်ဆင့် အဝေးမှ။
၎င်းသည် PWA အပြည့်အစုံဖြစ်သောကြောင့် မည်သည့်စက်ပစ္စည်းတွင်မဆို native app တစ်ခုကဲ့သို့ ထည့်သွင်းအသုံးပြုနိုင်ပါသည်။ ၎င်းကို သင့်ကိုယ်ပိုင် AI workspace အဖြစ် မြင်ပါ — Claude ၏ Cowork ကဲ့သို့သော်လည်း မတူညီသော model များဖြင့် — model များကြားတွင် chat လုပ်ခြင်း၊ သင့်ဖုန်းမှ code ရေးခြင်း၊ သို့မဟုတ် သင့်စက်ပေါ်တွင် တည်ရှိသော [personal assistant](../en/personal-assistant.md) အဖြစ် ပြောင်းလဲခြင်း။
သင့်ကိုယ်ပိုင်ပြုလုပ်ပါ- theme များနှင့် font များကို ပြောင်းလဲခြင်း၊ သင့်ကိုယ်ပိုင်ဘာသာစကားဖြင့် အသုံးပြုခြင်း — pi-web သည် ဘာသာစကားမျိုးစုံဖြင့် ပါရှိပြီး သင့်ကိုယ်ပိုင်ကိုလည်း ထည့်သွင်းနိုင်ပါသည်။ နောက်ထပ် feature များ လာနေဆဲဖြစ်သော်လည်း bloated ဖြစ်မည်မဟုတ်ပါ- သင်မလိုအပ်သောအရာမှန်သမျှကို settings တွင် ပိတ်ထားနိုင်ပါသည်။
## ဤ local-model edition အတွက် ဘာကြောင့်လဲ?
မူလ pi-web သည် မျှဝေထားသော ခွင့်ပြုချက်များနှင့် ပြင်ဆင်မှုများအတွက် upstream အခြေခံအုတ်မြစ်အဖြစ် ဆက်လက်တည်ရှိနေပါသည်။ ဤ edition သည် ထိုအတွေ့အကြုံကို ထိန်းသိမ်းထားပြီး၊ သင့်ကွန်ပျူတာတွင် သို့မဟုတ် သင့် LAN အတွင်း အခြားနေရာများတွင် လည်ပတ်နေသော မော်ဒယ်များအတွက် ယုံကြည်စိတ်ချရမှု အလွှာတစ်ခုကို ထပ်မံထည့်သွင်းထားသည်။ ထိုနေရာများတွင် မျိုးဆက်ပွားခြင်းသည် မကြာခဏ ပိုနှေးကွေးပြီး၊ မှတ်ဉာဏ်သည် ကန့်သတ်ထားကာ၊ ရှည်လျားသော context သည် ကျန်းမာသော session တစ်ခုကို ရပ်တန့်စေနိုင်သည်။
| နယ်ပယ် | Upstream pi-web | ဤ edition |
|------|-----------------|--------------|
| Model/runtime မူဝါဒ | စံ pi-web အပြုအမူ | Session အလိုက် **Auto / Local / Cloud** mode၊ endpoint-aware local detection နှင့် persistent manual override ပါဝင်သည် |
| ရှည်လျားသော context ကိုင်တွယ်ခြင်း | ပုံမှန် pi compaction အပြုအမူ | Local Mode သည် **65%** တွင် ကြိုတင်ပြုလုပ်ပြီး၊ အခြား provider တောင်းဆိုမှုတစ်ခုမတိုင်မီ ရှည်လျားသော tool-call loops အတွင်း ပြန်လည်စစ်ဆေးသည် |
| Compaction ဘေးကင်းရေး | စံအကျဉ်းချုပ်များ | Bounded rolling checkpoints၊ မမှန်ကန်သော/capped output အတွက် ပိုမိုတင်းကျပ်သော ပြန်လည်ရေးသားခြင်းတစ်ခု၊ နှင့် အဆုံးမရှိ re-compaction အစား တိုးတက်မှုမရှိခြင်းကို ထောက်လှမ်းခြင်း |
| ပြတ်တောက်သော လည်ပတ်မှုများ | ပုံမှန် worker နှင့် error ကိုင်တွယ်ခြင်း | Context overflow၊ thinking-only stops နှင့် ရွေးချယ်ထားသော transport interruptions များအတွက် bounded recovery၊ persistent loop breakers များနှင့်အတူ |
| လက်ဖြင့် ကယ်ဆယ်ခြင်း | စံ context အသေးစိတ် | **Force Compact** သည် စကားဝိုင်းကို ဖျက်သိမ်းခြင်းမရှိဘဲ ရှင်းလင်းသော ပြန်လည်ရရှိရေး လမ်းကြောင်းအဖြစ် ဆက်လက်ရရှိနိုင်သည် |
| ကိုက်ညီမှုနှင့် ထုတ်ဝေမှုများ | မူလပရောဂျက်နှင့် ထုတ်ဝေမှုလိုင်း | Local-only safeguards များသည် Local Mode နောက်တွင် ဆက်လက်တည်ရှိနေသည်။ Cloud Mode သည် upstream အပြုအမူကို ထိန်းသိမ်းပြီး၊ upstream ပြောင်းလဲမှုများကို ဤနေရာတွင် သီးခြားစီ သုံးသပ်ပြီး ထုတ်ဝေသည် |
ဤသည်မှာ upstream အတွက် ပြန်လည်ရေးသားခြင်း သို့မဟုတ် အစားထိုးခြင်း မဟုတ်ပါ။ ဤသည်မှာ ခိုင်မာမှုနည်းသော ရှည်လျားစွာ လည်ပတ်နေသော session များကို လက်ခံခြင်းမရှိဘဲ local-model privacy နှင့် ထိန်းချုပ်မှုကို လိုချင်သော လူများအတွက် ရည်ရွယ်ချက်ရှိရှိ ထိန်းသိမ်းထားသော လည်ပတ်ရေး profile ဖြစ်သည်။ အသုံးပြုသူအတွက် workflow အတွက် [user guide](../en/README.md) ကို ကြည့်ရှုပါ၊ အကောင်အထည်ဖော်ခြင်းနှင့် synchronization မူဝါဒအတွက် [local-model edition development](../../docs/dev/local-llm-development.md) ကို ကြည့်ရှုပါ။
> [!WARNING]
> pi-web သည် လက်ရှိတွင် **beta** အဆင့်ဖြစ်သည်။ အရာများ ပြောင်းလဲပြီး ပျက်စီးနိုင်ပါသည်။
> [!TIP]
> အသစ်ဖြစ်ပါသလား။ feature များ၏ အပြည့်အစုံလမ်းညွှန်၊ ထည့်သွင်းနည်းအဆင့်ဆင့်နှင့် အကြံပြုချက်များအတွက် **[အသုံးပြုသူလမ်းညွှန်ကို ဖတ်ပါ →](../en/README.md)** ([အခြားဘာသာစကားများ →](../README.md))
## Screenshots
Desktop
မိုဘိုင်း PWA
## မည်သို့ချိတ်ဆက်အလုပ်လုပ်ပုံ
```
pi (terminal) Browser (phone / tablet / laptop)
│ │
│ writes 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) via MagicDNS)
```
- **pi** သည် အလုပ်လုပ်နေစဉ် conversation JSONL ကို `~/.pi/agent/sessions/` သို့ ရေးသားသည်။
- **pi-web** သည် ထိုဖိုင်များကို ဖတ်ရှုကာ browser တွင် render လုပ်ပြီး SSE မှတစ်ဆင့် live update များ stream လုပ်ပေးသည့် Go server တစ်ခုဖြစ်သည်။
- **pi --mode rpc** worker များသည် browser မှစတင်သော chat ကို ကိုင်တွယ်သည် — session တစ်ခုလျှင် တစ်ခု၊ ၁၀ မိနစ် idle ပြီးနောက် ဖယ်ရှားခံရသည်။
- **fsnotify** သည် sessions directory ကို စောင့်ကြည့်သောကြောင့် output အသစ်ရောက်ပြီး မီလီစက္ကန့်အတွင်း browser က reload လုပ်သည်။
- **Tailscale Serve** သည် localhost server ကို သင့် tailnet ပေါ်တွင် HTTPS endpoint အဖြစ် ထုတ်ပြန်ပေးသည်။
## ထည့်သွင်းနည်း
```bash
pi install npm:@timmygod/pi-web-local@beta
```
ဒါပါပဲ — ၎င်းသည် သင့်လျော်သော binary ကို download လုပ်ကာ auto‑start ပြင်ဆင်သတ်မှတ်ပြီး `/web`၊ `/pi-web`၊ `/remote` နှင့် `/refresh` command များကို register လုပ်ပေးပါသည်။
ထည့်သွင်းပြီးသည်နှင့် သင့် browser တွင် `http://127.0.0.1:31415` ကိုဖွင့်ပါ။ pi မှ၊ လက်ရှိ session ကို သင့် browser တွင် ချက်ချင်းဖွင့်ရန် `/web` ကို အသုံးပြုပါ။ သင့်စက်တွင် Tailscale ကို run ထားပါက pi-web သည် သင့် tailnet ပေါ်တွင် HTTPS endpoint တစ်ခုကို အလိုအလျောက် ထုတ်ပြန်ပေးသည် — သင့် tailnet ပေါ်ရှိ မည်သည့်စက်အတွက်မဆို QR code နှင့် URL ရယူရန် pi မှ `/remote` ကို အသုံးပြုပါ။
> **macOS မှ အဝေးမှ ဝင်ရောက်အသုံးပြုခြင်း:** Tailscale ကို အပြန်အလှန်အသုံးပြုနိုင်သည့်နည်းဖြင့် တပ်ဆင်ပြီး ဖွင့်ပါ၊ စီမံခန့်ခွဲသူအတည်ပြုချက်တောင်းခံမှုကို အတည်ပြုပြီး အကောင့်ဝင်ပါ။ ထို့နောက် `/pi-web restart` ကို လုပ်ဆောင်ပြီး `/remote` ကို လုပ်ဆောင်ပါ။
Manual ထည့်သွင်းခြင်း၊ binary download များ သို့မဟုတ် source မှ build လုပ်ခြင်းအတွက် [user-docs/install.md](../en/install.md) ကို ကြည့်ပါ။
## Pi နှင့်ပေါင်းစပ်မှု
`pi install npm:@timmygod/pi-web-local@beta` ပြီးနောက်၊ သင်ရရှိသည်များ-
| Command | လုပ်ဆောင်ချက် |
|---------|--------------|
| `/web` | လက်ရှိ session ကို browser တွင်ဖွင့်ပါ (SSH-သိရှိနိုင်သည်- browser ကိုကျော်ပြီး URL သာပြသသည်) |
| `/pi-web` | status၊ version ပြသခြင်း၊ server ကို start/stop/restart လုပ်ခြင်း သို့မဟုတ် update လုပ်ခြင်း |
| `/remote` | Tailscale မှတစ်ဆင့် အဝေးမှအသုံးပြုရန် QR code နှင့် URL ကိုပြသခြင်း |
| `/refresh` | အဝေးမှ browser များမှ ရေးသားထားသော မက်ဆေ့ချ်အသစ်များကို terminal session ထဲသို့ ပြန်လည်ဆွဲယူခြင်း |
Session **auto-titling** ကို pi-web တွင်ယှဉ်တွဲပါရှိပြီး `/settings` စာမျက်နှာတွင် configure လုပ်နိုင်ပါသည်။ ၎င်းသည် **မူလအားဖြင့် ဖွင့်ထားသည်** ဖြစ်ပြီး session များကို အလိုအလျောက် အမည်ပေးပါသည်။ သင်ရွေးချယ်နိုင်သည်များ-
- **မည်သည့်အချိန်တွင် အမည်ပေးမည်နည်း** — session တစ်ခုလျှင် တစ်ကြိမ်၊ သို့မဟုတ် မက်ဆေ့ချ်အသစ်တိုင်းတွင် (မူလသတ်မှတ်ချက်)။
- **ခေါင်းစဉ်ပေး model** — မူလအားဖြင့် အခမဲ့၊ ချက်ချင်းလက်ငင်း **built-in word heuristic (AI မပါ)** သို့မဟုတ် ပိုမိုထက်မြက်သော model ရေးသားသည့် ခေါင်းစဉ်များအတွက် model တစ်ခု (ဥပမာ သေးငယ်/မြန်ဆန်သော) ကို ရွေးချယ်ပါ။
ထို package သည် pi-web binary ကို `~/.pi/agent/bin/pi-web` သို့လည်း ထည့်သွင်းပြီး login ဝင်သည့်အခါ auto-start ပြင်ဆင်ပေးပါသည်။
## Login ဝင်သည့်အခါ Auto-Start
`pi install npm:@timmygod/pi-web-local@beta` command က ၎င်းကို အလိုအလျောက် ပြင်ဆင်ပေးပါသည်-
| OS | လုပ်ဆောင်ပုံ |
|----|-----------|
| macOS | `~/Library/LaunchAgents/com.pi-web.plist` တွင် launchd plist |
| Linux | `~/.config/systemd/user/pi-web.service` တွင် systemd user service |
အဝေးမှအသုံးပြုခွင့်အတွက် token တစ်ခုသတ်မှတ်ရန် `~/.config/pi-web/env` ကို ဖန်တီးပါ-
```
PI_WEB_TOKEN=your-token-here
```
အသေးစိတ်အတွက် (manual ပြင်ဆင်သတ်မှတ်ခြင်း၊ custom port များ၊ non-loopback bind များ) [user-docs/install.md](../en/install.md) ကို ကြည့်ပါ။
## Development
```bash
make setup # frontend deps ထည့်သွင်းပြီး Go module များ download လုပ်ပါ
make check # frontend test/build + Go test/vet
make build # လိုအပ်ပါက setup၊ frontend build၊ ထို့နောက် ./pi-web build
```