There are many Linux variants. This document provides project-specific requirements for setting up your environment and should be relatively translatable. It was written for a relatively recent, Debian-derived distribution. If you have issues on other systems, we accept issues or additions to the documentation.
Optional if you will only be using the CMake build for runtime deps.
Follow the
install instructions
and verify with: bazel --version.
If you are planning on using TensorFlow/Colab, make sure that the Bazel version you install is supported by TensorFlow. A .bazelversion file is also provided if you want to use Bazelisk to manage Bazel versions.
sudo apt install clang
Verify version with clang++ --version. We have verified with the following
versions:
- 6.0.1
Install python (note that if, on your distribution, python3 is the only option, you may be able to drop the "3").
sudo apt install python3 python3-pip
Verify python version with python3 -V. We have tested with >= 3.6. Some
optional integrations (such as TensorFlow/Python may have more stringent
requirements).
Install packages:
sudo pip3 install numpy
If using Colab, you may also want to install TensorFlow:
sudo pip3 install tf-nightlySome parts of the project link against the Vulkan SDK and require it be
installed on your system. If you are planning on building these, or see linker
errors about undefined references to vk symbols, download and install the
Vulkan SDK from https://vulkan.lunarg.com/, and check that the VULKAN_SDK
environment variable is set when you are building. You may find it useful to add
source [PATH TO VULKAN SDK]/setup-env.sh to your ~/.bashrc file to simplify
environment variable setup.
- Generate SSH Key:
ssh-keygen -t rsa -b 4096 -C "[email protected]" - Add
~/.ssh.id_rsa.pubkey to GitHub - Try a test connection
ssh [email protected]
git config --global user.name "MY NAME"
git config --global user.email "MY EMAIL"This assumes that we are cloning into $HOME/ireepub. Update accordingly for
your use.
Note that if you will be cloning frequently, it can be sped up significantly by
creating a reference repo and setting
IREE_CLONE_ARGS="--reference=/path/to/reference/repo". See
build_tools/scripts/populate_reference_repo.sh for further details.
IREE_CLONE_ARGS=""
mkdir -p $HOME/ireepub
cd $HOME/ireepub
git clone $IREE_CLONE_ARGS https://github.com/google/iree.git iree
cd iree
git submodule init
git submodule update $IREE_CLONE_ARGS --recursiveWe support both Bazel and CMake, however, the Bazel build covers more parts of the system (tests, integrations, bindings, etc) whereas (currently) CMake is maintained for the runtime components (which will be consumed by other projects). This section covers building with Bazel.
The following environment variables must be set.
export CXX=clang++
export CC=clang
export PYTHON_BIN="$(which python3)"You can create a user.bazelrc in the repository root with extra bazel configs
that may be useful. We usually have something like this (make sure to make
replacements as needed):
build --disk_cache=/REPLACE/WITH/CACHE/DIR
build:debug --compilation_mode=dbg --copt=-O2 --per_file_copt=iree@-O0 --strip=never
# Run all tests (as of Oct-23-2019, all tests build but some still fail in the
# OSS version).
bazel test -k iree/... test/... bindings/python/...
# Or build with optimizations disabled (just for IREE, not for deps) and
# debug symbols retained. This assumes you have an alias like above setup):
bazel test --config=debug bindings/python/...In general, build artifacts will be under the bazel-bin directory at the top
level.
The following environment variables must be set.
export CXX=clang++mkdir build && cd build
cmake -DIREE_BUILD_COMPILER=OFF -DIREE_BUILD_TESTS=ON -DIREE_BUILD_SAMPLES=OFF -DIREE_BUILD_DEBUGGER=OFF ..
cmake --build .