MoleculeKit

A molecule manipulation library

Getting started

Installing moleculekit

With pip

pip install moleculekit

With conda

Installation Instructions

Using moleculekit in ipython

Install ipython in the correct conda enviroment using the following command.

pip install ipython

Now you can start an ipython console with

ipython

In the ipython console you can now import any of the modules of moleculekit and use it as normal.

from moleculekit.molecule import Molecule

mol = Molecule('3ptb')
mol.view()

API

For the official documentation of the moleculekit API head over to https://software.acellera.com/moleculekit/index.html

Issues

For any bugs or questions on usage feel free to use the issue tracker of this github repo.

Dev

If you are using moleculekit without installing it by using the PYTHONPATH env var you will need to compile the C++ extensions in-place with the following command:

python setup.py build_ext --inplace

Building for WebAssembly

Install emscripten https://emscripten.org/docs/getting_started/downloads.html

conda create -n pyodide-build
conda activate pyodide-build
conda install python=3.11
pip install pyodide-build==0.25.1

# Activate the emscripten environment
cd ../emsdk
./emsdk install 3.1.46
./emsdk activate 3.1.46
source emsdk_env.sh
cd -

# Build the package
export PYO3_CROSS_INCLUDE_DIR="HACK"
export PYO3_CROSS_LIB_DIR="HACK"
rm -rf .pyodide-xbuildenv
pyodide build -o dist_pyodide
cp dist_pyodide/*.whl test_wasm/wheels/
cd test_wasm
python3 -m http.server

If you get an error at building about numpy missing, check this issue https://github.com/pyodide/pyodide/issues/4347

Debugging segmentation faults in Cython part

Put a reproducible script in a file like segfault.py
Modify setup.py to have -g as compile flag instead of -O3
Recompile extensions with python setup.py build_ext --inplace
Execute script with gdb like gdb --args python segfault.py
Execute run and then bt 10 to show the backtrace
Have fun

Citing MoleculeKit

If you use this software in your publication please cite:

Stefan Doerr, Matthew J. Harvey, Frank Noé, and Gianni De Fabritiis. HTMD: High-throughput molecular dynamics for molecular discovery. Journal of Chemical Theory and Computation, 2016, 12 (4), pp 1845–1852. doi:10.1021/acs.jctc.6b00049

Release files for moleculekit 1.17.6

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

Built distributions (wheels)

Table of built distributions (wheels) for moleculekit 1.17.6
File	Interpreter	ABI	Platform	Reset
moleculekit-1.17.6-cp311-abi3-win_amd64.whl 5.3 MB Sep 10, 2026	CPython 3.11	abi3	Windows x86-64	Details
moleculekit-1.17.6-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl 5.6 MB Sep 10, 2026	CPython 3.11	abi3	Linux glibc 2.24+ x86-64, Linux glibc 2.28+ x86-64	Details
moleculekit-1.17.6-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl 5.5 MB Sep 10, 2026	CPython 3.11	abi3	Linux glibc 2.28+ ARM64, Linux glibc 2.24+ ARM64	Details
moleculekit-1.17.6-cp311-abi3-macosx_11_0_arm64.whl 5.3 MB Sep 10, 2026	CPython 3.11	abi3	macOS 11.0+ ARM64	Details

Total release size: 21.7 MB

Release files / moleculekit-1.17.6-cp311-abi3-win_amd64.whl

Download URL	moleculekit-1.17.6-cp311-abi3-win_amd64.whl
Size	5.3 MB
Tags	CPython 3.11 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`88c5da95a494430e40a56bf5fa61115850d0f378f00e2461f41342126918f801`
BLAKE2b-256 checksum How to use checksums	`cf1a1fbc69c70b347e5b6307462287c71491bb1c5020d5aafc9ede34a19c734e`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / moleculekit-1.17.6-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL	moleculekit-1.17.6-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size	5.6 MB
Tags	CPython 3.11 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum How to use checksums	`022c0b895d93862fb70001e4d9935fe1994f378d6c5f5029ea9e23aa37b6eca1`
BLAKE2b-256 checksum How to use checksums	`4f2df5daa0ed7afab6dd7a30304a57b6e8102e76b3d90875cdb5fb6824718658`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / moleculekit-1.17.6-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl

Download URL	moleculekit-1.17.6-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Size	5.5 MB
Tags	CPython 3.11 Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum How to use checksums	`714dc69ce99d2c9285839cf7df9c08eb995b3167b1953b30bc7edb4dfd3d7756`
BLAKE2b-256 checksum How to use checksums	`f9e96878edcfda8b4e5d3d899c8d556b2c491b406d737bffea8b1b983d881e01`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / moleculekit-1.17.6-cp311-abi3-macosx_11_0_arm64.whl

Download URL	moleculekit-1.17.6-cp311-abi3-macosx_11_0_arm64.whl
Size	5.3 MB
Tags	CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`06e7a2b8a8a49555ef0764a7b93dc66d1b22ac987eb7cb0ae61526751d1297c7`
BLAKE2b-256 checksum How to use checksums	`5ec9d6d30d24125479e44b9611054e0e991446d7858281e513ea1ea147f49326`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`