Installing the Python Bindings

The recommended way to install the Python bindings is with pip. Wheels install cleanly into any active environment — system Python, venv, virtualenv, conda, or pyenv — without requiring elevated privileges.

From PyPI / a private index (when published):

pip install astutedds

From a pre-built wheel (offline / air-gapped installs):

pip install astutedds-<version>-cp312-cp312-manylinux_2_28_x86_64.whl

Smoke test:

python -c "import astutedds as dds; print(dds.__version__, dds.__file__)"

Installing into a virtual environment

venv and virtualenv are isolated from the system site-packages, so a system-wide install is not visible inside the venv. Activate the venv first and pip install as normal:

python3 -m venv .venv
source .venv/bin/activate
pip install astutedds
python -c "import astutedds; print(astutedds.__file__)"

System-Python install via .deb / .rpm

For sysadmins who prefer OS packaging, the python3-astutedds package installs the bindings for the system Python interpreter:

# Debian / Ubuntu
sudo dpkg -i python3-astutedds_<version>_<arch>.deb

# RHEL / AlmaLinux / Rocky / Fedora
sudo dnf install python3-astutedds-<version>.<arch>.rpm

The package installs into /usr/lib/python3.<X>/site-packages/astutedds/ (or /usr/lib/python3/dist-packages/astutedds/ on Debian/Ubuntu, depending on the target interpreter's default scheme).

Supported platforms

OS Architectures CPython
Linux (manylinux_2_28) x86_64, aarch64 3.10 – 3.13
Windows 10/11 AMD64 3.10 – 3.13

Uninstalling

pip uninstall astutedds

# or, for the system package:
sudo dpkg -r python3-astutedds      # Debian / Ubuntu
sudo dnf remove python3-astutedds   # RHEL / AlmaLinux / Rocky / Fedora