Spaces:
Paused
Paused
| title: Pi Web runtime | |
| emoji: 🥧 | |
| colorFrom: yellow | |
| colorTo: gray | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| short_description: Sandbox image for Pi Web on Hugging Face Sandboxes | |
| # Pi Web runtime image | |
| The image every workspace machine of **Pi Web on HF Sandboxes** runs. A machine is an HF Sandbox, an | |
| [HF Job](https://huggingface.co/docs/huggingface_hub/guides/jobs) started in the signed-in user's own account from | |
| `hf.co/spaces/Mike0021/pi-web-runtime`. That is why this Space is public: Jobs in any namespace must be able to pull | |
| it. It contains no secret. | |
| What is inside: | |
| - [Pi Web](https://github.com/agegr/pi-web) 0.12.1 and the pi coding agent, built from the release tag with | |
| `piweb/hf-design.patch`: the "Pi Web on Hugging Face" design (Geist and Geist Mono, the pi mark, IBM Carbon | |
| icons, Claude Desktop's button sizes and small radii, a conversation laid out as Claude Desktop's: the session's | |
| title on top, the agent's steps folded into one line, the composer's toolbar inside it; borderless components, | |
| quieter session rows) and a slot in the sidebar footer for the gateway's workspace menu | |
| - Node 22, Python 3, uv, git, git-lfs, build tools, ripgrep, fd, jq, zstd | |
| - the `hf` CLI (`huggingface_hub` 2.1.1) and the Hugging Face agent skills in `~/.agents/skills` | |
| - `sandbox/hfpi.mjs`: the supervisor that restores the user's projects and sessions from their bucket, runs Pi Web, | |
| saves state while it changes (with a session index the Space's launcher reads), and stops the machine when idle | |
| - `sandbox/git-credential-huggingface`: git authenticates to huggingface.co with the token the user lent at sign-in | |
| - `sandbox/AGENTS.md`: what the agent is told about this environment | |
| The Space app itself only serves a short page; the gateway lives in a separate Space. | |