This repository contains Python bindings and sample applications for the DeepStream SDK.
Examples updated by Westray to work with the NVIDIA DeepStream NGC container. A modified Docker image with the python bindings installed in the default python3 is provided in the Dockerfile. It's important to pull the Docker image with tags ending in -devel or -samples that include the sample code and data.
List of sample apps updated to work with Docker container:
SDK version supported: 5.0
Download the latest release package complete with bindings and sample applications from the release section.
Please report any issues or bugs on the Deepstream SDK Forums.
DeepStream pipelines can be constructed using Gst Python, the GStreamer framework's Python bindings. For accessing DeepStream MetaData, Python bindings are provided in the form of a compiled module which is included in the DeepStream SDK. This module is generated using Pybind11.
These bindings support a Python interface to the MetaData structures and functions. Usage of this interface is documented in the HOW-TO Guide and demonstrated in the sample applications.
This release adds bindings for decoded image buffers (NvBufSurface) as well as inference output tensors (NvDsInferTensorMeta).
Sample applications provided here demonstrate how to work with DeepStream pipelines using Python.
The sample applications require MetaData Bindings to work.
To run the sample applications or write your own, please consult the HOW-TO Guide
We currently provide the following sample applications:
- deepstream-test1 -- 4-class object detection pipeline
- deepstream-test2 -- 4-class object detection, tracking and attribute classification pipeline
- deepstream-test3 -- multi-stream pipeline performing 4-class object detection
- deepstream-test4 -- msgbroker for sending analytics results to the cloud
- deepstream-imagedata-multistream -- multi-stream pipeline with access to image buffers
- deepstream-ssd-parser -- SSD model inference via Triton server with output parsing in Python
- deepstream-test1-usbcam -- deepstream-test1 pipeline with USB camera input
- deepstream-test1-rtsp-out -- deepstream-test1 pipeline with RTSP output
Detailed application information is provided in each application's subdirectory under apps.