{"id":27191,"library":"nvidia-nvimgcodec-cu12","title":"NVIDIA nvImageCodec CUDA 12","description":"NVIDIA nvImageCodec provides accelerated image encoding and decoding using GPU hardware on CUDA 12 systems. Version 0.8.0.22 is the latest beta release, with a focus on JPEG, JPEG2000, and other formats. The library is under active development with beta releases every few months.","status":"active","version":"0.8.0.22","language":"python","source_language":"en","source_url":"https://github.com/NVIDIA/nvImageCodec","tags":["nvidia","image","codec","gpu","cuda","decoding","encoding"],"install":[{"cmd":"pip install nvidia-nvimgcodec-cu12","lang":"bash","label":"CUDA 12 variant"}],"dependencies":[{"reason":"Required runtime for CUDA 12.","package":"nvidia-cuda-runtime-cu12","optional":false},{"reason":"Required for GPU memory management and tensor conversion.","package":"cupy-cuda12x","optional":true}],"imports":[{"note":"","wrong":"","symbol":"nvimgcodec","correct":"import nvimgcodec"}],"quickstart":{"code":"import nvimgcodec\nimport numpy as np\n\n# Create encoder/decoder instance\ndecoder = nvimgcodec.Decoder()\n\n# Open an image file\nimg = decoder.read('example.jpg')\nprint(f\"Image shape: {img.shape}\")","lang":"python","description":"Load and decode an image using nvImageCodec."},"warnings":[{"fix":"Pin version and test upgrades.","message":"The package is beta (v0.8.0.22). API may change without notice in future releases.","severity":"deprecated","affected_versions":"all"},{"fix":"Use the appropriate CUDA variant package (e.g., nvidia-nvimgcodec-cu11 for CUDA 11).","message":"Only CUDA 12 is supported. Do not install on CUDA 11 systems or older.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'import nvimgcodec' instead of old 'import nvImageCodecs'.","message":"The library name changed from 'nvImageCodecs' to 'nvimgcodec' in v0.6.0. Import paths changed accordingly.","severity":"breaking","affected_versions":"<0.6.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Ensure you installed 'nvidia-nvimgcodec-cu12' for CUDA 12.","cause":"Installed the wrong CUDA variant or package not installed.","error":"ModuleNotFoundError: No module named 'nvimgcodec'"},{"fix":"Check GPU compatibility (CC >= 5.0 required for CUDA 12). Use a compatible GPU or downgrade to nvImageCodec for CUDA 11.","cause":"GPU compute capability is too old for the installed version.","error":"RuntimeError: CUDA error: no kernel image is available for execution on the device"},{"fix":"Update to v0.6.0+ and use 'nvimgcodec.Decoder'.","cause":"Using old API before v0.6.0 where classes had different names.","error":"AttributeError: module 'nvimgcodec' has no attribute 'Decoder'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}