A toolkit for building high-performance molecular simulations on JAX
kUPS provides composable, differentiable primitives — samplers, potentials, and propagators — with hardware acceleration on CPU, GPU, and TPU.
Documentation | Quick Start | Features | Examples
Installation
| Standard Installation |
pip install kups
|
| GPU Support |
pip install kups[cuda]
|
| Development |
git clone https://github.com/cusp-ai-oss/kups.git
cd kUPS
uv sync
|
Quick Start
Monte Carlo Simulation (GCMC)
cd examples
kups_mcmc_rigid mcmc_rigid.yaml
Molecular Dynamics (Lennard-Jones)
cd examples
kups_md md_lj_argon_nvt.yaml
Features
|
Simulation Methods
|
Force Fields & Potentials
|
|
Core Capabilities
|
Performance & Integration
|
Documentation
Full documentation is available at cusp-ai-oss.github.io/kUPS.
Building docs locally
To build the docs locally run ./docs/scripts/build.sh, which executes and renders all documentation notebooks and generates API pages in markdown.
./docs/scripts/build.sh # build into site/
./docs/scripts/build.sh --serve # serve with live updates on http://127.0.0.1:8000
Citation
If you use kUPS in your research, please cite:
@software{kups2026,
author = {Gao, Nicholas
and K{\"o}hler, Jonas
and Hanke, Felix
and Ramanan, Anita
and Moubarak, Elias
and Morrow, Joe
and de Haan, Pim
and Openshaw, Hannah
and Welling, Max
and CuspAI Team},
title = {kUPS - a universal particle simulation toolkit},
year = {2026},
url = {https://github.com/cusp-ai-oss/kups}
}
License
Apache License 2.0 — see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for kups 1.0.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kups-1.0.8.tar.gz | 366.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kups-1.0.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 853.0 kB
Release files / kups-1.0.8.tar.gz
| Download URL | kups-1.0.8.tar.gz |
|---|---|
| Size | 366.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
da1ad997aef2950858f2ba9846aec3f888cd6fe316cefcf61f19f9b718447992
|
|
BLAKE2b-256 checksum How to use checksums |
cb79be3f62db161fa0b43a8ce04d5d90646a7e8480c4cd9190cf0d956cdbb1d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency logRelease files / kups-1.0.8-py3-none-any.whl
| Download URL | kups-1.0.8-py3-none-any.whl |
|---|---|
| Size | 486.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3911640be9a16ecec09d62e97a7de06bbcabb1751cbef85e85fed873ed6e644a
|
|
BLAKE2b-256 checksum How to use checksums |
eb38b6b8d15d7c4bc65da1ecbbbefad1703e01c22efb24ab2a19a2fd43c3f395
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency log
