Blame for README.md

---
title: PyBot
emoji: 🐍
colorFrom: gray
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
---

# PyBot: Can Python be a chatbot?

A chat demo that runs [PyBot](https://github.com/huggingface/pybot), a chatbot written in plain Python, entirely in your
browser: [Pyodide](https://pyodide.org) (CPython compiled to WebAssembly) runs the bot in a Web Worker, and this Space
only serves files. Each reply shows which of PyBot's modules and files produced it; click a file to read it on GitHub.

## Files

- `index.html`: the page (chat, the reply's trace, and a treemap of PyBot's files; Plotly from jsDelivr).
- `worker.js`: loads Pyodide 314.0.7 from jsDelivr and the bot bundle, then answers turns. Like transformers.js does
  for model files, it keeps the bundle in Cache Storage, so a second visit doesn't download it again.
- `pybot_web.py`: the glue: fixed random seeds as in the benchmark's eval server (so replies match the leaderboard run),
  the trace via `sys.monitoring`, and the file that holds a reply's text.
- `pybot-<sha12>.zip`: `bot/**.pyc` compiled for Pyodide's CPython 3.14 (loading skips compiling 33 MB of source),
  plus `norm.json` (each file's text, letters and digits only) for finding the file that holds a reply.
  It is built from the same code as `bot/` in the GitHub repo.
- `tree.json`: PyBot's files and line counts for the treemap, and the repo its file links open.
- `Dockerfile`: only serves the files above (`python -m http.server`). A static Space would redirect the large files to a
  CDN without CORS headers, which blocks the worker's fetch of the bundle and the fonts.

## Rebuild from a newer bot

```sh
git clone https://github.com/huggingface/pybot && (cd pybot && zip -qr ../bot-src.zip bot -i '*.py')
npm install pyodide@314.0.7   # the same version as worker.js: bytecode only loads in the Python that compiled it
node build/build.mjs bot-src.zip build/build_bundle.py pybot-<sha12>.zip
```

Then regenerate `tree.json` (`[path, line count]` for every `bot/**.py`) and update `BUNDLE` in `worker.js` (a new
name makes browsers download the new bundle). To test locally, serve this folder (`python -m http.server`) and open it.