Installation

Requirements

AMBER requires Python 3.9 or higher and the following dependencies:

The easiest way to install AMBER is using pip:

pip install ambr

This will install AMBER and all required dependencies.

To install the latest development version from GitHub:

git clone https://github.com/a11to1n3/AMBER.git
cd AMBER
pip install -e .

For development, install with additional dependencies:

git clone https://github.com/a11to1n3/AMBER.git
cd AMBER
pip install -e ".[dev]"

This includes testing, documentation, and code quality tools.

To verify that AMBER is installed correctly, run:

import ambr as am
print(am.__version__)

You should see the version number printed without any errors.

For enhanced functionality, you may want to install:

pip install jupyter plotly tqdm

Import Error: If you get import errors, make sure all dependencies are installed:

pip install --upgrade polars numpy networkx matplotlib seaborn

Performance Issues: For large simulations, consider:

Jupyter Setup: For interactive development with Jupyter:

pip install ipykernel
python -m ipykernel install --user

If you encounter issues: