Implementations of different graph neural networks (GNNs) from scratch for Chemists
This repository serves as an educational resource for chemists and researchers interested in applying Graph Neural Networks to chemical problems. Each notebook progressively builds upon fundamental concepts, from basic graph representation of molecules to advanced molecular property prediction models.
To get the most out of this tutorial series, you should have:
- Python: Basic to intermediate Python programming skills
- Chemistry: Fundamental understanding of molecular structures and properties
- Machine Learning: Basic familiarity with neural network concepts
- Mathematics: Basic understanding of linear algebra and calculus fundamentals
- Packages: Familiarity with PyTorch, NumPy, and RDKit (installation instructions provided in notebooks)
No prior experience with graph neural networks is required - we build the concepts from the ground up!
| Notebook | Description | Open in Colab | Year |
|---|---|---|---|
| 01_GNN_representation.ipynb | Representing molecules as graphs |  |
2025 |
| 02_GNN_message_passing.ipynb | Understanding the message-passing concept | |
2025 |
| 03_GNN_molecular_activity_predictor.ipynb | Build and train the first GNN | |
2025 |
| 04_GNN_GCN.ipynb | Graph convolutional network | |
2025 |
| 05_GNN_GAT.ipynb | Graph attention network | |
2025 |
| 06_GNN_GIN.ipynb | Graph isomorphism network | |
2025 |
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
If you use this repository in your research, please cite it as:
@misc{gnns_for_chemists,
author = {Fooladi, Hosein},
title = {GNNs For Chemists: Implementations of Graph Neural Networks from Scratch for Chemical Applications},
year = {2025},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/HFooladi/GNNs-For-Chemists}},
note = {Educational resource for chemists, pharmacists, and researchers interested in applying Graph Neural Networks to chemical problems}
}