Bot-Man-Toe/elo_tracker
Bram van den Heuvel 94ea1ae2f0 HOTFIX: Enforce player's supported list of games 2026-07-01 23:10:16 +02:00
..
Containerfile Create MVP ELO tracker with front-end app & Containerfile 2026-06-27 17:21:16 +02:00
README.md Convert all links to relative links 2026-06-28 23:16:39 +02:00
__init__.py Create ELO tracker MVP 2026-06-23 16:31:38 +02:00
app.py HOTFIX: Enforce player's supported list of games 2026-07-01 23:10:16 +02:00

README.md

ELO tracker

The ELO tracker lets your agent play many games and assigns every participant an Elo rating.

Before you start

The tracker only plays against remote agents. Remote agents are available through a URL, and usually run on the internet.

If your agent only exists as a local Python class, publish it first.

Add players

Open known_players.json and add the URLs you want to include.

For example:

{
    "players": [
        "https://my-agent.example",
        "https://bmt001.noordstar.me"
    ]
}

Every listed URL is considered a participant. The ELO tracker will compare these players with one another.

Start the tracker

Run:

python elo.py

The tracker will continuously schedule new matches until you stop it.

Results

Two files are updated while the tracker runs:

  • games.jsonl stores the played games.
  • known_players.json stores the list of participants.

You can stop the tracker with Ctrl+C.