Spaces:
Running
Download README.md from HuggingFaceSwarms/PyBot: direct link, hf CLI and curl.
- Browser
- Download file 2.8 kB
-
https://huggingface.co/spaces/HuggingFaceSwarms/PyBot/resolve/c0b2619a7b22a7ea0185dfd611fbb0e4ea1223b1/README.md
- Command line
-
hf download hf://spaces/HuggingFaceSwarms/PyBot@c0b2619a7b22a7ea0185dfd611fbb0e4ea1223b1/README.md
-
curl -L -o README.md https://huggingface.co/spaces/HuggingFaceSwarms/PyBot/resolve/c0b2619a7b22a7ea0185dfd611fbb0e4ea1223b1/README.md
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:
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:
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. In the
hosted Space, the private HuggingFaceSwarms/pybot-chart bucket is mounted read-only
at /home/user/app/scratch, supplying progress.json across rebuilds and restarts.
To publish a regenerated snapshot, activate the local environment and run:
hf buckets cp scratch/progress.json hf://buckets/HuggingFaceSwarms/pybot-chart/progress.json
The bucket mount is configured in the Space settings, separately from Git. Preserve it when changing volumes, and recreate it when duplicating the Space. No Hub token is needed by the app. The chart shows an unavailable message if the snapshot is absent. 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.