| # Pi · MiniCPM5-2B in your browser (React) |
|
|
| Bản viết lại bằng **React + Vite + TypeScript** của Space *MiniCPM5-2B WebGPU Pi*: |
| một coding agent (MiniCPM5-2B q4f16 + shell `just-bash`) chạy **hoàn toàn trong trình duyệt** bằng WebGPU. |
| Không có API key, không có server. |
|
|
| ## Chạy trên Google AI Studio (Build) |
| 1. Đẩy thư mục này lên một repo GitHub. |
| 2. Trong AI Studio → Build → dấu **+** → **Import from GitHub**. |
| 3. Mở tab Preview. Nếu WebGPU/OPFS bị chặn trong khung xem trước, dùng nút **Open in a new tab**. |
|
|
| ## Chạy cục bộ |
| ```bash |
| npm install |
| npm run dev # http://localhost:3000 |
| npm test # test logic thuần (không cần GPU) |
| npm run build |
| ``` |
|
|
| ## Yêu cầu |
| - Chrome/Edge gần đây có WebGPU + `shader-f16`, và OPFS. |
| - Lần đầu tải ≈ **1,84 GB** từ `Mike0021/MiniCPM5-2B-ONNX` (revision được ghim, kiểm SHA-256, lưu OPFS). |
| - Runtime ONNX `.wasm` (~23 MB) tự tải từ jsDelivr/unpkg. Muốn tự host: đặt |
| `ort-wasm-simd-threaded.asyncify.{mjs,wasm}` (từ `onnxruntime-web@1.26.0-dev.20260416-b7804b056c/dist`) vào `public/runtime/`, |
| hoặc đặt biến `VITE_ORT_WASM_BASE`. |
|
|
| ## Cấu trúc |
| - `src/worker/` — engine WebGPU, tải model, parser tool-call, vòng lặp agent, workspace just-bash (chạy trong Web Worker) |
| - `src/client/` — cầu nối worker + hook `useAgent` |
| - `src/components/` — giao diện React |
| - `tests/run.ts` — test cho parser, top-p, tool, agent (model giả) |
|
|
| ## Khác bản gốc |
| Không có terminal xterm/Pi TUI, không tô màu cú pháp, không có mascot; vòng lặp agent tự viết thay cho Pi agent-core. |
| Chưa được kiểm thử với model thật trong repo này (cần GPU) — xem ghi chú khi giao. |
|
|
