ROCm/MIVisionX
ROCm/MIVisionX has 218 GitHub stars and 94 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-15 14:15 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
AMD MIVisionX is a computer vision toolkit built around a highly optimized, conformant open-source implementation of the Khronos OpenVX™ 1.3.2 specification. As of the 4.0.0 release, MIVisionX ships three components: the AMD OpenVX™ engine, the AMD RPP OpenVX extension, and the RunVX graph executor — across CPU, HIP, and OpenCL backends.
Machine LearningREADME.md
Original
AMD MIVisionX is a computer vision toolkit built around a highly optimized, conformant open-source implementation of the Khronos OpenVX™ 1.3.2 specification. As of the 4.0.0 release, MIVisionX ships three components: the AMD OpenVX™ engine, the AMD RPP OpenVX extension, and the RunVX graph executor — across CPU, HIP, and OpenCL backends.
AMD OpenVX™ Extensions
The OpenVX framework provides a mechanism for vendors to add new vision functionality. MIVisionX ships the following extension on top of the AMD OpenVX™ core engine:
- amd_rpp: Interface to ROCm Performance Primitives (RPP) for image/tensor augmentation via rocAL
[!NOTE]
amd_rppsupports only theCPUandHIPbackends (RPP has dropped OpenCL support). When the core is built with theOpenCLbackend,amd_rppis built in CPU-only mode.
Utilities
- RunVX: Command-line utility to execute OpenVX graphs described in GDF text files
Applications
Sample applications built on AMD OpenVX™ and OpenCV (built separately against an installed MIVisionX):
- bubble_pop: Creates bubbles and donuts to pop using OpenVX & OpenCV
- optical_flow: Runs Optical Flow on a video/live stream using an OpenVX graph
Prerequisites
Hardware
- CPU: AMD64
- GPU: AMD Radeon™ Graphics / AMD Instinct™ Accelerators [optional]
- APU: AMD Radeon™ Mobile/Embedded [optional]
[!IMPORTANT] MIVisionX can be built for CPU only. For GPU acceleration via the
HIPorOpenCLbackend, an AMD GPU or APU is required.
Operating Systems
| Platform | Supported versions |
|---|---|
| Linux (Ubuntu) | 22.04 / 24.04 |
| Linux (RedHat) | 8 / 9 |
| Linux (SLES) | 15-SP7 |
| Windows | 10 / 11 |
| macOS | Ventura 13 / Sonoma 14 / Sequoia 15 |
Libraries
The ROCm Core SDK (ROCm 7.13 or later) provides everything MIVisionX needs to build: the HIP and OpenCL runtimes, the amdclang++ compiler, OpenMP, the half (float16) library, and RPP (3.1.0 or later). Additional dependencies:
| Package | Minimum Version | Notes |
|---|---|---|
| CMake | 3.10 |
install from your distribution's package manager |
| OpenCV | 3.X / 4.X |
optional — only used by RunVX for image/video display |
| OpenSSL / libcrypto | any | optional, Linux only — enables MD5 checksums in RunVX compare commands; a built-in fallback is used when absent (Windows uses wincrypt.h automatically) |
[!IMPORTANT]
- Required compiler support:
C++17,OpenMP,Threads- On
Ubuntu 22.04:sudo apt install libstdc++-12-dev
[!NOTE]
RPPis included with the ROCm Core SDK. On ROCm releases where it is packaged separately, install it from the ROCm repository (for exampleamdrpp7.13-*/rpp-dev). Refer to the ROCm install guide for exact package names.
Installation instructions
[!IMPORTANT] Choose your installation method based on your environment:
- ROCm
7.2.xor below — install the prebuilt packages (see package install).- ROCm
7.13or later — build from source on top of the ROCm Core SDK (see source install).- CPU-only — build from source with
-DGPU_SUPPORT=OFF; no ROCm or GPU required (see source install).
Linux
Install the ROCm Core SDK
Follow the ROCm install guide for your GPU and operating system. Verify your hardware is on the compatibility matrix before proceeding.
[!IMPORTANT] Use either package install or source install.
Package install
Available for ROCm 7.2.x and below. Installs runtime libraries, development headers, and a ctest verification module.
| Distro | Command |
|---|---|
| Ubuntu | sudo apt-get install mivisionx mivisionx-dev mivisionx-test |
| RedHat | sudo yum install mivisionx mivisionx-devel mivisionx-test |
| SLES | sudo zypper install mivisionx mivisionx-devel mivisionx-test |
[!IMPORTANT] Package install supports the
HIPbackend only. For theOpenCLbackend or ROCm7.13+, use the source install.
Source install
sudo apt install cmake # or equivalent for your distro
git clone https://github.com/ROCm/MIVisionX.git
cd MIVisionX
mkdir build-hip && cd build-hip
cmake ../ # HIP backend (default); use -DBACKEND=OCL for OpenCL, -DGPU_SUPPORT=OFF for CPU
make -j$(nproc)
sudo make install
[!NOTE] CPU-only build — no ROCm or GPU required:
mkdir build-cpu && cd build-cpu cmake ../ -DGPU_SUPPORT=OFF make -j$(nproc) sudo make install
Windows
- Windows SDK + a C++17 toolchain (Visual Studio 2019 or later)
- CMake
3.10or later - Latest AMD drivers
- OpenCL SDK (for the OpenCL backend)
The default Windows backend is OpenCL. Build with CMake from the command line or open the generated solution in Visual Studio:
git clone https://github.com/ROCm/MIVisionX.git
cd MIVisionX
# OpenCL backend (default — requires the OpenCL SDK)
cmake -B build
cmake --build build --config Release
# CPU-only (no GPU or OpenCL SDK required)
cmake -B build -DGPU_SUPPORT=OFF
cmake --build build --config Release
macOS
[!IMPORTANT] macOS supports the CPU backend only.
See the macOS build instructions wiki page.
Verify installation
Linux / macOS
The installer copies files to /opt/rocm:
| Path | Contents |
|---|---|
/opt/rocm/bin |
Executables (runvx) |
/opt/rocm/lib |
Libraries (libopenvx.so, libvxu.so, libvx_rpp.so) |
/opt/rocm/include/mivisionx |
Header files |
/opt/rocm/share/mivisionx |
Samples |
/opt/rocm/share/doc/mivisionx |
Documentation |
Canny Edge Detection sample:
export PATH=$PATH:/opt/rocm/bin
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/rocm/lib
runvx /opt/rocm/share/mivisionx/samples/gdf/canny.gdf
[!NOTE]
- More samples: samples/README.md
- macOS: use
export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/opt/rocm/lib
ctest verification (after installing the mivisionx-test package or building from source):
mkdir mivisionx-test && cd mivisionx-test
cmake /opt/rocm/share/mivisionx/test/
ctest -VV
Windows
Use RunVX to verify the build output. From the repo root:
.\build\bin\Release\runvx.exe samples\gdf\skintonedetect.gdf
Documentation
Build locally:
cd docs
pip3 install -r sphinx/requirements.txt
python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html
Doxygen API docs:
cd docs/doxygen && doxygen Doxyfile
Technical support
File a bug on GitHub issues or email [email protected].
Release notes
Review all notable changes with the latest release.
Tested configurations
| Component | Version |
|---|---|
| ROCm | 7.13 or later (ROCm Core SDK) |
| RPP | 3.1.0 |
| OpenCV | 4.5.4 / 4.6 (optional, RunVX display only) |