GenarrisΒΆ

Genarris Logo

Version 3.1.0 Python 3.10+ License DOI

A scalable, MPI-parallel Crystal Structure Prediction workflow for organic molecular crystals.

πŸ›οΈ Developed by the Noa Marom Group at Carnegie Mellon University.


πŸ“¦ Installation

Set up Genarris with pip in minutes.

Installation

πŸš€ Quick Start

Run your first CSP workflow step by step.

Quick Start

πŸ“– API Reference

Learn about gnrs API.

API Reference

πŸ’Ž Case Studies

CSP results and applications.

Case Studies

Key FeaturesΒΆ

πŸ”¬ Structure Generation

Random crystal generation across all 230 space groups.

πŸ“ Rigid Press

Improve efficiency of close-packed molecular crystal generation.

🧠 ML Potentials

Evaluate energies with state-of-the-art MLIPs including UMA, MACE-OFF, and AIMNet2 with GPU acceleration.

πŸ“Š Clustering & Selection

AP / K-Means clustering with ACSF descriptors and flexible selection strategies.

⚑ MPI Parallel

Scales to hundreds of cores with GPU worker/feeder pattern.

🧩 Modular Workflow

Configurable CSP workflows with extensible base classes.

Supported Energy CalculatorsΒΆ

πŸ”§ Calculator

🏷️ Type

πŸ–₯️ GPU

πŸ“ Description

UMA

MLIP

βœ…

Universal Model for Atoms from Meta FAIR Chemistry Team.

MACE-OFF

MLIP

βœ…

Transferable Organic Force Fields

AIMNet2

MLIP

βœ…

Flexible long-range interactions

DFTB+

Semi-Empirical

β€”

Density Functional Tight Binding

FHI-aims

DFT

β€”

All-electron DFT code

VASP

DFT

β€”

Plane-wave DFT code

CitationΒΆ

Please cite

Yang, Y., Tom, R., Wui, J. A., Moussa, J. E., & Marom, N. Genarris 3.0: Generating Close-Packed Molecular Crystal Structures with Rigid Press. Journal of Chemical Theory and Computation, 21, 11318–11332 (2025).

See the full Citation page for all related papers.