Installation

RIA Hub Toolkit OSS can be installed either as a Conda package or as a standard Python package.

Please note that SDR drivers must be installed separately. Refer to the SDR Guides section for additional setup instructions.

Common driver packages by device (exact package names depend on your OS):

Device	Driver Package
USRP	UHD drivers
Pluto	libiio / IIO utilities
BladeRF	libbladeRF
HackRF	libhackrf
RTL-SDR	librtlsdr

We want your experience with RIA Toolkit OSS to be as smooth and frictionless as possible. If you run into any issues during installation, please reach out to our support team: support@qoherent.ai.

Installation with Conda (Recommended)

Conda packages for RIA Toolkit OSS are available on RIA Hub.

RIA Toolkit OSS can be installed into any Conda environment. However, it is recommended to install within the base environment of Radioconda, which includes GNU Radio and several pre-configured libraries for common SDR devices. Detailed instructions for installing and setting up Radioconda are available in the project README.

Please follow the steps below to install RIA Toolkit OSS using Conda:

Before installing RIA Toolkit OSS into your Conda environment, update the Conda package manager:
Terminal window
```
conda update --force conda
```
This ensures that the Conda package manager is fully up-to-date, allowing new or updated packages to be installed into the base environment without conflicts.

Add RIA Hub to your Conda channel configuration:

conda config --add channels https://riahub.ai/api/packages/qoherent/conda

Activate your Conda environment and install RIA Toolkit OSS. For example, with Radioconda:
Terminal window
```
conda activate base
conda install ria-toolkit-oss
```
After installing RIA Toolkit OSS, verify that the installation was successful by running:
Terminal window
```
conda list
```
If installation was successful, you should see a line item for ria-toolkit-oss:
```
ria-toolkit-oss           <version>                  <build>    https://riahub.ai/api/packages/qoherent/conda
```

Installation with pip

RIA Toolkit OSS is available as a standard Python package on both RIA Hub and PyPI.

These packages can be installed into a standard Python virtual environment using pip. For help getting started with Python virtual environments, refer to the Python Virtual Environments tutorial.

Please follow the steps below to install RIA Toolkit OSS using pip:

Create and activate a Python virtual environment:

On Linux/macOS:
Terminal window
```
python3 -m venv venv
source venv/bin/activate
```
On Windows (Command Prompt):
```
python -m venv venv
venv\Scripts\activate
```

Upgrade pip and install RIA Toolkit OSS:

pip install --upgrade pip
pip install ria-toolkit-oss

Verify the CLI is available:
Terminal window
```
ria --help
```
A successful install prints the top-level help text. pyproject.toml registers two entrypoints — ria and ria-tools — that both point to the same CLI module.

Installation from Source

RIA Toolkit OSS can be installed directly from the source code. This approach is only recommended if you require an unpublished or development version of the project. Follow the steps below:

Clone the repository:

git clone https://riahub.ai/qoherent/ria-toolkit-oss.git

Navigate into the project directory:
Terminal window
```
cd ria-toolkit-oss
```
Install with pip:
Terminal window
```
pip install .
```
For local development, use pip install -e . instead to install in editable mode so local changes take effect immediately without reinstalling.