deepstream-dev

Build NVIDIA DeepStream video analytics pipelines with the Python pyservicemaker API.

2|Updated Aug 20, 2026
One-click install
npx skills add https://github.com/atomicrajat/industry_safety_monitoring_system --skill deepstream-dev-atomicrajat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deepstream-dev
Source: https://github.com/atomicrajat/industry_safety_monitoring_system/tree/main/.claude/skills/deepstream-dev
Command: npx skills add https://github.com/atomicrajat/industry_safety_monitoring_system --skill deepstream-dev-atomicrajat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyservicemaker, pyyaml, and includes references (resource) components.

What problem does it solve? Writing NVIDIA DeepStream pipelines involves exact GStreamer element properties, nvinfer config formats, and subtle pitfalls (request pads, async sinks, metadata iterators) that are easy to get wrong from memory. This Skill grounds code generation in verified reference documents so pipelines work on the first run. ## Core Features & Use Cases - Pipeline Construction: Generate pyservicemaker code for source, stream muxing, TensorRT inference, tracking, OSD, and rendering stages with correct element properties. - Configuration Authoring: Produce valid nvinfer YAML/INI configs, tracker configs (NvDCF, DeepSORT, NvSORT), and Kafka message broker setups. - Troubleshooting: Diagnose common failures such as pipelines stuck in PAUSED, dynamic ONNX dimension errors, and metadata iterator misuse. - Use Case: Ask for a multi-stream RTSP object detection pipeline with Kafka alerts, and receive working Python code plus configs that follow DeepStream SDK conventions. ## Quick Start Use the deepstream-dev skill to build a DeepStream pipeline that detects objects in an RTSP camera stream and publishes results to Kafka.

Frequently Asked Questions about deepstream-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a DeepStream pipeline in Python?

Use the pyservicemaker Pipeline API to add elements like nvurisrcbin, nvstreammux, nvinfer, and a display sink, then link them and call start(). Sources should default to nvurisrcbin, which handles RTSP, HTTP, and local files transparently.

How do I run YOLO models with DeepStream nvinfer?

Point the nvinfer config at your ONNX file and set infer-dims for dynamic models, such as infer-dims=3;640;640. Match cluster-mode to the model generation: v8/v11 output raw pre-NMS tensors needing cluster-mode 2, while v10+ output post-NMS results needing cluster-mode 4.

Why is my DeepStream pipeline stuck in PAUSED state?

Pipelines using tee splits or dynamic sources hang in PAUSED when any sink lacks async=0. Set async: 0 on every sink element, including nvmsgbroker and display sinks, to allow the state transition to PLAYING.

Does pyservicemaker work inside a Python virtual environment?

pyservicemaker is installed system-wide but is not visible inside a standard venv. Install it explicitly with pip install /opt/nvidia/deepstream/deepstream/service-maker/python/pyservicemaker*.whl pyyaml inside the venv.

Can DeepStream send detection results to Kafka?

Yes, use nvmsgconv to convert metadata and nvmsgbroker with the libnvds_kafka_proto.so protocol library to publish to Kafka. Since nvmsgbroker is a sink, use a tee element to split the pipeline when you also need video output.