Installing MADA Tools

In this page you'll find Basic Installation instructions (most users should just look at this section) and instructions for Installing Optional Dependencies which will likely only be needed by developers.

Basic Installation

Here are the steps required to install the MADA MCP Servers project:

1. First, clone the repository:

   sshhttps

   git clone git@github.com:llnl/mada-tools.git
   

   git clone https://github.com/llnl/mada-tools.git
   

2. Next, move into the cloned repository:

   cd mada-tools/
   

3. Create a python virtual environment:

   python -m venv mada_venv
   

   Note: If you've already installed MADA into a virtual environment, install MADA Tools in the same virtual environment.

4. Activate the environment:

   bashcsh

   source mada_venv/bin/activate
   

   source mada_venv/bin/activate.csh
   

5. From the top level of the repository, run:

   pip install -e .
   

Congratulations, the MADA Tools project is now installed!

You may also want to configure environment variables related to your API key and endpoint:

export API_KEY="your-api-key-here"
export API_BASE_URL="https://api.openai.com/v1/responses"

Installing Optional Dependencies

There are four sets of optional dependencies that can be installed:

• Documentation
• Examples
• Flux
• Tests

These can be installed together:

ShorthandVerbose

pip install -e ".[all]"

pip install -e .[tests,docs,examples,flux]

Or separately:

Install Test DependenciesInstall Documentation DependenciesInstall Example DependenciesInstall Flux Dependencies

pip install -e .[tests]

pip install -e .[docs]

pip install -e .[examples]

pip install -e .[flux]