LogoLogo
AI HubCommunityWebsite
  • Start Here
  • AI Hub
    • Overview
    • Quickstart
    • Spaces
    • Device Farm
    • Browser Inference
    • Model Zoo
      • Hailo
      • Intel
      • MemryX
      • BrainChip
      • Google
      • DeGirum
      • Rockchip
    • View and Create Model Zoos
    • Compiler
    • PySDK Integration
  • PySDK
    • Overview
    • Quickstart
    • Installation
    • Runtimes and Drivers
      • Hailo
      • OpenVINO
      • MemryX
      • BrainChip
      • Rockchip
      • ONNX
    • PySDK User Guide
      • Core Concepts
      • Organizing Models
      • Setting Up an AI Server
      • Loading an AI Model
      • Running AI Model Inference
      • Model JSON Structure
      • Command Line Interface
      • API Reference Guide
        • PySDK Package
        • Model Module
        • Zoo Manager Module
        • Postprocessor Module
        • AI Server Module
        • Miscellaneous Modules
      • Older PySDK User Guides
        • PySDK 0.16.1
        • PySDK 0.16.0
        • PySDK 0.15.2
        • PySDK 0.15.1
        • PySDK 0.15.0
        • PySDK 0.14.3
        • PySDK 0.14.2
        • PySDK 0.14.1
        • PySDK 0.14.0
        • PySDK 0.13.4
        • PySDK 0.13.3
        • PySDK 0.13.2
        • PySDK 0.13.1
        • PySDK 0.13.0
    • Release Notes
      • Retired Versions
    • EULA
  • DeGirum Tools
    • Overview
      • Streams
        • Streams Base
        • Streams Gizmos
      • Compound Models
      • Analyzers
        • Clip Saver
        • Event Detector
        • Line Count
        • Notifier
        • Object Selector
        • Object Tracker
        • Zone Count
      • Inference Support
      • Support Modules
        • Audio Support
        • Model Evaluation Support
        • Math Support
        • Object Storage Support
        • UI Support
        • Video Support
      • Environment Variables
  • DeGirumJS
    • Overview
    • Get Started
    • Understanding Results
    • Release Notes
    • API Reference Guides
      • DeGirumJS 0.1.3
      • DeGirumJS 0.1.2
      • DeGirumJS 0.1.1
      • DeGirumJS 0.1.0
      • DeGirumJS 0.0.9
      • DeGirumJS 0.0.8
      • DeGirumJS 0.0.7
      • DeGirumJS 0.0.6
      • DeGirumJS 0.0.5
      • DeGirumJS 0.0.4
      • DeGirumJS 0.0.3
      • DeGirumJS 0.0.2
      • DeGirumJS 0.0.1
  • Orca
    • Overview
    • Benchmarks
    • Unboxing and Installation
    • M.2 Setup
    • USB Setup
    • Thermal Management
    • Tools
  • Resources
    • External Links
Powered by GitBook

Get Started

  • AI Hub Quickstart
  • PySDK Quickstart
  • PySDK in Colab

Resources

  • AI Hub
  • Community
  • DeGirum Website

Social

  • LinkedIn
  • YouTube

Legal

  • PySDK EULA
  • Terms of Service
  • Privacy Policy

© 2025 DeGirum Corp.

On this page
  • Supported Environments
  • Supported Hardware
  • Installation Options
  • Using pip install in a Virtual Environment
  • Docker Images
  • Runtimes and Drivers
  • Verification
  • Troubleshooting

Was this helpful?

  1. PySDK

Installation

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

PreviousQuickstartNextRuntimes and Drivers

Last updated 1 day ago

Was this helpful?

Supported Environments

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

Supported Hardware

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

Installation Options

Using pip install in a Virtual Environment

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 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.

  1. Install a Python version supported by PySDK: After disabling the App Execution Alias, install Python from the or with winget. When installing with , 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:

1

Create a Python Virtual Environment

Use this command to create a virtual environment:

python -m venv <virtual-environment-name>

If you have Python Launcher and multiple Python versions installed, use py to create the virtual environment:

# Only if you have multiple Python versions installed
py <your-python-version> -m venv <virtual-environment-name>
2

Activate the Python Virtual Environment

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

cd <virtual-environment-name>\Scripts

Once in that folder, run activate.

# On cmd.exe:
activate

# On pwsh.exe:
.\Activate.ps1

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

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.

# PySDK only
pip install degirum
# PySDK and degirum-tools
pip install degirum degirum-tools
4

Verify PySDK Installation

Run this command in the active virtual environment:

degirum sys-info

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. Choose the appropriate commands for your system:

# Ubuntu:
sudo apt-get update
sudo apt-get install python<release-number>
# Example: sudo apt-get install python3.12
# RHEL. If using an old RHEL, use yum instead of dnf:
sudo dnf install python<release-number>
# Example: sudo dnf install python3.12
1

Create a Python Virtual Environment

Use this command to create a virtual environment:

# python3 does not necessarily point to a Python version supported by PySDK.
# Run python3 --version to verify Python version.
# If python3 is a version supported by PySDK, then create the Python virtual environment.
python3 -m venv <virtual-environment-name>

If you have multiple Python versions installed, you can specify a Python release version to create the virtual environment:

# Only if you have multiple Python versions installed
python<python-version> -m venv <virtual-environment-name>
2

Activate the Python Virtual Environment

After creating the environment with venv, activate it by running source <virtual-environment-folder>/bin/activate.

source <virtual-environment-folder>/bin/activate

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

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.

# PySDK only
pip install degirum
# PySDK and degirum-tools
pip install degirum degirum-tools

Docker Images

Runtimes and Drivers

Verification

After installing the required runtimes and device drivers, verify that PySDK can access them by running this command:

degirum sys-info

The output lists the devices available to PySDK with relevant information.

Devices:
<other device types>
    <runtime>/<device type>:
    - '@Index': 0
      <device dependent information, optional>
    - '@Index': 1
      <device dependent information, optional>
      <other devices>
    <other device types>

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

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.

DeGirum AI server
PySDK AI client
this GitHub link to DeGirum Docker repo
this link
Visual C++ Redistributable for Visual Studio 2015 or later
Visual C++ Redistributable for Visual Studio 2015 or later
official Python website
winget
Windows Installation
Windows Python App Execution Aliases for python.exe and python3.exe .
PowerShell terminal with an active degirum-windows virtual environment
Creating a Python virtual environment with a specific Python version
Terminal with an active degirumvirtual environment
Operating System
Supported CPU Architectures
Supported Python Versions

Ubuntu 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

Vendor
Runtime
Devices
Model Binary Format

Hailo

HAILORT

HAILO8, HAILO8L

.hef

Google

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