CatalystCompass
EC number prediction for chemical reactions
2 min readupdated
This model takes a chemical reaction description and predicts its Enzyme Commission (EC) classification code—the international standard for enzyme nomenclature. Under the hood, it runs a CPU ensemble that combines structural reaction fingerprints, BERT-based neural encoders, and nearest-neighbor search across known chemical analogs. The author added a conservative consensus layer for exact reaction matching alongside a fast top-class decoder, making it a practical tool for bioinformaticians and chemists annotating datasets without a GPU.
Key features
- Combines structural substrate representations, learned embeddings from BERT encoders, and retrieval over known reactions.
- Strict match lookup checks stereochemistry, isotope labels, reaction direction, and reactant roles, accepting a match only when reference entries reach full consensus.
- Fast top-one decoder selects the highest-scoring class without sorting all categories.
- Runs entirely on CPU and executes inference inside an isolated, offline Docker container.
What you can do
- Batch-annotate chemical reaction datasets from Parquet files and export valid EC numbers in JSONL format.
- Drop it into offline biochemical analysis pipelines that require reproducibility and isolation from environment version conflicts.
Example
mkdir -p ~/Downloads/DL_project
unzip -o ~/Downloads/catalyst_compass_setup.zip -d ~/Downloads/DL_project
bash ~/Downloads/DL_project/catalyst_compass/run_mac.sh
Read more
DetailsThe first run downloads roughly 727 MB of base assets, while actual inference runs completely offline.
By default, inputs are read from
DL_project/data/val_inputs.parquet and predictions are saved to output/predictions.jsonl.Changes focus on inference logic built on top of pretrained weights; no accuracy gain was recorded on the public validation set due to a lack of canonical matches.










Comments