---
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.