conda 安装需把 换成 12.0+ 的具体版本号;PyPI 包按 CUDA 版本分开,装错 cucim-cu12/cu13 会不匹配;cuslide2 需手动设置 ENABLE_CUSLIDE2=1 才启用,且旧 cuslide 插件将在 26.04 起弃用;跑 notebook 需先用 Docker 下载示例图像。
cucim
rapidsaiApache-2.0活跃维护基于 CUDA 的 GPU 加速图像处理库,专为多维图像和数字病理、显微成像等大规模图像分析场景提速。
NVIDIA cuCIM - GPU-accelerated image processing library
conda create -n cucim -c rapidsai -c conda-forge cucim cuda-version=<CUDA version>
pip install cucim-cu12README 未说明具体显存要求;安装包按 CUDA 版本区分(CUDA 12 或 13),需 NVIDIA GPU 与对应 CUDA 环境。
NVIDIA 的 GPU 加速多维图像处理库,专为病理切片和遥感大图做 I/O 与运算提速
基于 CUDA 的 GPU 加速图像处理库,专为多维图像和数字病理、显微成像等大规模图像分析场景提速。
核心能力
- 用 GPU 加速图像处理与计算机视觉基础算子
- 支持读取 SVS、Philips TIFF 及多种压缩的多分辨率 TIFF
- 提供与 OpenSlide 对齐的 Pythonic API
- cuslide2 插件用 nvImageCodec 做 GPU TIFF 解码并支持瓦片缓存
- 支持异步批量解码与更广的格式覆盖
容易踩的坑
- v26.10.00最新正式版2026-10-07 · 2026-10-07 19:33 UTC
What's Changed
🐛 Bug Fixes
- XFail
TestStainExtractorMacenko::test_result_valueon CuPy 14.2.0 by @jakirkham in https://github.com/rapidsai/cucim/pull/1138 - Backport "Fix stain covariance centering with CuPy CUB" (#1142) by @jakirkham in https://github.com/rapidsai/cucim/pull/1154
- Add ImageCacheKey::lock_hash() so cache locking derives from the key by @cdinea in https://github.com/rapidsai/cucim/pull/1146
📖 Documentation
- Enable public docs features in CI by @bdice in https://github.com/rapidsai/cucim/pull/1140
🛠️ Improvements
- Forward-merge release/26.08 into main by @jakirkham in https://github.com/rapidsai/cucim/pull/1126
- ensure nightly builds always produce new packages by @jameslamb in https://github.com/rapidsai/cucim/pull/1127
- selectively skip CI jobs based on changed files, update pre-commit hooks by @jameslamb in https://github.com/rapidsai/cucim/pull/1131
- ci: avoid triggered-by-schedule and triggered-by-merge builds cancelling each other by @jameslamb in https://github.com/rapidsai/cucim/pull/1132
- ci: ensure pr-builder always runs by @jameslamb in https://github.com/rapidsai/cucim/pull/1133
- X-ORG-1134: Publish API docs to docs.nvidia.com by @josephine-wolf-oberholtzer in https://github.com/rapidsai/cucim/pull/1136
- Add new cucim.skimage.filters.rank module by @grlee77 in https://github.com/rapidsai/cucim/pull/1115
- Add ImageMetadata::store_string() and document why _GLIBCXX_USE_CXX11_ABI=0 by @cdinea in https://github.com/rapidsai/cucim/pull/1149
- Add GPU-resident tile cache for cuslide2 by @cdinea in https://github.com/rapidsai/cucim/pull/1145
- Verify the loaded nvImageCodec version at runtime, and consolidate nvimgcodec.cmake by @cdinea in https://github.com/rapidsai/cucim/pull/1148
- Add per-codec tile cache benchmark for cuslide2, fix raw TIFF recipe by @cdinea in https://github.com/rapidsai/cucim/pull/1143
- X-ORG-410: Integrate archived docs into version switcher by @josephine-wolf-oberholtzer in https://github.com/rapidsai/cucim/pull/1170
- Backport OpenJPEG encoder allocation overflow fix by @msarahan in https://github.com/rapidsai/cucim/pull/1173
Full Changelog: https://github.com/rapidsai/cucim/compare/v26.10.00a...v26.10.00
- XFail
- v26.08.002026-08-05 · 2026-08-05 17:53 UTC
查看更新说明
What's Changed
🚨 Breaking Changes
- Use static linkage for CUDA runtime by @bdice in https://github.com/rapidsai/cucim/pull/992
🐛 Bug Fixes
- Replace
shapeassignment withreshapecalls by @jakirkham in https://github.com/rapidsai/cucim/pull/1106 - add large image support to
cucim.skimage.measure.label(support 64-bit indexing) by @grlee77 in https://github.com/rapidsai/cucim/pull/1087
📖 Documentation
- Update docs to use NVIDIA Sphinx theme by @bdice in https://github.com/rapidsai/cucim/pull/1112
🛠️ Improvements
- Add SECURITY.md by @jameslamb in https://github.com/rapidsai/cucim/pull/1093
- fix(ci): fix configuration for breaking change notification workflow by @jameslamb in https://github.com/rapidsai/cucim/pull/1098
- refactor: switch to
rapids-artifact-namefor consistent artifact naming by @gforsyth in https://github.com/rapidsai/cucim/pull/1091 - Build and test with CUDA 13.3.0 by @bdice in https://github.com/rapidsai/cucim/pull/1102
- Use main shared-workflows branch by @bdice in https://github.com/rapidsai/cucim/pull/1103
- Update CuPy and NumPy dependency specs by @bdice in https://github.com/rapidsai/cucim/pull/1104
- fix(deps): preload
cusolverifcupyis installed by @gforsyth in https://github.com/rapidsai/cucim/pull/1117 regionprops_tableoutput placement and format by @grlee77 in https://github.com/rapidsai/cucim/pull/1088- cuslide2: add pyramidal OME-TIFF semantics and nvImageCodec 0.9 readiness by @cdinea in https://github.com/rapidsai/cucim/pull/1122
Full Changelog: https://github.com/rapidsai/cucim/compare/v26.08.00a...v26.08.00
- v26.06.002026-06-03 · 2026-06-03 18:16 UTC
查看更新说明
What's Changed
🚨 Breaking Changes
- Update cuCIM for consistency with scikit-image 0.26 by @grlee77 in https://github.com/rapidsai/cucim/pull/1038
- Upgrade nvImageCodec dependency from v0.7.0 to v0.8.0 by @cdinea in https://github.com/rapidsai/cucim/pull/1085
🛠️ Improvements
- Forward-merge release/26.04 into main by @jakirkham in https://github.com/rapidsai/cucim/pull/1053
- fix(conda): specify
python-gilfor conda recipe by @gforsyth in https://github.com/rapidsai/cucim/pull/1056 - chore: bump
codespellversion for Python 3.14+ compatibility by @gforsyth in https://github.com/rapidsai/cucim/pull/1062 - Use S3 for preprocessor cache by @trxcllnt in https://github.com/rapidsai/cucim/pull/1071
- Fixes for heap overflow by @cdinea in https://github.com/rapidsai/cucim/pull/1077
- fix(ci): resolve all zizmor findings and add zizmor pre-commit checks by @gforsyth in https://github.com/rapidsai/cucim/pull/1078
- Build and test with CUDA 13.2.0 by @bdice in https://github.com/rapidsai/cucim/pull/1080
- fix(ci): add explicit
actions: writepermission fortelemetry-summarizeby @gforsyth in https://github.com/rapidsai/cucim/pull/1081 - Add SECURITY.md by @jolorunyomi in https://github.com/rapidsai/cucim/pull/1082
- Require CMake 4.0 by @KyleFromNVIDIA in https://github.com/rapidsai/cucim/pull/1083
- vendor metadata hardening by @cdinea in https://github.com/rapidsai/cucim/pull/1079
- Optimize batch/multi-channel image interpolation (
cucim.skimage.transform.warpandcucim.skimage._vendored.ndimage) by @grlee77 in https://github.com/rapidsai/cucim/pull/1060 - morphology: add
h_maxima,h_minima,local_maxima,local_minima. improvereconstructby @grlee77 in https://github.com/rapidsai/cucim/pull/1061 - skip CuPy 14.1.0 by @jameslamb in https://github.com/rapidsai/cucim/pull/1096
- fix 'yum update' in nightly wheels tests by @jameslamb in https://github.com/rapidsai/cucim/pull/1099
New Contributors
- @trxcllnt made their first contribution in https://github.com/rapidsai/cucim/pull/1071
Full Changelog: https://github.com/rapidsai/cucim/compare/v26.06.00a...v26.06.00
- v26.04.002026-04-08 · 2026-04-08 15:26 UTC
查看更新说明
What's Changed
🚨 Breaking Changes
- async cuda stream batch decode by @cdinea in https://github.com/rapidsai/cucim/pull/1028
🐛 Bug Fixes
- make test_load_image_metadata test case insensitive to key order by @grlee77 in https://github.com/rapidsai/cucim/pull/1035
📖 Documentation
- remove references to 'nvidia' and 'pytorch' conda channels by @jameslamb in https://github.com/rapidsai/cucim/pull/1026
🛠️ Improvements
- Drop Python 3.10 support by @gforsyth in https://github.com/rapidsai/cucim/pull/1016
- tighten wheel size limits, enforce PEP 639 metadata, other small changes by @jameslamb in https://github.com/rapidsai/cucim/pull/1020
- Resolve forward-merge release/26.02 into main by @jakirkham in https://github.com/rapidsai/cucim/pull/1019
- remove pip.conf migration code in CI scripts by @jameslamb in https://github.com/rapidsai/cucim/pull/1023
- Use verify-hardcoded-version pre-commit hook by @KyleFromNVIDIA in https://github.com/rapidsai/cucim/pull/1022
- Drop CuPy pre-13.6.0 logic & fix CuPy 14 compatibility by @jakirkham in https://github.com/rapidsai/cucim/pull/1031
- add PR CI job checking that nightly tests are passing by @jameslamb in https://github.com/rapidsai/cucim/pull/1032
- Update cuCIM for consistency with scikit-image 0.26 (#1038) by @gforsyth in https://github.com/rapidsai/cucim/pull/1047
- Add support for Python 3.14 by @gforsyth in https://github.com/rapidsai/cucim/pull/1049
- Replace use of
pickle.loadin benchmark utility scripts by @grlee77 in https://github.com/rapidsai/cucim/pull/1041 - chore: reset
shared-workflowsbranch torelease/26.04by @gforsyth in https://github.com/rapidsai/cucim/pull/1052 - build wheels with CUDA 13.0.x, test wheels against mix of CTK versions by @jameslamb in https://github.com/rapidsai/cucim/pull/1054
- fix(conda): specify
python-gilfor conda recipe (#1056) by @gforsyth in https://github.com/rapidsai/cucim/pull/1058 - Add
cucim.skimage.restoration.rolling_ball(useful for background subtraction) by @grlee77 in https://github.com/rapidsai/cucim/pull/1040 - Update vendored interpolation kernels with precision fix by @grlee77 in https://github.com/rapidsai/cucim/pull/1055
- Caching for cuslide2 by @cdinea in https://github.com/rapidsai/cucim/pull/1034
Full Changelog: https://github.com/rapidsai/cucim/compare/v26.04.00a...v26.04.00
- v26.02.012026-03-04 · 2026-03-04 01:41 UTC
查看更新说明
What's Changed
🛠️ Improvements
- Backport "Drop CuPy pre-13.6.0 logic & fix CuPy 14 compatibility" to 26.02 by @jakirkham in https://github.com/rapidsai/cucim/pull/1036
- Backport "Drop CuPy pre-13.6.0 logic & fix CuPy 14 compatibility" to 26.02 by @jameslamb in https://github.com/rapidsai/cucim/pull/1037
Full Changelog: https://github.com/rapidsai/cucim/compare/v26.02.00...v26.02.01
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
NVIDIA cuCIM
NVIDIA cuCIM (pronounced "koo-sim", see here) is an open-source, accelerated computer vision and image processing software library for multidimensional images used in biomedical, geospatial, material and life science, and remote sensing use cases.
cuCIM offers:
- Enhanced Image Processing Capabilities for large and n-dimensional tag image file format (TIFF) files
- Accelerated performance through Graphics Processing Unit (GPU)-based image processing and computer vision primitives
- A Straightforward Pythonic Interface with Matching Application Programming Interface (API) for Openslide
cuCIM supports the following formats:
- Aperio ScanScope Virtual Slide (SVS)
- Philips TIFF
- Generic Tiled, Multi-resolution RGB TIFF files with the following compression schemes:
- No Compression
- JPEG
- JPEG2000
- Lempel-Ziv-Welch (LZW)
- Deflate
NOTE: For the latest stable README.md ensure you are on the main branch.
- GTC 2022 Accelerating Storage IO to GPUs with Magnum IO [S41347]
- cuCIM's GDS API examples: https://github.com/NVIDIA/MagnumIO/tree/main/gds/readers/cucim-gds
- SciPy 2021 cuCIM - A GPU image I/O and processing library
- GTC 2021 cuCIM: A GPU Image I/O and Processing Toolkit [S32194]
Blogs
- Enhanced Image Analysis with Multidimensional Image Processing
- Accelerating Scikit-Image API with cuCIM: n-Dimensional Image Processing and IO on GPUs
- Accelerating Digital Pathology Pipelines with NVIDIA Clara™ Deploy
Webinars
Release notes are available on our wiki page.
Install cuCIM
Conda
Conda (stable)
conda create -n cucim -c rapidsai -c conda-forge cucim cuda-version=`<CUDA version>`
<CUDA version> should be 12.0+ (e.g., 12.0, etc.)
Conda (nightlies)
conda create -n cucim -c rapidsai-nightly -c conda-forge cucim cuda-version=`<CUDA version>`
<CUDA version> should be 12.0+ (e.g., 12.0, etc.)
PyPI
Install for CUDA 12:
pip install cucim-cu12
Install for CUDA 13:
pip install cucim-cu13
Notebooks
Please check out our Welcome notebook (NBViewer)
Downloading sample images
To download images used in the notebooks, please execute the following commands from the repository root folder to copy sample input images into notebooks/input folder:
(You will need Docker installed in your system)
./run download_testdata
or
mkdir -p notebooks/input
tmp_id=$(docker create gigony/svs-testdata:little-big)
docker cp $tmp_id:/input notebooks
docker rm -v ${tmp_id}
cuslide2 Plugin
Deprecation Notice: Starting with 26.04, the original
cuslideplugin will be deprecated in favor ofcuslide2with removal ofcuslideplanned for 26.08.cuslide2uses nvImageCodec for GPU-accelerated TIFF decoding and adds tile-level caching, async batch decoding, and broader format support. Please plan to migrate existing workflows tocuslide2.
Enabling cuslide2
To enable the cuslide2 plugin, set the ENABLE_CUSLIDE2 environment variable:
ENABLE_CUSLIDE2=1 python your_script.py
Test Scripts
cuCIM provides test scripts to verify cuslide2 functionality with different TIFF formats:
Aperio SVS files:
# Download a sample SVS file and run the test
python scripts/test_aperio_svs.py --download
# Or test with your own SVS file
ENABLE_CUSLIDE2=1 python scripts/test_aperio_svs.py /path/to/your/file.svs
Philips TIFF files:
# Test with a Philips TIFF file
ENABLE_CUSLIDE2=1 python scripts/test_philips_tiff.py /path/to/your/philips.tiff
# List available test options
python scripts/test_philips_tiff.py --help
Build/Install from Source
See build instructions.
Contributing Guide
Contributions to cuCIM are more than welcome! Please review the CONTRIBUTING.md file for information on how to contribute code and issues to the project.
Acknowledgments
Without awesome third-party open source software, this project wouldn't exist.
Please find LICENSE-3rdparty.md to see which third-party open source software is used in this project.
License
Apache-2.0 License (see LICENSE file).
Copyright (c) 2020-2026, NVIDIA CORPORATION.