ur-whitelab / md-agent

Molecular dynamics simulations with an LLM agent

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

MD-Agent is a LLM-agent based toolset for Molecular Dynamics. It's built using Langchain and uses a collection of tools to set up and execute molecular dynamics simulations, particularly in OpenMM.

Environment Setup

To use the OpenMM features in the agent, please set up a conda environment, following these steps.

  • Create conda environment: conda env create -n mdagent -f environment.yaml
  • Activate your environment: conda activate mdagent

If you already have a conda environment, you can install dependencies with the following step.

  • Install the necessary conda dependencies: conda install -c conda-forge openmm pdbfixer mdtraj

Installation

pip install git+https://github.com/ur-whitelab/md-agent.git

Usage

The first step is to set up your API keys in your environment. An OpenAI key is necessary for this project. Other tools require API keys, such as paper-qa for literature searches. We recommend setting up the keys in a .env file. You can use the provided .env.example file as a template.

  1. Copy the .env.example file and rename it to .env: cp .env.example .env
  2. Replace the placeholder values in .env with your actual keys

Contributing

We welcome contributions to MD-Agent! If you're interested in contributing to the project, please check out our Contributor's Guide for detailed instructions on getting started, feature development, and the pull request process.

We value and appreciate all contributions to MD-Agent.

About

Molecular dynamics simulations with an LLM agent

License:MIT License


Languages

Language:Python 54.3%Language:Jupyter Notebook 45.6%Language:TeX 0.1%