DeepChem quickstart
Step-by-step guide to running molecular property prediction with DeepChem on the platform.
You want to predict a molecular property — solubility, toxicity, permeability — for one compound or a whole library. This walks you from entering a SMILES to interpreting the prediction in five steps: open the tool, add your molecules, pick a model and endpoint, submit, and review the results.
Quick molecular property prediction with .bloom* platform
DeepChem provides deep learning models for predicting molecular properties from SMILES strings. This guide walks through your first property prediction, from entering a molecule to interpreting the predicted properties.
Step-by-step prediction workflow
Access the DeepChem tool
Navigate to DeepChem in the .bloom* tool selector, or ask Ivy directly:
- "Predict properties for this molecule using DeepChem"
- "Run DeepChem on my compounds"
Prepare your molecular input
Option A: Direct SMILES entry (fastest)
- Enter one or more SMILES strings (e.g.,
CC(=O)Oc1ccccc1C(=O)Ofor aspirin) - .bloom* validates each SMILES via RDKit in real time
- Separate multiple SMILES with newlines
Option B: CSV/TSV upload
- Upload a file with a column named
smilesorSMILES - Each row is processed as a separate molecule
- Additional columns are preserved in the output
Option C: From previous jobs
- Import molecules from GenMol generation or PubChem lookups
- .bloom* handles format conversion and SMILES extraction automatically
Configure prediction settings
Basic settings (recommended for first run):
- Model: Select a pre-trained model (e.g., solubility, hERG, AMES)
- Endpoints: Choose which properties to predict
- Keep default featurizer and model architecture
Advanced settings (via gear icon):
- Architecture: Choose MPNN, GCN, AttentiveFP, or other models
- Featurizer: Select ECFP, molecular graph, or other featurization
- Uncertainty: Enable ensemble or MC-dropout uncertainty estimation
- Multi-task: Predict multiple endpoints simultaneously
Submit and monitor the job
- Click Predict Properties to start the job
- .bloom* shows real-time progress through featurization and inference
- Typical completion: 5-30 seconds for up to 1,000 molecules
- Batch predictions process molecules in parallel
Review and analyze results
Prediction results:
- Property predictions for each molecule displayed in a sortable table
- Confidence intervals shown when uncertainty estimation is enabled
- Color-coded risk indicators for safety-relevant endpoints
Visualization:
- Property distribution histograms across the compound set
- Scatter plots for multi-property correlation analysis
- Feature importance maps highlighting atoms contributing to predictions
Download options:
- CSV: Predictions with SMILES, property values, and confidence intervals
- JSON: Structured results with metadata and model information
Common prediction scenarios
Single molecule profiling
- Enter the SMILES of your compound
- Select multiple endpoints (solubility, toxicity, permeability)
- Review the comprehensive property profile
- Use predictions to guide design decisions
Compound library screening
- Upload a CSV with SMILES for your compound library (up to 10,000 molecules)
- Select the target endpoints for screening
- Sort results by predicted property values
- Filter for compounds meeting your criteria
Post-generation screening
- Run GenMol to generate novel molecules
- Import generated SMILES into DeepChem
- Predict ADMET properties for the generated set
- Filter for drug-like compounds with favorable property profiles
Model comparison
- Run predictions with multiple model architectures (MPNN, GCN, AttentiveFP)
- Compare predictions across models for the same compounds
- Use consensus predictions (average across models) for higher confidence
- Identify compounds where models disagree for further investigation
Quality control checklist
Before submission
- SMILES strings are valid and parseable by RDKit
- Molecules are within the applicability domain of the selected model
- Selected endpoints are relevant to your research question
- Batch size is reasonable (under 10,000 molecules)
After prediction
- Predicted values are in reasonable ranges for the endpoint
- Uncertainty estimates are available and reasonable
- Out-of-domain warnings are noted for unusual molecules
- Predictions are consistent with known experimental data (spot checks)
Next steps after prediction
Compound triage:
- Filter compounds by predicted property thresholds
- Rank by multi-parameter optimization scores
- Feed top candidates into Compound Passport for comprehensive assessment
Iterative design:
- Identify property liabilities in your compound series
- Use DeepChem predictions to guide GenMol lead optimization
- Iterate between generation and prediction to converge on optimal candidates
Experimental validation:
- Prioritize compounds for experimental testing based on predictions
- Compare predicted vs. experimental values to assess model accuracy
- Use experimental data to fine-tune models for improved future predictions
Read next
Was this page helpful?