pynvvideocodec

library2.1.0pypypi✓ verified 83d ago

PyNvVideoCodec is NVIDIA's Python library for hardware-accelerated video encoding and decoding on NVIDIA GPUs. It wraps the NVIDIA Video Codec SDK and provides high-performance encode/decode operations directly from Python. Current version 2.1.0, requires Python >=3.8 and an NVIDIA GPU with supported drivers. Release cadence is irregular, tied to SDK updates.

devops

pip install pynvvideocodec

INSTALL

IMPORT

SIG · PYNVVIDEOCODEC

pynvvideocodec

devopspythonv2.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CreateDecoder

✓ from PyNvVideoCodec import CreateDecoder

✗ from pynvvideocodec import PyNvEncoder

CreateEncoder

✓ from PyNvVideoCodec import CreateEncoder

✗ from pynvvideocodec import PyNvEncoder

CreateTranscoder

✓ from PyNvVideoCodec import CreateTranscoder

✗ from pynvvideocodec import PyNvEncoder

Basic encode and decode a single frame. Requires an NVIDIA GPU with proper drivers.

from pynvvideocodec import PyNvEncoder, PyNvDecoder, EncodeConfig, DecodeConfig import numpy as np # Encode example enc_config = EncodeConfig( codec='h264', width=1920, height=1080, framerate=30, bitrate=5000000 ) encoder = PyNvEncoder(enc_config) frame = np.zeros((1080, 1920, 3), dtype=np.uint8) encoded = encoder.encode(frame) # Decode example dec_config = DecodeConfig(codec='h264', width=1920, height=1080) decoder = PyNvDecoder(dec_config) decoded = decoder.decode(encoded) print('Success')

Debug

Known issues

breakingCUDA context must be initialized before creating encoder/decoder. Failure results in segmentation fault.

fix

Ensure a CUDA context is active (e.g., via cuda-python or PyTorch) before creating any PyNvEncoder or PyNvDecoder.

affects: all

breakingThe module path changed from 'nvidia.video_codec' to 'pynvvideocodec' in v2.0.0. Old imports break.

fix

Replace 'from nvidia.video_codec import ...' with 'from pynvvideocodec import ...'.

affects: >=2.0.0

gotchaEncodeConfig and DecodeConfig are required; missing them causes AttributeError or silent failure.

fix

Always pass an EncodeConfig to PyNvEncoder and DecodeConfig to PyNvDecoder.

affects: all

Upgrade

Version history

2.1.0latest on PyPI · released Jan 30, 2026

Audit

Dependencies

cuda-pythonrequiredRequired for CUDA context management and memory transfers

numpyrequiredUsed for frame data arrays

Agent activity

12 hits · last 30 days

node

Resources

No resource links recorded.