Installation

Follow comprehensive installation guides for PySDK, covering virtual environments, Docker images, and verification.

Quick Install

Recommended: install in a virtual environment (venv/conda) to avoid dependency conflicts.

Note: DeGirum PySDK is installed from DeGirum’s package index at https://pkg.degirum.com (this is the preferred install source).

pip install -i https://pkg.degirum.com degirum

Detailed, platform-specific installation steps (OS, accelerators/runtimes, troubleshooting) are provided in the Installation Options section.

Starting with PySDK version 1.0.0, PySDK is governed by new EULA. Please read the new EULA before installing/upgrading.

Token installation and license

Starting from ver. 1.0.0, the usage of premium runtime plugins requires license. The license is obtained automatically by PySDK from DeGirum AI Hub if you have AI Hub token installed on your system. Once requested, the plugin license is stored locally and automatically renewed on expiration. Default expiration period is 10 days. The license is node-locked.

The Free plan allows you to use PySDK premium runtimes on one host. If you need to use PySDK premium runtimes on more than one host, you need to upgrade your AI Hub workspace to Professional or Enterprise plans.

To install existing AI Hub token, you run degirum CLI command: degirum token install <TOKEN> where <TOKEN> is the AI Hub token string which you generate on AI Hub.

To create new token and install it, you run degirum CLI command: degirum token create. If you run this command on a system having graphical desktop, it will open token generation page in your default browser for you. Otherwise it will print URL which you need to paste in any browser.

To upgrade your plan, follow these instructions.

The premium plugins include:

• Akida (Brainchip)

• Axelera

• DeepX

• Hailo

• MemryX

• ONNX

• OpenVINO (Intel)

• Renesas

• RKNN (RockChip)

• TensorRT (NVIDIA)

Free plugins include DeGirum N2X Orca and Google TFLite.

Supported Environments

PySDK currently supports these operating systems, CPU architectures, and Python versions.

Operating System	Supported CPU Architectures	Supported Python Versions
Ubuntu Linux 20.04, 22.04, 24.04	x86-64	3.9 ... 3.13
Ubuntu Linux 20.04, 22.04, 24.04	ARM AArch64	3.9 ... 3.13
Raspberry Pi OS (64 bit)	ARM AArch64	3.9 ... 3.13
Windows 10/11	x86-64	3.9 ... 3.13
macOS	ARM AArch64	3.9

Supported Hardware

Below is a summary of what hardware we support, including the runtime, devices, and model binary formats.

Vendor	Runtime	Devices	Model Binary Format
Hailo	HAILORT	HAILO8, HAILO8L	.hef
Axelera AI	AXELERA	Metis	.bin, .json, & .c
DEEPX	DEEPX	M1A	.dxnn
Intel	OPENVINO	CPU, GPU, NPU	.onnx, .bin & .xml
Renesas	RENESAS	RZ-V2N	.so
Rockchip	RKNN	RK3588, RK3568, RK3566	.rknn
MemryX	MEMRYX	MX3	.dfp
BrainChip	AKIDA	NSoC_v2, AKD1500	.bin
Google	TFLITE	EDGETPU	.tflite
DeGirum	N2X	ORCA1	.n2x
NVIDIA	TENSORRT	DLA, GPU	.onnx
AMD	ONNX	VITIS_NPU	.onnx

Installation Options

We recommend creating a Python virtual environment for PySDK and other DeGirum Python packages.

Open a command prompt or terminal, then follow the steps for your system below.

Windows

If Python is not installed, disable the Windows Python App Execution Alias before installing Python and PySDK. Ensure the Visual C++ Redistributable for Visual Studio 2015 or later is installed.

Disabling the Windows Python App Execution Alias and Installing Python on Windows

1. Locate the Alias: By default, Windows will overwrite python with Python from the Microsoft Store when entered in a terminal. Search for App Execution Alias in Windows Settings and disable both python.exe and python3.exe aliases.

Windows Python App Execution Aliases for python.exe and python3.exe .

1. Install a Python version supported by PySDK: After disabling the App Execution Alias, install Python from the official Python website or with winget. When installing with winget, include both Python.Python.<version> and Python.Launcher.

Installing PySDK in a Python Virtual Environment on Windows

Ensure a supported Python version is installed, then watch the video or follow the steps below:

Windows Installation

1

Create a Python Virtual Environment

Use this command to create a virtual environment with the default Python installation:

cd ~
python -m venv degirum-windows

Alternatively, with Python Launcher (explicit 3.12):

py -3.12 -m venv degirum-windows

2

Activate the Python Virtual Environment

After creating the environment with venv, navigate to the Scripts folder in your virtual environment.

cd ~\degirum-windows\Scripts

Once in that folder, run the activation command.

On cmd.exe:

activate

On pwsh.exe:

.\Activate.ps1

After activation, the virtual environment name appears before the terminal prompt.

