Install & Compatibility
Where this runs
tested against v1.7.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.10
✕ dependency_conflict
1/2 runs
py 3.11
✕ dependency_conflict
1/2 runs
py 3.12
✕ dependency_conflict
✕ dependency_conflict
py 3.13
✕ dependency_conflict
✕ dependency_conflict
py 3.9
✕ dependency_conflict
1/2 runs
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
mmcv
✓ import mmcv
✗ from mmcv import *
Wildcard import pollutes namespace; not recommended
Basic usage: image I/O and transforms.
import mmcv
import numpy as np
from PIL import Image
# Load an image from file
img = mmcv.imread('path/to/image.jpg')
print('Image shape:', img.shape)
# Apply a filter (example: Gaussian blur)
blurred = mmcv.gaussian_blur(img, kernel_size=5)
# Resize image
resized = mmcv.imresize(img, (224, 224))
# Visualize or save
mmcv.imwrite(resized, 'resized.jpg')
Debug
Known issues
breakingmmcv-full v1.x and mmcv v2.x are not API compatible. mmcv-full v1.x uses `from mmcv.runner` etc. mmcv v2.x moved training modules to mmengine.fixFor new projects, use `mmcv` (v2.x) with `mmengine`. For existing code, stay on mmcv-full or upgrade with adaptation.
affects: mmcv-full==1.x vs mmcv>=2.0.0
gotchapip install mmcv-full may install a CPU-only build or fail due to missing CUDA support. Always verify the built wheel matches your torch version and CUDA.fixUse `pip install -U openmim && mim install mmcv-full` to auto-select correct wheel.
affects: all
deprecatedmmcv-full is deprecated for v2.x. New features and fixes are only on the unified `mmcv` package (v2.x).fixMigrate to `mmcv` (v2.x) + `mmengine` for new projects.
affects: >=2.0.0
Upgrade
Version history
1.7.2latest on PyPI · released Dec 29, 2023
Audit
Dependencies
torchrequiredRequired for all ops and tensor operations
mmengineoptionalRequired for training modules (Runner, Hook) ; optional for inference