unimol

Run Uni-Mol embedding, training, and prediction workflows via a CLI wrapper.

124|25|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/jinzhezenggroup/computational-chemistry-agent-skills --skill unimol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unimol
Source: https://github.com/jinzhezenggroup/computational-chemistry-agent-skills/tree/main/molecular-representation/unimol
Command: npx skills add https://github.com/jinzhezenggroup/computational-chemistry-agent-skills --skill unimol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unimol-tools, torch, rdkit, pandas, numpy, and includes scripts (resource) components.

What problem does it solve?

UniMol-based workflows often require chaining representation extraction, model training, and prediction in a reproducible CLI workflow with validation for SMILES. This skill provides a minimal, standardized wrapper to run unimol-tools across embedding, training, and prediction steps, ensuring consistent outputs and error handling.

Core Features & Use Cases

  • Embedding extraction: generate molecular representations (embeddings) from SMILES datasets.
  • Model training: support regression, classification, and multilabel tasks with automatic target handling on CSV/SMI inputs.
  • Prediction: perform property predictions on new data and output a CSV with predictions and logs for invalid entries.
  • Robustness: environment detection, optional GPU usage, and RDKit-based SMILES validation to prevent crashes.

Quick Start

Run uv run python <skill_path>/scripts/unimol_helper.py repr/train/predict to perform the corresponding task.

Frequently Asked Questions about unimol

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract molecular embeddings from a SMILES dataset?

To extract molecular embeddings from SMILES datasets, you can use a command-line wrapper around Uni-Mol that generates molecular representations. It processes CSV or SMI files, validates SMILES strings using RDKit, and outputs absolute paths to the generated representation files.

Can I train classification and regression models on molecular properties using CSV inputs?

Yes, you can train classification and regression models on molecular properties using CSV inputs. The workflow supports automatic target handling for regression, classification, and multilabel tasks, validating SMILES strings to ensure robust model training without crashes.

Does Uni-Mol support running molecular representation workflows on GPU?

Uni-Mol workflows support optional GPU usage for representation extraction, model training, and prediction. The wrapper includes automatic environment detection to seamlessly switch between CPU and GPU execution for computationally intensive machine-learning tasks.

How are invalid SMILES strings handled during property prediction?

During property prediction, invalid SMILES strings are handled by logging them for traceability and preventing crashes. The system performs RDKit-based validation, outputs a CSV file containing successful predictions, and separately logs invalid entries for review.

What is the best way to automate Uni-Mol representation extraction and training steps?

The best way to automate Uni-Mol representation extraction and training is by using a standardized CLI wrapper. It chains embedding extraction, model training, and prediction into a single reproducible workflow with consistent outputs and robust error handling.

Do I need RDKit and PyTorch installed to run Uni-Mol molecular workflows?

Yes, you need RDKit and PyTorch installed to run Uni-Mol molecular workflows. These dependencies, along with unimol-tools, pandas, and numpy, are required to validate SMILES strings, manage tensor operations, and execute the underlying machine-learning algorithms.