PyBot / README.md
lewtun's picture
lewtun HF Staff
Overlay measured Python source lines on progress chart
5c9ff26
|
Raw History Blame
2.36 kB
---
title: PyBot
emoji: 🐍
colorFrom: gray
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
---
PyBot: a conversational bot without LLMs, written by a swarm of LLM agents. One page: the story and a live chat that shows
which of PyBot's modules and files produced each reply. Pinned to commit `64eb2c844738` of `HuggingFaceSwarms/SwarmChat-v8`.
`app.py` serves `site/` and `POST /api/chat` / `POST /api/trace`; `bot/bot-<sha12>.zip` holds the bot's source (`bot/**.py` only);
`bot_runner.py` runs it in a fresh worker per request. Built by `build_pybot.py` in the swarmchat-release workspace.
## Run locally
Use Python 3.12 (required by the trace endpoint) on macOS or Linux:
```sh
uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install -r requirements.txt
uvicorn app:app --host 127.0.0.1 --port 7860
```
Open http://127.0.0.1:7860. The health endpoint is `/health`.
Keep local logs and temporary files in `scratch/`, which is ignored by Git.
### Progress chart
Generate the chart snapshot from the leaderboard's v3 cache before starting the app:
```sh
python build_progress.py /path/to/swarmchat-leaderboard-v3.json --source-repo scratch/v8-history.git
```
The generated data stays in `scratch/progress.json` and is never committed. Supply
that file separately when deploying (at `/home/user/app/scratch/progress.json` in
the Docker image). The chart shows an unavailable message if no snapshot is present.
It uses the leaderboard's length-penalised percentage metric and latest successful
1,000-prompt run per revision, with all three SmolLM baselines. The contiguous outage
plateau from November 7, 2026, 12:12:47 through 13:15:11 UTC (commit times) is omitted;
other score fluctuations and the original revision positions are preserved.
The right axis overlays physical lines in `bot/**/*.py` at each retained evaluated
commit, including blank lines and comments but excluding tests. Counts come from
the source repository's first-parent Git diffs, including deletions and merges.
Fetch the source history into `scratch/v8-history.git` before building the snapshot;
unavailable commits get a null code-size value, rather than an estimate. The first
evaluated seed (`541b8def5107`) predates the current main history and is no longer
available from the Hub; its win-rate point remains, but its code-size point is absent.