Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

MoSDeF: A Molecular Simulation and Design Framework

MoSDeF consists of a collection of Python packages aimed at simplifying the creation, atom-typing, and simulation of complex molecular models - with a particular focus on the use of programmatic routines that allow for screening over large structural parameter spaces and the encapsulation of these routines to facilitate reproducibility.

MoSDeF is founded around two core Python packages:

  • mBuild: A hierarchical, component-based molecule builder
  • Foyer: A package for atom-typing as well as applying and disseminating forcefields


To access the MoSDeF tutorials clone this repository using:

git clone --recurse-submodules

Note the addition of the --recurse-submodules flag to the standard git clone command. The mBuild and Foyer tutorials are included here as submodules and this flag is necessary to download them.


This repository features a collection of tutorials and examples to help new users get familiarized with the MoSDeF toolkit. These tutorials/examples are organzied as follows:


  • mBuild 00: Getting Started
  • mBuild 01: Basic Functionality
  • mBuild 02: Resuing Components
  • mBuild 03: Connecting Components with Ports
  • mBuild 04: Constructing Larger Compounds
  • mBuild 05: Creating Flexible Classes
  • mBuild 06: Setting Up Bulk Systems
  • mBuild 07: Energy Minimization
  • mBuild 08: Building Polymers
  • mBuild 09: Surface Functionalization

The mBuild tutorials can also be accessed through the mBuild tutorials repository.


  • Foyer 00: Getting Started
  • Foyer 01: SMARTS and Overrides
  • Foyer 02: SMARTS for Non-Atomistic Systems
  • Foyer 03: Creating Force Field Files

The Foyer tutorials can also be accessed through the Foyer tutorials repository.

A series of full examples demonstrating how systems constructed with mBuild and Foyer can be used for performing simulations are currently under construction.

You can access this repository and run these tutorials interactively in-browser through our Binder link: Binder

If you would like a more general introduction to these tools, we have also included an "Overview" notebook that can be accessed through the following Binder link: Binder

Additionally, if you would like to access only the mBuild or only the Foyer tutorials, these can be accessed through the following Binder links:

mBuild Binder

Foyer Binder


A set of tutorials to introduce new users to the MoSDeF (Molecular Simulation Design Framework) toolkit







No packages published