Skip to content
Projects

wdm0006/elote has 34 GitHub stars and 4 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 20:15 UTC. Last push 2026-11-14.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Compare Elo, Glicko, TrueSkill, Bradley-Terry, and other rating algorithms behind a largely uniform Python interface.

Machine Learning

README.md

Original

Elote

PyPI version Python versions License: MIT

The scikit-learn of rating algorithms: compare rating models behind one largely uniform Python interface, then keep the one that fits your data.

Use Elote to turn pairwise wins, losses, and draws into expected scores and rankings. Start with Elo, switch to Glicko, TrueSkill, Bradley-Terry, or another included model without rewriting the surrounding workflow, and evaluate the alternatives on the same match history.

pip install elote

Compare and rank in 60 seconds

The same matchups can drive different rating systems:

from elote import EloCompetitor, GlickoCompetitor, LambdaArena

winner_loser_pairs = [
    ("Ada", "Grace"),
    ("Grace", "Linus"),
    ("Ada", "Linus"),
    ("Grace", "Linus"),
]

for model in (EloCompetitor, GlickoCompetitor):
    arena = LambdaArena(lambda winner, loser: True, base_competitor=model)
    for winner, loser in winner_loser_pairs:
        arena.matchup(winner, loser)

    ranking = [row["competitor"] for row in arena.leaderboard()]
    print(f"{model.__name__}: {' > '.join(ranking)}")
EloCompetitor: Ada > Grace > Linus
GlickoCompetitor: Ada > Grace > Linus

LambdaArena owns the population, creates competitors as identifiers appear, records each bout, and returns the leaderboard best-first. Change base_competitor to compare another model with the same application code.

Choose your task

I want to... Start with
Rate two competitors directly Create two matching competitor objects; call expected_score(), then beat(), lost_to(), or tied(). See Getting started.
Manage a changing population Use LambdaArena with your identifiers and results, then read leaderboard() and history. See Arenas.
Compare models on held-out data Build a DataSplit, then use evaluate_competitor() or benchmark_competitors() and the plotting helpers. See elote/benchmark.py.
Save and resume ratings Call export_state() or to_json() and store the result yourself; restore with from_state(), from_json(), or LambdaArena(initial_state=...). See Serialization.

Install the dataset adapters when you want the Lichess chess or college-football loaders:

pip install "elote[datasets]"

Install the plotting helpers when you want the visualization functions:

pip install "elote[viz]"

SyntheticDataset and the core rating systems are included in the base installation.

Rating models

Every row below is exported from elote and supports the shared competitor workflow. Constructor parameters and algorithm-specific state still differ.

Model Class Model shape
Elo EloCompetitor Incremental rating
Glicko-1 GlickoCompetitor Incremental rating and rating deviation
Glicko-2 Glicko2Competitor Incremental rating, deviation, and volatility
TrueSkill TrueSkillCompetitor Bayesian mean and uncertainty
ECF ECFCompetitor English Chess Federation rating
DWZ DWZCompetitor German chess rating
Colley Matrix ColleyMatrixCompetitor Global fit over the matchup graph
Massey MasseyCompetitor Global least-squares fit using score margins
Keener KeenerCompetitor Global eigenvector fit using scores
Pythagorean PythagoreanCompetitor Points-based win expectation from points scored and allowed
Bradley-Terry BradleyTerryCompetitor Global paired-comparison fit
Whole-History Rating WholeHistoryRatingCompetitor Time-aware Bradley-Terry rating curve
Blended ensemble BlendedCompetitor Composition of multiple competitor models

The common surface covers expected scores, results, ratings, reset, configuration, and state serialization. It does not erase meaningful differences in parameters, uncertainty, rating scale, or whether a model updates incrementally or refits a connected population.

Evaluation tools

Elote keeps pre-result predictions in History objects so you can inspect accuracy, precision, recall, F1, draw-aware metrics, confusion counts, calibration data, optimized decision thresholds, and accuracy by prior bouts. Dataset helpers train on one split and evaluate on another without updating ratings on the held-out rows. Benchmark results retain the trained arena and history for further analysis.

The package also includes plotting helpers for rating-system comparisons, optimized accuracy, calibration, and accuracy by prior bouts.

To see how the rating models compare on the same split, run make compare-systems (or scripts/rating_system_comparison.py directly) for accuracy, Brier score, and log loss — see docs/source/rating_systems/comparison_benchmark.rst for methodology and measured results.

Library boundaries

Elote is an in-process Python library. It does not provide a CLI, hosted API, server, user interface, accounts, authentication, or a database. Your application supplies identifiers and results, decides how a model is selected, and stores exported dictionaries or JSON in the persistence system it owns.

Trust and project status

  • Python 3.10 or later
  • Typed-package marker (py.typed)
  • MIT licensed
  • Behavioral and known-value tests across the model catalog, plus tests for serialization, datasets, benchmarking, histories, plots, and the shared interface
  • Published with an Alpha development classifier

See the full documentation and the examples/ directory for more workflows.

Blog Posts

Here are some blog posts about Elote:

References

  1. Glicko Rating System
  2. Glicko-2 Rating System
  3. Massey Ratings
  4. Elo, Arpad (1978). The Rating of Chessplayers, Past and Present. Arco. ISBN 0-668-04721-6.
  5. ECF Grading System
  6. Deutsche Wertungszahl
  7. TrueSkill: A Bayesian Skill Rating System

Contributing

Contributions are welcome. Read CONTRIBUTING.md and the Code of Conduct, then open an issue or pull request.

git clone https://github.com/wdm0006/elote.git
cd elote
make install-dev
make test       # or: make test-cov
make lint       # or: make lint-fix, make format
make docs       # or: make build

Elote is available under the MIT License.