README.md

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ộ

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.