👻 IREE - Getting started - Building from Source (Windows)

🧾 Requirements

Install MSVC from Visual Studio or "Tools for Visual Studio" (https://visualstudio.microsoft.com/downloads/)
Install CMake (https://cmake.org/download/)
- Make sure to select add to Path
Install Ninja (https://ninja-build.org/)
- Place ninja.exe in "C:\Windows\System32"
Python 3.10 or earlier installed (https://www.python.org/downloads/)
Git installed (https://gitforwindows.org/)

🏗️ Building from Source (Windows)

Create Virtual Python Environment

Open a windows command prompt
Navigate to your preferred storage location
pip install virtualenv
python -m venv iree_env
.\iree_env\Scripts\activate
python -m pip install --upgrade pip
curl -O https://raw.githubusercontent.com/iree-org/iree/main/runtime/bindings/python/iree/runtime/build_requirements.txt
pip install -r build_requirements.txt

Enable Microsoft Visual Studio for Command Prompt

Run vcvarsall.bat

"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat" arch

Replace arch with one of the following options:

Clone Repo

git clone https://github.com/iree-org/iree.git
cd iree
git submodule update --init

Configure CMake (Vulkan GPUs)

cmake -GNinja -B ../iree-build/ -S . -DCMAKE_BUILD_TYPE=RelWithDebInfo -DIREE_BUILD_PYTHON_BINDINGS=ON -DIREE_BUILD_COMPILER=ON -DIREE_ENABLE_ASSERTIONS=ON -DIREE_HAL_DRIVER_VULKAN=ON -DIREE_TARGET_BACKEND_VULKAN_SPIRV=ON

Build

cmake --build ../iree-build/

🧪 Testing

Build test dependencies:

cmake --build ../iree-build --target iree-test-deps

Run all built tests through CTest:

ctest --test-dir ../iree-build/ --output-on-failure

Example Output:

Windows 11 / AMD x64 / AMD RX580 (Vulkan)

55% tests passed, 493 tests failed out of 1103
Total Test time (real) = 285.95 sec

🏗️ Building Python Bindings and Importers

cd ..
cd iree-build
cmake -GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DIREE_BUILD_PYTHON_BINDINGS=ON .
cmake --build .
set PYTHONPATH="$pwd\compiler-api\python_package;$pwd\bindings\python;%PYTHONPATH%"
python -c "import iree.compiler"
python -c "import iree.runtime"

averad/IREE-Getting_started-Building_from_Source_(Windows).md