Installation

Getting started is easy! You can install RA.Aid using any of these three methods - pick the one that works best for you:

UV

Create a new Python 3.12 virtual environment and install RA.Aid:

First install uv, then:

uv venv -p 3.12

Unix/macOS

source .venv/bin/activate

Windows

.venv\Scripts\activate

uv pip install ra-aid

pip

Install RA.Aid using pip:

pip install ra-aid

note

If you're using Python 3.13 or newer, we recommend using the UV installation method instead due to compatibility issues with newer Python versions.

macOS

Install RA.Aid using Homebrew:

brew tap ai-christianson/homebrew-ra-aid
brew install ra-aid

Once installed, see the Recommended Configuration to set up RA.Aid with the recommended settings.