Agent skill · NVIDIA
vss-deploy-video-embedding
Use this skill when deploying, operating, or integrating the VSS 3.2 GA RT-Embed Video Embedding microservice. Covers Docker Compose bring-up, GPU and storage prerequisites, the `/v1` REST API (file uploads, text and video embeddings, live RTSP streams, health and metrics), Redis/Kafka/OTel integration, common failure modes, and teardown.
What it needs
About 7k tokens when loaded.
What this skill does
VSS Video Embedding (RT-Embed) Use this skill when you need to: Deploy the VSS Video Embedding microservice from a Docker Compose file. Generate text or video embeddings against the Cosmos-Embed1-448p model. Embed an uploaded file, an HTTP/S3/file/data URL, or a live RTSP stream. Wire the service into a VSS deployment alongside Redis, Kafka, and OpenTelemetry. Triage readiness, model-download, GPU, or stream-reconnection failures. Trigger phrases: vss-deploy-video-embedding, RT-Embed, rtvi-embed, video embedding service, Cosmos-Embed1, embed live stream, embed video file, generate video embeddings, text embedding for video search. Service Snapshot VSS 3.2 GA skill: vss-deploy-video-embedding. Legacy 3.1 name: RT-Embed. Compose service: rtvi-embed. Container name: vss-rtvi-embed. Image: nvcr.io/nvidia/vss-core/vss-rt-embed (override with RTVIEMBEDIMAGE). Default tag: 3.2.1 (override with RTVIEMBEDTAG). Profile: bpdevelopersearch2d. Container port: 8000 (host-side ${RTVIEMBEDPORT}). Default model: cosmos-embed1-448p from nvidia/Cosmos-Embed1-448p. Health endpoint: GET /v1/ready. Healthcheck startup grace: 1200s (20 minutes) on first boot. Prerequisites Before bringing the service up: 1. NVIDIA driver + NVIDIA Container Toolkit installed; default runtime set to nvidia. 2. Docker Engine and Docker Compose plugin recent enough to support ${VAR:+value} conditional volume substitution. 3. docker login nvcr.io completed with $oauthtoken and a valid NGC API key. 4. Host environment provides at minimum: RTVIEMBEDPORT, VSSDATADIR, NGCAPIKEY, and optionally HFTOKEN to avoid Hugging Face 429 rate-limit errors during the Cosmos-Embed1 weights download. 5. Free disk space for persistent caches: rtvi-hf-cache, rtvi-ngc-model-cache, rtvi-triton-model-repo (multi-GB). See references/deploy-vss-deploy-video-embedding.md for the full prerequisite list and references/environment.md for the variable matrix. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills NVIDIA/vss-deploy-video-embedding