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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

emd_matcha-0.0.17.tar.gz (848.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

emd_matcha-0.0.17-py3-none-any.whl (444.9 kB view details)

Uploaded Python 3

File details

Details for the file emd_matcha-0.0.17.tar.gz.

File metadata

  • Download URL: emd_matcha-0.0.17.tar.gz
  • Upload date:
  • Size: 848.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for emd_matcha-0.0.17.tar.gz
Algorithm Hash digest
SHA256 6c850dbf64e77f8a14756c49da953761cd3f5e187d766ba9a2d7a9e6e5b63024
MD5 26ea4c94243bfe1d4fac501bcd03e4de
BLAKE2b-256 62ed826e0277cd648bedb26f2937edcd8821496f3bb6d95c4e6776ed96c254bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for emd_matcha-0.0.17.tar.gz:

Publisher: release.yml on emdgroup/matcha

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file emd_matcha-0.0.17-py3-none-any.whl.

File metadata

  • Download URL: emd_matcha-0.0.17-py3-none-any.whl
  • Upload date:
  • Size: 444.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for emd_matcha-0.0.17-py3-none-any.whl
Algorithm Hash digest
SHA256 916dec01fd37aaa00a35b8cdd6b53fba6d2310762a015aeba4b7e1356c5e4f8b
MD5 c3fc3f145e6131f66c5967ad07ed0715
BLAKE2b-256 700a0b5b9123e359f58a96910fa7d0976489799c5294ecbe9f219b120a78a3d7

See more details on using hashes here.

Provenance

The following attestation bundles were made for emd_matcha-0.0.17-py3-none-any.whl:

Publisher: release.yml on emdgroup/matcha

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.0.27

2 files

0.0.26

2 files

0.0.25

2 files

0.0.24

2 files

0.0.23

2 files

0.0.22

2 files

0.0.21

2 files

0.0.20

2 files

0.0.19

2 files

0.0.18

2 files

This release

0.0.17 This release

2 files

0.0.16

2 files

0.0.15

2 files

0.0.14

2 files

0.0.13

2 files

0.0.12

2 files

0.0.11

2 files

0.0.10

2 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