trueskill

What it is and what it does

TrueSkill is a Bayesian skill rating system developed by Microsoft and used on Xbox Live to rank and match players. It provides functions to initialize player ratings, compute match quality (fairness), and update ratings after match outcomes. The package exports a simple API: Rating objects represent player skill, quality_1vs1 estimates match fairness, and rate_1vs1 updates ratings after a match result.

The package has no runtime dependencies and works across Python 2.7 and Python 3.4+. However, it is distributed as a source tarball only and has not been maintained since 2018, with no recent updates or security patches. It is suitable for hobby projects, educational use, or legacy systems already using it, but carries the risk of incompatibility with future Python versions and lack of maintainer support.

Use it for:

• Implement player ranking in turn-based or multiplayer games where Bayesian skill estimation is preferred over simpler Elo-style systems.
• Compute match fairness before pairing players to avoid lopsided matchups in competitive gaming.
• Educational projects studying Bayesian inference and skill rating algorithms.
• Legacy systems or hobby projects already integrated with TrueSkill that do not require active maintenance.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Implements the TrueSkill rating algorithm to compute player skill ratings and match quality in competitive games.

No for new projects. The package is abandoned (last release 2018-09-07) with no active maintenance, high install friction (source-only), and classifiers that predate modern Python versions. Use it only if you are maintaining existing code already depending on it, or for educational exploration of the TrueSkill algorithm. For new competitive rating systems, consider actively maintained alternatives.

Install

trueskill on PyPI

pip install trueskill

uv add trueskill

poetry add trueskill

Installing trueskill

Before you install

High install friction due to source-only distribution (tarball). Maintenance status is abandoned—last release was 2018-09-07, over 2898 days ago. No active development or security updates.

License in practice

BSD license is permissive; you may use, modify, and distribute the package freely with minimal restrictions.

Quickstart

from trueskill import Rating, quality_1vs1, rate_1vs1
alice, bob = Rating(25), Rating(30)
if quality_1vs1(alice, bob) < 0.50:
    print('Match fairness low')
alice, bob = rate_1vs1(alice, bob)

Requires Python 2.7 or Python 3.4+; no external runtime dependencies but source distribution requires build tools.

Verify before relying

• Whether the package builds and runs correctly on modern Python versions (3.8+) despite classifiers stopping at 3.7.
• Whether the algorithm implementation matches current TrueSkill specifications or if it has known mathematical limitations.
• Community adoption and whether alternatives have superseded it for new projects.

Package facts

Evidence: trueskill-0.4.5.tar.gz

Tags

More Mathematics packages

Further reading