Installation
Follow comprehensive installation guides for PySDK, covering virtual environments, Docker images, and verification.
Last updated
Was this helpful?
Follow comprehensive installation guides for PySDK, covering virtual environments, Docker images, and verification.
Last updated
Was this helpful?
PySDK currently supports these operating systems, CPU architectures, and Python versions.
Below is a summary of what hardware we support, including the runtime, devices, and model binary formats.
pip install
in a Virtual EnvironmentWe 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.
If Python is not installed, disable the Windows Python App Execution Alias before installing Python and PySDK. Ensure the is installed.
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:
Create a Python Virtual Environment
Use this command to create a virtual environment:
If you have Python Launcher and multiple Python versions installed, use py
to create the virtual environment:
Activate the Python Virtual Environment
After creating the environment with venv
, navigate to the Scripts
folder in your virtual environment.
Once in that folder, run activate
.
After activation, the virtual environment name appears before the terminal prompt.
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.
Verify PySDK Installation
Run this command in the active virtual environment:
A list of detected devices confirms that PySDK is installed.
Ensure a Python version supported by PySDK is installed.
Create a Python Virtual Environment
Use this command to create a virtual environment:
If you have multiple Python versions installed, you can specify a Python release version to create the virtual environment:
Activate the Python Virtual Environment
After creating the environment with venv
, activate it by running source <virtual-environment-folder>/bin/activate
.
After activation, the virtual environment name appears before the terminal prompt.
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.
After installing the required runtimes and device drivers, verify that PySDK can access them by running this command:
The output lists the devices available to PySDK with relevant information.
If you encounter errors such as:
Create a new virtual environment and reinstall PySDK.
You can also try upgrading pip
with this command:
We also provide Docker images for the and installations.
Follow for details on how to run these images and for corresponding source Dockerfiles.
We support multiple hardware options and runtime environments. PySDK comes with support for N2X and TFLite runtimes. Follow for more details.
On Windows, confirm that the is installed.
python.exe
and python3.exe
.degirum-windows
virtual environmentdegirum
virtual environmentUbuntu Linux 20.04, 22.04, 24.04
x86-64
3.9 ... 3.12
Ubuntu Linux 20.04, 22.04, 24.04
ARM AArch64
3.9 ... 3.12
Raspberry Pi OS (64 bit)
ARM AArch64
3.9
Windows 10/11
x86-64
3.9 ... 3.12
macOS 12
ARM AArch64
3.9
Hailo
HAILORT
HAILO8, HAILO8L
.hef
TFLITE
EDGETPU
.tflite
Intel
OPENVINO
CPU, GPU, NPU
.onnx, .bin & .xml
BrainChip
AKIDA
NSoC_v2, AKD1500
.bin
DeGirum
N2X
ORCA1
.n2x
Rockchip
RKNN
RK3588, RK3568, RK3566
.rknn
MemryX
MEMRYX
MX3
.dfp
AMD
ONNX
VITIS_NPU
.onnx
NVIDIA
TENSORRT
DLA, GPU
.onnx