PowerShell terminal with an active degirum-windows virtual environment

3

Install PySDK with pip install

With the environment active, use pip to install PySDK and optionally degirum-tools. The PySDK package is degirum, while degirum-tools helps you build AI applications with PySDK.

To install only PySDK:

pip install -i https://pkg.degirum.com degirum

To install both PySDK and degirum-tools:

pip install -i https://pkg.degirum.com degirum degirum-tools

4

Verify PySDK Installation

Run this command in the active virtual environment:

degirum sys-info

Example output:

(degirum-windows) PS C:\degirum\degirum-windows\Scripts> degirum sys-info
Devices:
  N2X/CPU:
  - '@Index': 0
  TFLITE/CPU:
  - '@Index': 0
  - '@Index': 1
  - '@Index': 2
  - '@Index': 3
Software Version: 1.0.0

A list of detected devices confirms that PySDK is installed.

Linux

Ensure a Python version supported by PySDK is installed.

Installing Python on Linux

Commands vary by distribution. Use these examples as a guide.

For Ubuntu 24.04:

Update package lists and upgrade installed packages. Then, install Python and the venv module.

sudo apt update
sudo apt upgrade -y
sudo apt install -y python3 python3-venv

For Raspberry Pi OS:

You should only need to update package lists and upgrade installed packages. Python 3 is preinstalled on 64-bit Raspberry Pi OS.

sudo apt update
sudo apt upgrade -y

1

Create a Python Virtual Environment

Use this command to create a virtual environment:

cd ~
python3 -m venv degirum

Alternatively, to target Python 3.12 explicitly:

python3.12 -m venv degirum

2

Activate the Python Virtual Environment

After creating the environment with venv, activate it:

source ~/degirum/bin/activate

After activation, the virtual environment name appears before the terminal prompt.

Terminal with an active degirumvirtual environment

3

Install PySDK with pip install

With the environment active, use pip to install PySDK and optionally degirum-tools. The PySDK package is degirum, while degirum-tools helps you build AI applications with PySDK.

To install only PySDK:

pip install -i https://pkg.degirum.com degirum 

To install both PySDK and degirum-tools:

pip install -i https://pkg.degirum.com degirum degirum-tools 

4

Verify PySDK Installation

Run this command in the active virtual environment:

degirum sys-info

Example output:

(degirum) root@dl4328:~# degirum sys-info
Devices:
  N2X/CPU:
  - '@Index': 0
  TFLITE/CPU:
  - '@Index': 0
  - '@Index': 1
  - '@Index': 2
  - '@Index': 3
Software Version: 1.0.0

A list of detected devices confirms that PySDK is installed.

Docker Images

We also provide Docker images for DeGirum AI server and PySDK AI client installations.

Follow this GitHub link to DeGirum Docker repo for details on how to run these images and for corresponding source Dockerfiles.

Runtimes and Drivers

We support multiple hardware options and runtime environments. PySDK comes with support for N2X and TFLite runtimes. Follow this link for more details.

Limiting Runtime Plugin Loading

PySDK searches for runtime plugins at startup. To restrict which plugins load, set the DG_PLUGINS_ALLOWED environment variable to a list of plugin prefixes separated by any non alphanumeric character. For example:

export DG_PLUGINS_ALLOWED=n2x_runtime_agent;onnx_runtime_agent

Only plugins with prefixes in the list load when DG_PLUGINS_ALLOWED is set. If the variable is not defined, all available plugins load as before.

Supported plugin prefixes include hailort_runtime_agent, openvino_runtime_agent, axelera_runtime_agent, memryxrt_runtime_agent, akida_runtime_agent, tflite_runtime_agent, n2x_runtime_agent, rknn_runtime_agent, onnx_runtime_agent, and tensorrt_runtime_agent.

Verification

After installing runtimes and device drivers, verify PySDK on Windows 11 or Ubuntu 24.04 by running:

degirum sys-info

Example output (PowerShell, Windows):

(degirum-windows) PS C:\degirum\degirum-windows\Scripts> degirum sys-info
Devices:
  N2X/CPU:
  - '@Index': 0
  TFLITE/CPU:
  - '@Index': 0
  - '@Index': 1
  - '@Index': 2
  - '@Index': 3
Software Version: 1.0.0

Example output (Linux):

(degirum) root@dl4328:~# degirum sys-info
Devices:
  N2X/CPU:
  - '@Index': 0
  TFLITE/CPU:
  - '@Index': 0
  - '@Index': 1
  - '@Index': 2
  - '@Index': 3
Software Version: 1.0.0

Troubleshooting

If you encounter errors such as:

ERROR: Could not find a version that satisfies the requirement degirum
ERROR: No matching distribution found for degirum

Create a new virtual environment and reinstall PySDK.

You can also try upgrading pip with this command:

python3 -m pip install -U pip

On Windows, confirm that the Visual C++ Redistributable for Visual Studio 2015 or later is installed.