vss-deploy-detection-tracking-2d

Deploy, debug, and operate the RTVI-CV 2D detection and tracking microservice via Docker and REST API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Deploying and operating NVIDIA's RTVI-CV 2D detection/tracking microservice involves many error-prone steps: pulling NGC resources, resolving model and video paths, editing DeepStream configs, managing TensorRT engine caches, and driving the REST API for streams, health, and metrics. This Skill turns that into a guided, step-by-step workflow with deterministic helper scripts. ## Core Features & Use Cases - Guided deployment: End-to-end deploy flow for warehouse-2d, warehouse-3d, smartcity-rtdetr, and smartcity-gdino use cases, with platform detection (x86 dGPU, SBSA, Jetson) and per-step status boxes. - REST API operations: Add/remove/list streams, probe liveness/readiness/startup, collect FPS and GPU metrics, and generate text embeddings against a running instance on port 9000. - Debug and teardown: Troubleshooting runbooks for healthcheck failures, NGC auth errors, and GPU OOM, plus clean container teardown flows. - Use Case: An engineer says "deploy rtvi-cv warehouse 2d with 4 streams and display" — the Skill resolves the ONNX model and videos, applies batch/sink/source configuration inside the container, waits for readiness, and reports live FPS. ## Quick Start Ask the agent to deploy rtvi-cv warehouse 2d with 4 streams and display, then follow the step-by-step prompts it presents.

Frequently Asked Questions about vss-deploy-detection-tracking-2d

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

FAQPage Schema
How do I deploy the RTVI-CV 2D detection microservice?▼

Ask to deploy rtvi-cv with a use case such as warehouse-2d, smartcity-rtdetr, or smartcity-gdino. The Skill resolves NGC resources, applies DeepStream configuration inside the container, launches the perception app, and waits for readiness before reporting metrics.

How do I add or remove streams on a running rtvi-cv instance?▼

Use the REST API on port 9000: POST /api/v1/stream/add or /stream/remove with a camera_id and camera_url. The add_streams.sh helper adds streams one at a time with a delay to avoid caps-negotiation stalls in DeepStream.

What hardware does the RTVI-CV microservice support?▼

It runs on x86 and aarch64 dGPU systems (T4, A100, L40, H100, B200, RTX), SBSA platforms like Grace-Hopper, and Jetson devices including Thor, Orin, and Xavier. The Skill detects the platform and resolves matching defaults.

Why does the rtvi-cv container fail with NGC 401 or 403 errors?▼

HTTP 401/403 during image or resource pulls means the NGC_CLI_API_KEY is missing or expired. Run docker login nvcr.io and re-export the key before retrying the deployment.

What are the limitations of this deployment skill?▼

It requires the matching VSS profile to be deployed and reachable, plus NGC credentials for pulls. NGC-hosted models may have rate limits, GPU memory requirements, and license restrictions, and concurrency limits depend on host hardware.