---
id: trueskill
version: "0.4.5"
license: BSD
license_treatment: permissive
maintenance: abandoned
---

# trueskill — The video game rating system

License: permissive · Maintenance: abandoned · Downloads: 200.2K/mo

## 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 above — 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

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

- License: BSD (permissive)
- Python support: supports_current
- Install friction: high
- Maintenance: abandoned
- Downloads: 200.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

trueskill rating system, player skill ranking algorithm, game matchmaking rating, competitive player rating, elo alternative rating system, xbox live ranking system, bayesian skill rating, game-rating, skill-ranking, abandoned

[View on SkillFed](https://skillfed.io/packages/trueskill) · [View on PyPI](https://pypi.org/project/trueskill/)