OpenAD is fully open source and we encourage contributions. If you have any questions, please get in touch.
Building your own OpenAD plugin lets you to integrate your own tools into the OpenAD workflow.
Stay tuned here for documentation on how to do this.
C O M I N G S O O N
Step 1: Download the repo
git clone https://github.com/acceleratedscience/open-ad-toolkit.git
Note: To download a specific branch, you can run instead:
git clone -b <branch_name> https://github.com/acceleratedscience/open-ad-toolkit.git
Step 2: Launch the setup wizard
cd open-ad-toolkit
./setup.sh
Step 0: Before you start
Ensure you’re running Python 3.10.10 or 3.11. See instructions below.
To see what version you are running:
python -V
Note: Due to an issue with one of our dependencies, Python 3.12 is not yet supported.
Step 1: Set up your virtual environment (recommended)
python -m venv ~/ad-venv
source ~/ad-venv/bin/activate
Note: Use
python3on macOS. Note: To exit the virtual environment, you can rundeactivate
Step 2: Download the repo
git clone https://github.com/acceleratedscience/open-ad-toolkit.git
Note: To download a specific branch, you can run instead:
git clone -b <branch_name> https://github.com/acceleratedscience/open-ad-toolkit.git
Step 2: Install OpenAD
cd open-ad-toolkit
pip install -e .
Note: The -e flag stands for “editable”. This means that instead of copying the package’s files to the Python site-packages directory as in a regular installation, pip creates a symbolic link (symlink) from your package’s source code directory into your Python environment.
This way you can make changes to the source code of the package, and those changes are immediately reflected in your Python environment. You don’t need to reinstall the package every time you make a change.
To do a regular install from a particular branch, you can run:
pip install git+https://github.com/acceleratedscience/open-ad-toolkit.git@<branch_name>