Skip to main content

Python recommendation tools

Automatic Tests codecov Scientific Python Ecosystem Coordination PyPI - Version Conda Version

LensKit is a set of Python tools for experimenting with and studying recommender systems. It provides support for training, running, and evaluating recommender algorithms in a flexible fashion suitable for research and education.

LensKit for Python (LKPY) is the successor to the Java-based LensKit project.

Installing

To install the current release with uv (recommended):

$ uv pip install lenskit

Or, to add it to your project's dependencies and virtual environment:

$ uv add lenskit

Classic pip also works:

$ python -m pip install lenskit

Then see Getting Started

Conda Packages

You can also install LensKit from conda-forge with pixi:

$ pixi add lenskit

Or conda:

$ conda install -c conda-forge lenskit

Development Version

To use the latest development version, you have two options. You can install directly from GitHub:

$ uv pip install -U git+https://github.com/lenskit/lkpy

Or you can use our PyPI index, by adding to pyproject.toml:

[[tool.uv.index]]
name = "lenskit"
url = "https://pypi.lenskit.org/lenskit-dev/"

Binary wheels of LensKit development (and release) versions are automatically pushed to this index, although they are not guaranteed to be permanently available. Reproducible code should generally depend on released versions published to PyPI.

Simplifying PyTorch installation

We also provide mirrors of the PyTorch package repositories that are filtered to only include PyTorch and directly supporting dependencies, without other packages that conflict with or mask packages from PyPI, and with fallbacks for other platforms (i.e., our CUDA indices include CPU-only MacOS packages). This makes it easier to install specific versions of PyTorch in your project with the index priority and fallthrough logic implemented by uv. To make your project only use CPU-based PyTorch, you can add to pyproject.toml:

[[tool.uv.index]]
name = "torch-cpu"
url = "https://pypi.lenskit.org/torch/cpu/"

Or CUDA 12.8:

[[tool.uv.index]]
name = "torch-gpu"
url = "https://pypi.lenskit.org/torch/cu128/"

These indices provide the same package distributions as the official PyTorch repositories (in fact, they link directly to the PyTorch packages). They are just an alternate index view that reduces some package conflicts.

Developing

To contribute to LensKit, clone or fork the repository, get to work, and submit a pull request. We welcome contributions from anyone; if you are looking for a place to get started, see the issue tracker.

Our development workflow is documented in the wiki; the wiki also contains other information on developing LensKit. User-facing documentation is at https://lenskit.org.

We use uv for developing LensKit and managing development environments. Our pyproject.toml file contains the Python development dependencies; you also need a working Rust compiler (typically via rustup), although uv sync will automatically install enough of one to build LensKit. You will also need a working C compiler (on macOS, install Xcode or the Xcode command-line tools).

The easiest way to work on LensKit is to use the devcontainer — in Visual Studio Code, Zed, and other editors supporting Dev Containers, just re-open the project in a dev container, and the necessary software will be automatically installed.

If you want to set up yourself, the uv dependencies have everything needed:

$ uv sync
$ uv run prek install

If you want to use a specific Python version, select it with uv venv or uv sync:

$ uv venv -p 3.14t
$ uv sync

If you want all extras, do:

$ uv sync --all-extras

Testing Changes

You should always test your changes by running the LensKit test suite:

uv run just test

If you want to use your changes in a LensKit experiment, you can locally install your modified LensKit into your experiment's environment. We recommend using separate environments for LensKit development and for each experiment; you will need to install the modified LensKit into your experiment's repository:

uv pip install -e /path/to/lkpy

Resources

Acknowledgements

This material is based upon work supported by the National Science Foundation under Grant Nos. IIS 17-51278 and 24-15042. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the National Science Foundation.

Metadata

Release files for lenskit 2026.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lenskit 2026.5.0
File Size Uploaded Provenance Actions
lenskit-2026.5.0.tar.gz 3.1 MB With provenance Details for lenskit-2026.5.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for lenskit 2026.5.0
File Actions
lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_x86_64.whl CPython 3.15 CPython 3.15 free-threading Linux glibc 2.28+ x86-64 Details for lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_x86_64.whl
lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_aarch64.whl CPython 3.15 CPython 3.15 free-threading Linux glibc 2.28+ ARM64 Details for lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_aarch64.whl
lenskit-2026.5.0-cp315-cp315t-macosx_11_0_arm64.whl CPython 3.15 CPython 3.15 free-threading macOS 11.0+ ARM64 Details for lenskit-2026.5.0-cp315-cp315t-macosx_11_0_arm64.whl
lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 Details for lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_x86_64.whl
lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_aarch64.whl CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64 Details for lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_aarch64.whl
lenskit-2026.5.0-cp314-cp314t-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 Details for lenskit-2026.5.0-cp314-cp314t-macosx_11_0_arm64.whl
lenskit-2026.5.0-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for lenskit-2026.5.0-cp312-abi3-win_amd64.whl
lenskit-2026.5.0-cp312-abi3-manylinux_2_28_x86_64.whl CPython 3.12 abi3 Linux glibc 2.28+ x86-64 Details for lenskit-2026.5.0-cp312-abi3-manylinux_2_28_x86_64.whl
lenskit-2026.5.0-cp312-abi3-manylinux_2_28_aarch64.whl CPython 3.12 abi3 Linux glibc 2.28+ ARM64 Details for lenskit-2026.5.0-cp312-abi3-manylinux_2_28_aarch64.whl
lenskit-2026.5.0-cp312-abi3-macosx_11_0_arm64.whl CPython 3.12 abi3 macOS 11.0+ ARM64 Details for lenskit-2026.5.0-cp312-abi3-macosx_11_0_arm64.whl

Total release size: 86.4 MB

Release files / lenskit-2026.5.0.tar.gz

Download URL lenskit-2026.5.0.tar.gz
Size 3.1 MB
Tags Source
SHA-256 checksum
How to use checksums
557e7b8822b214c7bda0e6179a4e1933a1dc83437f2f6632b6bf6ca410077745
BLAKE2b-256 checksum
How to use checksums
f9bf860dbc3c6e1f495dd09222c62e6dedaf49735e2a73c7c526eeab9d07f060
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_x86_64.whl

Download URL lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_x86_64.whl
Size 11.8 MB
Tags CPython 3.15 CPython 3.15 free-threading Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
f0a9f42dd24e5118562e4fbb7fbbec3e6a360e46c831fdc56d012d2de99f34e6
BLAKE2b-256 checksum
How to use checksums
6c8acef3736a942016002de1623fd52c3f853535055af3650b9b6e298cc6fea7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_aarch64.whl

Download URL lenskit-2026.5.0-cp315-cp315t-manylinux_2_28_aarch64.whl
Size 11.0 MB
Tags CPython 3.15 CPython 3.15 free-threading Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
980ec16af667d476579bf4b5e67fc395a471ed1f588bcf9078db5adf1997acee
BLAKE2b-256 checksum
How to use checksums
874deebc4b497db307f93258f7de4e22fcf98d1e5528802834c7ce0ad3cf8370
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp315-cp315t-macosx_11_0_arm64.whl

Download URL lenskit-2026.5.0-cp315-cp315t-macosx_11_0_arm64.whl
Size 3.6 MB
Tags CPython 3.15 CPython 3.15 free-threading macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
b1bd8f47a86bcda0c6938195078ac6e39587fbfc4dd2f5204caee25027d37378
BLAKE2b-256 checksum
How to use checksums
4626dd15a4bb246cbd6024c74f8e27879076b296fc4144577ddd0336d8ffc57b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_x86_64.whl

Download URL lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_x86_64.whl
Size 11.8 MB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
0c9a07eea3e6a7db83920646f4abf9a7b51c60a968ff6bf1072807f5c0f8f38d
BLAKE2b-256 checksum
How to use checksums
05f6ff443b4a3c2c9e218790f8c95b1b4f3968d43fb722473c41c8eacadb51fd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_aarch64.whl

Download URL lenskit-2026.5.0-cp314-cp314t-manylinux_2_28_aarch64.whl
Size 11.0 MB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
a02a6c28a27f9080e29de3ddf0fc6f39fc4cf7796d3de53dd08128983bf8703c
BLAKE2b-256 checksum
How to use checksums
ef595a4a5520833db8ca0961ff9b642744ea757767a089847abcbe766eaeb55d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp314-cp314t-macosx_11_0_arm64.whl

Download URL lenskit-2026.5.0-cp314-cp314t-macosx_11_0_arm64.whl
Size 3.6 MB
Tags CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
76ef7de5b0fb8ffed1984e759c4f759bd93e4171e0167ad82a5376b9037299a2
BLAKE2b-256 checksum
How to use checksums
7bdbdec6ede864d7f6ecbe6937095965c162b361bc7421aa3b69396743eebe23
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp312-abi3-win_amd64.whl

Download URL lenskit-2026.5.0-cp312-abi3-win_amd64.whl
Size 3.9 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
3c7d3873edcc1464f7dcbe916546df32e141f790f4440c63e4e09aff8cde07c7
BLAKE2b-256 checksum
How to use checksums
4ff5826908912994ce653814d17cc726700e907a36e77f36ba85e35cea108180
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp312-abi3-manylinux_2_28_x86_64.whl

Download URL lenskit-2026.5.0-cp312-abi3-manylinux_2_28_x86_64.whl
Size 11.8 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
30016ff401a623902c58bc559b3c7ed371002f83526310b9f2ace8285ef59cdd
BLAKE2b-256 checksum
How to use checksums
c4d4c98e02748cd3e60875212ad09fb2731f79532f3902266393d2276b2773f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp312-abi3-manylinux_2_28_aarch64.whl

Download URL lenskit-2026.5.0-cp312-abi3-manylinux_2_28_aarch64.whl
Size 11.0 MB
Tags CPython 3.12 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
9047b7c9d1c8d2da03baf4dd918a20a1afc44d19c5999434d4bcf59228ef2443
BLAKE2b-256 checksum
How to use checksums
d6df7d495fb939126da06825ec484ebe3abe7bb2e891e61d321ea48e476fee7e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / lenskit-2026.5.0-cp312-abi3-macosx_11_0_arm64.whl

Download URL lenskit-2026.5.0-cp312-abi3-macosx_11_0_arm64.whl
Size 3.6 MB
Tags CPython 3.12 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
df9f984b3031eaf3a3ba0bf1f4fd0abaa2ee6e27289a4e3a0975db5c28b6ac5e
BLAKE2b-256 checksum
How to use checksums
16e6e381079f11d72e40a816585db2d33d0443ed9c75024e7cc2d2407d0dcb95
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for lenskit 2026.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 11 files in this release have been uploaded with provenance metadata.

Select from 11 files

Attestation for lenskit-2026.5.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2026.5.0 This release

11 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page