MDCrow  by ur-whitelab

LLM agent for molecular dynamics simulations

Created 3 years ago
250 stars

Top 100.0% on SourcePulse

GitHubView on GitHub
Project Summary

MDCrow offers an LLM-agent-based toolset for automating molecular dynamics (MD) simulations, primarily targeting researchers and developers in computational chemistry and biophysics. By leveraging large language models and the Langchain framework, it simplifies the setup and execution of complex MD tasks, making advanced simulations more accessible and efficient.

How It Works

MDCrow integrates LLMs with a suite of tools designed for molecular dynamics simulations, with a strong focus on the OpenMM simulation toolkit. It acts as an agent that interprets natural language commands to configure simulation parameters, prepare input files, and run simulations. This approach abstracts away much of the intricate scripting typically required for MD, enabling users to interact with simulation software through conversational prompts.

Quick Start & Requirements

Environment setup requires Conda:

  • Create environment: conda env create -n mdcrow -f environment.yaml
  • Activate environment: conda activate mdcrow
  • Alternatively, update an existing environment: conda env update -n <YOUR_CONDA_ENV_HERE> -f environment.yaml

Installation:

  • pip install git+https://github.com/ur-whitelab/MDCrow.git

Usage requires API keys for supported LLM providers (OpenAI, TogetherAI, Fireworks, Anthropic), configured in a .env file.

Highlighted Details

  • Supports multiple LLM providers beyond OpenAI, including TogetherAI, Anthropic, and Fireworks, via specific Langchain packages (langchain-together, langchain-anthropic, langchain-fireworks).
  • Example usage demonstrates natural language interaction for simulation tasks: agent.run("Simulate protein 1ZNI at 300 K for 0.1 ps and calculate the RMSD over time.").
  • The toolset is built upon the Langchain framework, facilitating agent-based workflows.

Maintenance & Community

The README expresses an appreciation for contributions but provides no specific details on active maintainers, community channels (e.g., Discord, Slack), or roadmap.

Licensing & Compatibility

No license information is provided in the README. This absence makes it difficult to assess compatibility for commercial use or integration into closed-source projects without further inquiry.

Limitations & Caveats

The project requires users to manage LLM API keys and set up a specific Conda environment, which may present an initial barrier. The lack of explicit licensing information is a significant caveat for adoption. Details regarding supported MD simulation complexities, performance benchmarks, or specific hardware requirements (e.g., GPU acceleration for OpenMM) are not detailed.

Health Check
Last Commit

9 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
2 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.