FastMDXplora

Fully Automated SysTem for Molecular Dynamics eXploration

FastMDXplora explores a protein's behavior end to end from a single command. Given a structure (or just a PDB ID) it performs molecular dynamics exploration all the way through setup, simulation, analysis, and reporting, then hands back publication-ready results.

  setup  →  simulation  →  analysis  →  report

Highlights

• Explore a protein's full dynamics with a single command, covering setup, simulation, analysis, and reporting
• Build a protein-ligand system from a PDB identifier alone: the ligand is identified, its chemistry retrieved, and its protonation settled in the binding site, with a refusal rather than a guess where the structure is ambiguous
• Probe protein-ligand binding automatically with analyses for pose stability, contacts, and protein-ligand hydrogen bonds
• Reach beyond plain MD with built-in PLUMED enhanced sampling (metadynamics, umbrella sampling, steered MD)
• Design, start, watch, and review an exploration from a browser, with a 3D viewer and live telemetry
• Scale from a quick single-protein exploration to large parallel campaigns, driven the same way from the CLI or the Python API

Phases of FastMDXplora

Install

From conda-forge, which brings every backend with it:

conda create -n fastmdxplora -c conda-forge fastmdxplora
conda activate fastmdxplora

This is the recommended route. OpenMM, PDBFixer, OpenFF, RDKit, and PROPKA are conda-forge packages, and the ligand path needs all of them; installing them any other way is more work for the same result.

From PyPI, if you already manage those yourself or only need part of the pipeline:

pip install fastmdxplora            # analysis and reporting
pip install "fastmdxplora[md]"      # adds setup and simulation
pip install "fastmdxplora[ligand]"  # adds protein-ligand preparation

Run fastmdx info afterwards to see which backends were found.

Working on FastMDXplora itself, Windows and WSL2, and troubleshooting a partial install are covered in the installation guide.

Quick start

fastmdx explore --system 1L2Y      # a full exploration, from a PDB ID
fastmdx gui                        # design, start, and watch one in a browser
fastmdx info                       # what is installed and which backends are present

From Python:

import fastmdxplora as fastmdx

runs = fastmdx.FastMDXplora(system="1L2Y", output_dir="trpcage").explore()
print(runs[0].output_dir)

For anything beyond a quick run, capture the whole exploration in a YAML file. fastmdx init-config writes a commented template, and the same file drives both the CLI and the Python API:

fastmdx explore --config study.yml

Parameter sweeps, multi-system campaigns, cross-run comparison, parallel execution, and the full flag list are covered in the usage examples and the CLI reference.

Outputs by phase

Each phase writes to its own subdirectory under the output root, with a parameters manifest so every artifact is traceable to the options that produced it.

Documentation

Full documentation is at fastmdxplora.readthedocs.io:

• Beginner's guide: first run, start to finish
• Installation: every route, platform notes, troubleshooting
• GUI: the browser interface, and watching a cluster run
• Configuration: the YAML file, option by option
• CLI reference: every command and flag
• Production runs: GPUs, long trajectories, scaling

Citation

If you use FastMDXplora in your work, please cite:

Aina, A.; Kwan, D. FastMDAnalysis: Software for Automated Analysis of Molecular Dynamics Trajectories. J. Comput. Chem. 2026, 47, e70350. DOI: 10.1002/jcc.70350

@article{aina2026fastmd,
  author  = {Aina, Adekunle and Kwan, Derrick},
  title   = {FastMDAnalysis: Software for Automated Analysis of Molecular Dynamics Trajectories},
  journal = {Journal of Computational Chemistry},
  volume  = {47},
  number  = {8},
  pages   = {e70350},
  year    = {2026},
  doi     = {10.1002/jcc.70350},
}

Contributing

Contributions are welcome. See CONTRIBUTING.md. FastMDXplora follows the Contributor Covenant.

License

MIT. See LICENSE.

Acknowledgements

FastMDXplora is developed in the AAI Research Lab at California State University Dominguez Hills. It builds on a deep ecosystem of open-source scientific Python: MDTraj, OpenMM, PDBFixer, NumPy, SciPy, scikit-learn, Matplotlib, python-pptx, and many others.