molcrafts-molrs
Python bindings for the molrs molecular modeling toolkit.
Install with pip install molcrafts-molrs and import molrs. Full docs:
https://docs.molcrafts.org/molrs/.
Install
pip install molcrafts-molrs
Requires Python 3.12+.
Quick start
import molrs
# SMILES → atomistic graph (class API under molrs.io)
mol = molrs.io.smiles.SmilesIr("CCO").to_atomistic()
# 3D coordinates
from molrs.conformer import Conformer
mol, report = Conformer().generate(mol)
# Force field: typify → pairs → potentials
from molrs.ff.typifier import Mmff94Typifier
from molrs.ff.potential import intramolecular_pairs
from molrs.ff.compile import PotentialCompiler
typifier = Mmff94Typifier()
typed = typifier.typify(mol)
frame = typed.to_frame()
ff = typifier.forcefield() # a copy of exactly the types typify assigned
frame["pairs"] = intramolecular_pairs(frame, ff)
pots = PotentialCompiler(ff).compile(frame)
energy, forces = pots.calc_energy_forces(frame)
assert forces.shape == (frame["atoms"].n_rows, 3)
Package layout
The top level is the subsystems, exactly as the Rust crate's root is; every
symbol has one path, named after its Rust owner (molrs.core.Frame is
molrs::core::Frame).
| Import | Owns |
|---|---|
molrs.core |
Frame, Block, Trajectory, frame metadata; Box, neighbour search, regions, TriMesh, Trace; MolGraph, Atomistic, CoarseGrain and their live views, Element, Topology; Unit, Quantity, UnitPreset, UnitRegistry |
molrs.core.keys / .schema / .constants |
the column vocabulary, its specifications, and every physical and engine constant |
molrs.io |
Every file reader and writer (structure, trajectory, force-field files, *.mrec, SMILES) as read_<fmt>[_<what>] / write_<fmt>[_<what>] (_str / _bytes in memory); each format's classes in its own submodule: io.pdb, io.xyz, io.gro, io.dcd, io.trr, io.xtc, io.lammps, io.smiles, io.cgsmiles, io.mrec |
molrs.io.mrec |
*.mrec store pieces: streaming SequenceSchema, MrecWriter, MrecReader, ForceFieldSection, section_names, pack_mrec_zip, validation (whole records: molrs.io.read_mrec_frame / write_mrec_frame and partners) |
molrs.ff.* |
forcefield, potential, typifier, charge, ir, params, clpol_scaling |
molrs.optimize |
Lbfgs, OptimizationReport |
molrs.md |
Integrators and the MD driver |
molrs.compute |
RDF, MSD, transport, dielectric, … (flat) |
molrs.conformer |
3D generation |
molrs.perceive |
Rings, aromaticity, SMARTS, reactions |
molrs.builder |
Structure builders, site-graph assembly, Coarsener |
Analysis kernels take dt in the time unit of your trajectory, and
time-valued results come back in that unit. MSD needs unwrapped
coordinates. VACF is the unbiased (C(\tau)) used for Green–Kubo D and VDOS.
Development
maturin develop --release
pytest -q
Metadata
Release files for molcrafts-molrs 0.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| molcrafts_molrs-0.17.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| molcrafts_molrs-0.17.0-cp312-abi3-pyemscripten_2026_0_wasm32.whl | CPython 3.12 | abi3 | PyEmscripten 2026.0+ WebAssembly | Details |
| molcrafts_molrs-0.17.0-cp312-abi3-manylinux_2_28_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| molcrafts_molrs-0.17.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| molcrafts_molrs-0.17.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details |
| molcrafts_molrs-0.17.0-cp312-abi3-macosx_10_12_x86_64.whl | CPython 3.12 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 55.3 MB
Release files / molcrafts_molrs-0.17.0-cp312-abi3-win_amd64.whl
| Download URL | molcrafts_molrs-0.17.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 11.1 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
1b2f95aa3ce6b6f84aeb5b7125930ad516724eb2c1ef6f19d10b27e1284f46d4
|
|
BLAKE2b-256 checksum How to use checksums |
f22bf8092ca9c9ec992379d59f0922d787fa86c22bd2784e89f3a6301bbc9b88
|
| 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 9, 2026.
Transparency logRelease files / molcrafts_molrs-0.17.0-cp312-abi3-pyemscripten_2026_0_wasm32.whl
| Download URL | molcrafts_molrs-0.17.0-cp312-abi3-pyemscripten_2026_0_wasm32.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.12 PyEmscripten 2026.0+ WebAssembly abi3 |
|
SHA-256 checksum How to use checksums |
192ebff2723f81f06dff7c6f57dff7f4371e4caca9a167b74cc74d5f8f2df298
|
|
BLAKE2b-256 checksum How to use checksums |
aa421cc6ee3129b5e4a4693b5a11a78f9100ff910f5dc3389fb30c2af0627e45
|
| 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 9, 2026.
Transparency logRelease files / molcrafts_molrs-0.17.0-cp312-abi3-manylinux_2_28_aarch64.whl
| Download URL | molcrafts_molrs-0.17.0-cp312-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 9.7 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
03c1adba43f4ceab375e4101025f859e64636e55fef8132b5644ef8b5b69872f
|
|
BLAKE2b-256 checksum How to use checksums |
837afac7053b4cedddf99ea8f36140d06daa8f85fbca99612fe0e45d774d124b
|
| 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 9, 2026.
Transparency logRelease files / molcrafts_molrs-0.17.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | molcrafts_molrs-0.17.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 10.7 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
4d8934b2c8b546327a18fddc231ced7e4f055e195aa7851fe49cf8f9942b27a7
|
|
BLAKE2b-256 checksum How to use checksums |
9ae576a24e3a3b5f399642da65e04e28768e0c027cd355709a4dfd3ed290deb8
|
| 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 9, 2026.
Transparency logRelease files / molcrafts_molrs-0.17.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | molcrafts_molrs-0.17.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.4 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
992df549b6960f1243c21a3b4fbd91aa151bb45ca5a8943ac7608b998bd99fcc
|
|
BLAKE2b-256 checksum How to use checksums |
75b8f673d1c3b638cb1969076eee4e962953a2ffb942896c0f2565b9d2e93fe7
|
| 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 9, 2026.
Transparency logRelease files / molcrafts_molrs-0.17.0-cp312-abi3-macosx_10_12_x86_64.whl
| Download URL | molcrafts_molrs-0.17.0-cp312-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 10.3 MB |
| Tags | CPython 3.12 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
657995d0023a5c9a87ddc19c708350bd63ab9ecf7e62b28a0a930196d4e2bf0f
|
|
BLAKE2b-256 checksum How to use checksums |
7e25f6cac0fa0476c5433b215f9c55d99fe8a9b7c434832e53ce213887817c8f
|
| 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 9, 2026.
Transparency logSecurity for molcrafts-molrs 0.17.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 6 files in this release have been uploaded with provenance metadata.
Attestation for molcrafts_molrs-0.17.0-cp312-abi3-win_amd64.whl
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 9, 2026.
Transparency logA 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.
