chemprop
Molecular Property Prediction with Message Passing Neural Networks
What it is and what it does
Chemprop is a machine learning framework for predicting molecular properties using graph neural networks. It represents molecules as graphs and applies message passing to learn structural patterns that correlate with chemical properties, enabling applications in drug discovery, ADMET prediction, and molecular optimization.
The package underwent a major rewrite in v2.0.0 and now provides a modular, PyTorch-Lightning-based architecture. It depends on torch, lightning, numpy, pandas, rdkit, scikit-learn, and scipy, plus specialized chemistry libraries like descriptastorus and astartes. The framework is actively maintained, supports Python 3.11–3.14, and is permissively licensed under MIT.
Use it for:
- Train models to predict absorption, distribution, metabolism, excretion, and toxicity (ADMET) properties for drug candidates
- Discover novel antibiotics by predicting bioactivity against bacterial strains from molecular structures
- Build ensemble models for structure–activity relationship (SAR) analysis with interpretability
- Predict reaction properties or atom/bond-level predictions for chemical synthesis planning
- Benchmark molecular representations and compare graph neural network architectures on property datasets
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Chemprop trains and deploys message passing neural networks to predict molecular properties from chemical structures, using graph neural networks to learn from molecular representations.
Yes, if you work in computational chemistry, drug discovery, or molecular ML. Chemprop is actively maintained, well-cited in peer-reviewed research, and has a permissive license. The dependency stack is substantial but standard for this domain. Install friction is low. No known vulnerabilities. The v2 rewrite is recent; verify that your use case is covered in current documentation.
Install
chemprop on PyPI
pip
pip install chempropuv
uv add chemproppoetry
poetry add chempropInstalling chemprop
Before you install
Low install friction with a pure-Python wheel. Active maintenance with a release 10 days ago and commits through 2026-08-04. Requires 13 runtime dependencies including torch, lightning, rdkit, and scikit-learn—a substantial but standard stack for molecular ML work.
License in practice
MIT license permits commercial and private use with minimal restrictions, making it suitable for research, industry applications, and derivative work.
Quickstart
pip install chemprop
import chemprop
from chemprop import Chemprop
# Train a model on molecular SMILES and property data
model = Chemprop()
model.train(smiles_list, property_values)
Requires PyTorch and RDKit; GPU support optional but recommended for large datasets. Python 3.11–3.14 only.
Verify before relying
- Exact API surface and whether the snippet example reflects current v2.3.1 usage patterns
- Whether all 13 runtime dependencies are required for basic property prediction or only for advanced features
- Performance characteristics and typical training time for datasets of different sizes
Package facts
| License | MIT (permissive) |
| Python support | supports the current Python release (<3.15,>=3.11) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 13 — lightning, numpy, pandas, rdkit, scikit-learn, scipy, torch, astartes, ConfigArgParse, rich, descriptastorus, cuik_molmaker_pin, myerson |
| Maintenance | actively maintained — 10 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 110,881/month — #12,438 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: chemprop-2.3.1-py3-none-any.whl
Keywords: chemistry, machine learning, property prediction, message passing neural network, graph neural network, drug discovery
Tags
More Artificial Intelligence packages
LiteLLM provides a unified Python interface to…
permissive · top 100 on PyPI
huggingface-hubClient library and CLI tool for downloading,…
permissive · top 100 on PyPI
langchainLangChain provides a framework for building…
permissive · top 1,000 on PyPI
hf-xethf-xet provides chunk-based deduplication and…
permissive · top 1,000 on PyPI
tokenizersTokenizers converts raw text into token…
permissive · top 1,000 on PyPI
transformersTransformers provides a unified framework for…
permissive · top 1,000 on PyPI
chgnetCHGNet is a pretrained graph neural network…
permissive · top 15,000 on PyPI
PubChemPyPubChemPy is a Python wrapper around the…
permissive · top 5,000 on PyPI
aimsim-coreProvides core molecular featurization and…
permissive · top 15,000 on PyPI
mace-torchMACE trains and evaluates machine learning…
permissive · top 15,000 on PyPI
selfiesConverts between SELFIES (Self-Referencing…
permissive · top 15,000 on PyPI
mordredcommunityCalculates molecular descriptors from chemical…
permissive · top 15,000 on PyPI
chembl-structure-pipelineStandardizes and salt-strips molecular…
permissive · top 15,000 on PyPI
pymbarpymbar implements the multistate Bennett…
permissive · top 15,000 on PyPI
pytdcPyTDC provides unified access to multimodal…
permissive · top 15,000 on PyPI
canteraCantera is a suite of tools for chemical…
permissive · top 15,000 on PyPI