molli: Molecular Toolbox Library
https://github.com/SEDenmarkLab/molli
Developed by:
- Alexander S. Shved
- Blake E. Ocampo
- Elena S. Burlova
- Casey L. Olen
- N. Ian Rinehart
S. E. Denmark Laboratory, University of Illinois, Urbana-Champaign
For all work using molli, please cite the primary publication: Shved, A. S.; Ocampo, B. E.; Burlova, E. S.; Olen, C. L.; Rinehart, N. I.; Denmark. S. E.; J. Chem. Inf. Mod. 2024, DOI: 10.1021/acs.jcim.4c00424
Docuementation and Example Workflows can be found here.
Supplementary Materials and Libraries can be found on the Zenodo Repository: DOI: 10.5281/zenodo.10719790
Copyright 2022-2023 The Board of Trustees of the University of Illinois. All Rights Reserved.
About molli
Molli is a cross-platform toolbox written in modern Python (3.10+) that provides a convenient API for molecule manipulations, combinatorial library generation with stereochemical fidelity from plain CDXML files, as well as parallel computing interface. The main feature of molli is the full representation of molecular graphs, geometries and geometry ensembles with no implicit atoms. Additionally, a compact and extensible format for molecular library storage make it a useful tool for in silico library generation. molli is cross-platform code that runs on a wide range of hardware from laptops and workstations to distributed memory clusters.
Installation and Building
Molli is available as the source code distribution on GitHub. Additionally, convenient installation is provided in the form of a PyPi package and conda package.
Note: We routinely test the package on Linux and Windows OS. OSX support is tested upon the pull request submission using GitHub workflows. We can only offer limited support for that OS at this time.
Install using pip (Preferred Method)
Installation from PyPI
The easiest way to obtain molli is to obtain the latest PyPI package.
pip install molli
Upon a successful installation of molli, one can test the installation by running the following commands
molli --VERSION\
molli test -vv
which will provide the current version (it is obtained dynamically from the Git tags and determined at the installation time) and run the full test suite to guarantee that the core functionality performs correctly.
Install from source
Installation from source can offer a few advantages, such as the editable installation, or installing . This is convenient for users who wish to significantly alter their molli experience by modifying the core functionality
pip install git+https://github.com/SEDenmarkLab/molli.git
# or
pip install -e git+https://github.com/SEDenmarkLab/molli.git#egg=molli
Editable installation: (Assumes that the repository source code was cloned onto the hard drive using Github tools into ./molli/ folder) We have noticed that development with VSCode is not greatly compatible with the most recent version of the
pip install -e molli/ --config-settings editable_mode=compat
Install as a conda package
Molli can be installed from a conda repository:
Note: Conda setup is not fully configured yet, so you may expect that there will be slight changes to the syntax. For more information about the current installation instructions, please visit the Anaconda repository
conda install esalx::molli
Testing the installation
Core functions
Note: By default, molli only tests the core functionality: the functions that do not depend on external computational or chemoinformatics packages, such as OpenBabel, RDKit, Orca, XTB and CREST. These tests are considered extended (see below).
There are two syntaxes that allow to test the functionality of molli, of which one (molli test) is a more convenient alias for another (python -m unittest). See unittest documentation for additional arguments, which can be applied to both.
python -m unittest molli_test # additional args
molli test # additional args
Extended tests
These tests are automatically invoked if the corresponding packages are either importable (that is, installed in the same conda environment or the corresponding Python virtual environment), or the corresponding executables can be located. An example of such extended test is found below (if Environment Modules configures the packages on your machine)
module load xtb/6.4.1
module load crest/2.11.1
molli test -vv # Now this tests XTB and CREST driver
Metadata
Release files for molli 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| molli-1.3.0.tar.gz | 24.1 MB | Without provenance | Details for molli-1.3.0.tar.gz |
Built distributions (wheels)
Total release size: 410.5 MB
Release files / molli-1.3.0.tar.gz
| Download URL | molli-1.3.0.tar.gz |
|---|---|
| Size | 24.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1b79c8ecde6fa2e00779952c7772f3a753590d8de64889e72fff83167b821398
|
|
BLAKE2b-256 checksum How to use checksums |
4df256429c187f9509808549a77f573e13ae6496a7501f2b1f36e8c0d324019e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp312-cp312-win_amd64.whl
| Download URL | molli-1.3.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
e03b9803fb82319a4411db8a771a63fe2a19c638d797dd5b765f3bfc0bdb17aa
|
|
BLAKE2b-256 checksum How to use checksums |
ef91dc79c66e555d2a17b995213b84254313f6fa6bdc29f9bb7a16c128523181
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp312-cp312-win32.whl
| Download URL | molli-1.3.0-cp312-cp312-win32.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.12 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
841f376b1e27b1359ba5cdd99f220c15e49dc5297d9dedb9d7fbd3e26f32a0a7
|
|
BLAKE2b-256 checksum How to use checksums |
6699d2dfab63fcafe99d63821a39a3be20792214757bc9340110b605e918f3e1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp312-cp312-musllinux_1_1_x86_64.whl
| Download URL | molli-1.3.0-cp312-cp312-musllinux_1_1_x86_64.whl |
|---|---|
| Size | 18.8 MB |
| Tags | CPython 3.12 Linux musl 1.1+ x86-64 |
|
SHA-256 checksum How to use checksums |
45069256c441c0b19f2c6387ade68f7ec89905440ba4831741f9a9be0e6b6104
|
|
BLAKE2b-256 checksum How to use checksums |
9836b8d5604492533e1614ce14c6ddc43500dd6fa6cbfd28b668fb7565bd001a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp312-cp312-musllinux_1_1_i686.whl
| Download URL | molli-1.3.0-cp312-cp312-musllinux_1_1_i686.whl |
|---|---|
| Size | 18.8 MB |
| Tags | CPython 3.12 Linux musl 1.1+ x86-32 |
|
SHA-256 checksum How to use checksums |
c403a28c71368fb56e2ccbb9c3c4322de69b30361b8c622b90a278cc91c23c9e
|
|
BLAKE2b-256 checksum How to use checksums |
d10d085896d8fc244d8a4f4d4de8c922fab7b07e664e4a10e58a9a1e57e28325
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | molli-1.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
6f95bba412d48c7292c395e3ba6dcdeab931f8e05a9004651aa2e2a10bc5c8b8
|
|
BLAKE2b-256 checksum How to use checksums |
6c8829d177c92535f5cf70ff74039b3e8071ff7cce0750d45f86055ce3927ebb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl
| Download URL | molli-1.3.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-32 |
|
SHA-256 checksum How to use checksums |
001d5c0eed343d017abf671f7150c466cff2f88571892a5e89b2f87ea6f4c05b
|
|
BLAKE2b-256 checksum How to use checksums |
8520ae8d3194bd7605d06ab594be8482f365b049c526495cf0e24f786ed58e55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | molli-1.3.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d5dc18ca915129a7f95f389e583cddbd8be743ddcffea447719ba82885c89939
|
|
BLAKE2b-256 checksum How to use checksums |
bd80f28281691262a775203a28b1e54a251ebcee720a75ce82d5273df34ee466
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp311-cp311-win_amd64.whl
| Download URL | molli-1.3.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
5cf02953c7d403adbd8c19161cde55c3e8d94204de9209b98d0fd414e5ee1c98
|
|
BLAKE2b-256 checksum How to use checksums |
0ac8f5bce6c9813fc200dd553aa96d39741b132c5621be5161216e16b9e107cf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp311-cp311-win32.whl
| Download URL | molli-1.3.0-cp311-cp311-win32.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.11 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
624bba1168d9965006f89f5832b59380491b5565b71d941f59753fcb976257a8
|
|
BLAKE2b-256 checksum How to use checksums |
cb45c027693bea1e355be2534cae9bddcc0435466cf93be38f1065d702a7a89e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp311-cp311-musllinux_1_1_x86_64.whl
| Download URL | molli-1.3.0-cp311-cp311-musllinux_1_1_x86_64.whl |
|---|---|
| Size | 18.8 MB |
| Tags | CPython 3.11 Linux musl 1.1+ x86-64 |
|
SHA-256 checksum How to use checksums |
3a431453ddde5cfea006bab20af2605c8f20a3fba8cd4717b483852092981b29
|
|
BLAKE2b-256 checksum How to use checksums |
5dbf38c2056e2bd5341607e6c9361fb2829bd00988c60bde875ac8862a8a7bc0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp311-cp311-musllinux_1_1_i686.whl
| Download URL | molli-1.3.0-cp311-cp311-musllinux_1_1_i686.whl |
|---|---|
| Size | 18.8 MB |
| Tags | CPython 3.11 Linux musl 1.1+ x86-32 |
|
SHA-256 checksum How to use checksums |
a092d0e4a379db63692a7982bdec27188af1393927142dd937f2e869c5771252
|
|
BLAKE2b-256 checksum How to use checksums |
83ba4cb2de58b6dd76e2fdf2701af5e2295824b47020680cc3c7ce3817046423
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | molli-1.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
20026b2ca0692637555dd110bac25c2a27f80db54712f2d3a3eb237bd96f3bba
|
|
BLAKE2b-256 checksum How to use checksums |
8aaf6d4b3e2a79ce42c084882afe0ea10b527dbe5cc51220b88d87a770b4af61
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl
| Download URL | molli-1.3.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-32 |
|
SHA-256 checksum How to use checksums |
3e27a1bd40915f0747fe77f58d33933611592013ae732de43abad76590bb8bac
|
|
BLAKE2b-256 checksum How to use checksums |
4d1984160efe037eca954aacbed1fb5bd0d53cf3911b854cc125b8362b2f3b00
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | molli-1.3.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5ea97e83dd66ebbc29cb522fed202e92de8c393c9fe93f2d99c01df4c5c9cdc9
|
|
BLAKE2b-256 checksum How to use checksums |
783d27669473fa64d4cbc034f116cb9145d32a17c29c86dcc6ee550d15f4f6c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp310-cp310-win_amd64.whl
| Download URL | molli-1.3.0-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6c36512dba06217dff811fbead9cb01efe4fd364582df417c8822475606a93f2
|
|
BLAKE2b-256 checksum How to use checksums |
d49d227ff6538ec5af36542bfa6a7b3a52137f212f15baa7e98e2c74b0550e73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp310-cp310-win32.whl
| Download URL | molli-1.3.0-cp310-cp310-win32.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.10 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
24b712fc11632f390484ded2f974e2fdfbb0286c7cad1e20e2aecdf1b864f584
|
|
BLAKE2b-256 checksum How to use checksums |
9141ce82cdddcb644f79c6898858b8b1b9015160d40a698b5cdb5ff43c4aaa56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp310-cp310-musllinux_1_1_x86_64.whl
| Download URL | molli-1.3.0-cp310-cp310-musllinux_1_1_x86_64.whl |
|---|---|
| Size | 18.8 MB |
| Tags | CPython 3.10 Linux musl 1.1+ x86-64 |
|
SHA-256 checksum How to use checksums |
9a34cd75791e3f29391e843ae7c5d96e8ee19d508d78d48abe78ae2f791fcb6a
|
|
BLAKE2b-256 checksum How to use checksums |
fc33b82a1f59153a5b697a9178afe38cbbb04f5408f03588e91599e42cd47402
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp310-cp310-musllinux_1_1_i686.whl
| Download URL | molli-1.3.0-cp310-cp310-musllinux_1_1_i686.whl |
|---|---|
| Size | 18.8 MB |
| Tags | CPython 3.10 Linux musl 1.1+ x86-32 |
|
SHA-256 checksum How to use checksums |
95e10f81113bea20ad459fc0fbb7411d5de8a1d839661524886f2bb38795b8d7
|
|
BLAKE2b-256 checksum How to use checksums |
bc61db0a186e6be1d7699e38e3cd1a81942972e66b03d4d681a1e624b01ba70f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | molli-1.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
1d47740539283dfbb51c71f71b2b27d62bc5047966a0d7a18b45c64cab3d72ca
|
|
BLAKE2b-256 checksum How to use checksums |
b2cbb68c75a5c573c3cbac21a9a60e086ec74131526633d9db7d0de7b75722d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl
| Download URL | molli-1.3.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-32 |
|
SHA-256 checksum How to use checksums |
26862d4a21f127ad1f44a6e22d09efac818304c83244827ff5bc702e266c8518
|
|
BLAKE2b-256 checksum How to use checksums |
b4742fd399269c5b6dbdba6723fe5b24276d9e5e531dcefb4ca011ccf0c14f2a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / molli-1.3.0-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | molli-1.3.0-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
49f5e3688c768895267a78b70a9b2aebda4b22357558cda36f7acbfb287364bd
|
|
BLAKE2b-256 checksum How to use checksums |
515b50cd396f8be7129a9f36f778277c9e46bdd3d2e95a7bc48f5912a13ac492
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for molli 1.3.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.