Spaces:
Running
Running
File size: 2,356 Bytes
0a82323 12ea8e3 0a82323 12ea8e3 0a82323 12ea8e3 a727a3e a5edae5 5c9ff26 a5edae5 5c9ff26 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | ---
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.
|