Skip to main content

MATCHA Logo

MATCHA - Modelling and AI Toolkit for Chemistry in Healthcare Applications

Python Release Unit tests Docs License ChemRxiv

⚠️ Work in progress. MATCHA is under active development and no stable release is available yet. Public APIs, CLI commands, and packaging may change without notice. Pin exact versions if you depend on it, and expect breaking changes between releases.

MATCHA is a general toolkit for molecular property prediction with deep learning models.

Its core design philosophy is to wrap a wide variety of algorithms (e.g. descriptor/fingerprints, SMILES-based, graph-based, conformer-based) into a consistent Python APIs and CLI. Additionally, the package aims to be as agent-friendly as possible, with extensive docs to help LLMs use it and contribute to it.

MATCHA can help solve many typical issues found when developing QSAR models, such as:

  • ⚖️ Quickly comparing many different algorithms to check for statistically meaningful differences
  • 🎯 Pretraining and finetuning models, both supervised and self-supervised
  • 🧩 Multitask learning
  • 🔍 Explainability
  • 📊 Uncertainty estimation

Making models, whether single predictors, ensembles or finetuned foundation models, can be done with two lines of code, starting from RDKIT molecules and numpy arrays:

# training and predicting with a generic model
from matcha.sklearn.graph import ChempropRegressor

model = ChempropRegressor()
model.fit(mols, y)
predictions = model.predict(mols)

# training an ensemble
from matcha.sklearn import Ensemble
from matcha.sklearn.clm import CNNRegressor

ensemble = Ensemble(
  model=CNNRegressor(),
  n_models=10
)
ensemble.fit(mols, y)

# Finetuning a foundation model
from matcha.sklearn.finetuning import FinetuningRegressor

finetuner = FinetuningRegressor(
  path_to_pretrained = "path/to/your/matcha/foundation/model"
)
finetuner.fit(mols, y)

Head over to the documentation to get started!

🛠️ How to contribute

Please check out the contribution guide. We strongly recommend using the amazing Mach10 coding workflows to help contributing to the codebase with agents.

👨🏻‍🔧 Contacts

  • Davide Boldini, (Merck KGaA, Darmstadt, Germany), Contact
  • Lukas Friedrich (Merck KGaA, Darmstadt, Germany), Contact
  • Jakub Gunera (Merck KGaA, Darmstadt, Germany), Contact
  • Christina Schindler (Merck KGaA, Darmstadt, Germany), Contact
  • Daniel Kuhn (Merck KGaA, Darmstadt, Germany), Contact

📖 Citation

If you use MATCHA, please consider citing our preprint:

@article{matcha_2026,
  author = "Boldini, Davide and Friedrich, Lukas and
            Gunera, Jakub and Schindler, Christina and Kuhn, Daniel",
  title  = "{MATCHA}: a toolkit for streamlining molecular property prediction
            for drug discovery applications",
  journal = "ChemRxiv",
  year = "2026",
  doi = "10.26434/chemrxiv.15006766/v1",
  url = "https://chemrxiv.org/doi/abs/10.26434/chemrxiv.15006766/v1",
}

📄 License

Copyright 2026 Merck KGaA, Darmstadt, Germany and/or its affiliates. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Metadata

Release files for emd-matcha 0.0.28

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

Source distribution (sdist)

Source distribution for emd-matcha 0.0.28
File Size Uploaded
emd_matcha-0.0.28.tar.gz 910.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for emd-matcha 0.0.28
File Interpreter ABI Platform
emd_matcha-0.0.28-py3-none-any.whl Python 3 none any Details

Total release size: 1.4 MB

Release files / emd_matcha-0.0.28.tar.gz

Download URL emd_matcha-0.0.28.tar.gz
Size 910.1 kB
Tags Source
SHA-256 checksum
How to use checksums
605b157252e993e34c0b79020a134492150919f06638653f7abd48a114ee1d1a
BLAKE2b-256 checksum
How to use checksums
377e930f46a16219df9f979dfc6b1e058556e601ec09b24d483994c8fa9f8030
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 Sep 15, 2026.

Transparency log

Release files / emd_matcha-0.0.28-py3-none-any.whl

Download URL emd_matcha-0.0.28-py3-none-any.whl
Size 468.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
29052a39d9631896aa2acb076c9dee4c2a807d12b639425972bd3a3bb9c5b276
BLAKE2b-256 checksum
How to use checksums
dd9821507da85e2cda304a6bbd6529b6983aed9396f6fd2a6683977fe1553300
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 Sep 15, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.0.28 This release

2 release files

0.0.27

2 release files

0.0.26

2 release files

0.0.25

2 release files

0.0.23

2 release files

0.0.22

2 release files

0.0.21

2 release files

0.0.20

2 release files

0.0.19

2 release files

0.0.18

2 release files

0.0.17

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.13

2 release files

0.0.12

2 release files

0.0.11

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page