# 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](../pyserver/README.md).

## Add players

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

For example:

```json
{
    "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:

```sh
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 <kbd>Ctrl</kbd>+<kbd>C</kbd>.