| # IREE: Intermediate Representation Execution Environment |
| |
| IREE (**I**ntermediate **R**epresentation **E**xecution **E**nvironment, |
| pronounced as "eerie") is an [MLIR](https://mlir.llvm.org/)-based end-to-end |
| compiler and runtime that lowers Machine Learning (ML) models to a unified IR |
| that scales up to meet the needs of the datacenter and down to satisfy the |
| constraints and special considerations of mobile and edge deployments. |
| |
| See [our website](https://google.github.io/iree/) for project details, user |
| guides, and instructions on building from source. |
| |
| #### Project Status |
| |
| IREE is still in its early phase. We have settled down on the overarching |
| infrastructure and are actively improving various software components as well as |
| project logistics. It is still quite far from ready for everyday use and is made |
| available without any support at the moment. With that said, we welcome any kind |
| of feedback on any [communication channels](#communication-channels)! |
| |
| ## Communication Channels |
| |
| * [GitHub issues](https://github.com/google/iree/issues): Feature requests, |
| bugs, and other work tracking |
| * [IREE Discord server](https://discord.gg/26P4xW4): Daily development |
| discussions with the core team and collaborators |
| * [iree-discuss email list](https://groups.google.com/forum/#!forum/iree-discuss): |
| Announcements, general and low-priority discussion |
| |
| #### Related Project Channels |
| |
| * [MLIR topic within LLVM Discourse](https://llvm.discourse.group/c/llvm-project/mlir/31): |
| IREE is enabled by and heavily relies on [MLIR](https://mlir.llvm.org). IREE |
| sometimes is referred to in certain MLIR discussions. Useful if you are also |
| interested in MLIR evolution. |
| |
| ## Build Status |
| |
| |
| CI System | Build System | Platform | Architecture | Configuration / Component | Status |
| :-------: | :-----------: | :--------: | :------------------: | :--------------------------: | :----: |
| Kokoro | Bazel | Linux | x86-64 | | [](https://storage.googleapis.com/iree-oss-build-badges/bazel/linux/x86-swiftshader/core/main_result.html) |
| Kokoro | CMake & Bazel | Linux | x86-64 (swiftshader) | Integrations | [](https://storage.googleapis.com/iree-oss-build-badges/cmake-bazel/linux/x86-swiftshader/main_result.html) |
| Kokoro | CMake & Bazel | Linux | x86-64 (turing) | Integrations | [](https://storage.googleapis.com/iree-oss-build-badges/cmake-bazel/linux/x86-turing/main_result.html) |
| Kokoro | CMake | Linux | x86-64 (swiftshader) | | [](https://storage.googleapis.com/iree-oss-build-badges/cmake/linux/x86-swiftshader/main_result.html) |
| Kokoro | CMake | Linux | x86-64 (swiftshader) | asan | [](https://storage.googleapis.com/iree-oss-build-badges/cmake/linux/x86-swiftshader-asan/main_result.html) |
| Kokoro | CMake | Linux | x86-64 (turing) | | [](https://storage.googleapis.com/iree-oss-build-badges/cmake/linux/x86-turing/main_result.html) |
| Kokoro | CMake | Android | arm64-v8a | Runtime (build only) | [](https://storage.googleapis.com/iree-oss-build-badges/cmake/android/arm64-v8a/main_result.html) |
| Kokoro | CMake | Bare Metal | risc-v-32 | Runtime | [](https://storage.googleapis.com/iree-oss-build-badges/cmake/baremetal/riscv32/main_result.html) |
| Kokoro | CMake | Linux | risc-v-64 | Runtime | [](https://storage.googleapis.com/iree-oss-build-badges/cmake/linux/riscv64/main_result.html) |
| Buildkite | CMake | Android | arm64-v8a | Runtime | [](https://buildkite.com/iree/iree-android-arm64-v8a) |
| BuildKite | CMake | Android | arm64-v8a | Runtime Benchmarks | [](https://buildkite.com/iree/iree-benchmark) |
| BuildKite | CMake | Linux | x86-64 | Tracing + Standalone Runtime | [](https://buildkite.com/iree/iree-build-configurations) |
| |
| ## Architecture Overview |
| |
|  |
| |
| See [our website](https://google.github.io/iree/) for more information. |
| |
| ## Presentations and Talks |
| |
| * 2021-06-09: IREE Runtime Design Tech Talk ([recording](https://drive.google.com/file/d/1p0DcysaIg8rC7ErKYEgutQkOJGPFCU3s/view) and [slides](https://drive.google.com/file/d/1ikgOdZxnMz1ExqwrAiuTY9exbe3yMWbB/view?usp=sharing)) |
| * 2020-08-20: IREE CodeGen: MLIR Open Design Meeting Presentation |
| ([recording](https://drive.google.com/file/d/1325zKXnNIXGw3cdWrDWJ1-bp952wvC6W/view?usp=sharing) |
| and |
| [slides](https://docs.google.com/presentation/d/1NetHjKAOYg49KixY5tELqFp6Zr2v8_ujGzWZ_3xvqC8/edit)) |
| * 2020-03-18: Interactive HAL IR Walkthrough |
| ([recording](https://drive.google.com/file/d/1_sWDgAPDfrGQZdxAapSA90AD1jVfhp-f/view?usp=sharing)) |
| * 2020-01-31: End-to-end MLIR Workflow in IREE: MLIR Open Design Meeting Presentation |
| ([recording](https://drive.google.com/open?id=1os9FaPodPI59uj7JJI3aXnTzkuttuVkR) |
| and |
| [slides](https://drive.google.com/open?id=1RCQ4ZPQFK9cVgu3IH1e5xbrBcqy7d_cEZ578j84OvYI)) |
| |
| ## License |
| |
| IREE is licensed under the terms of the Apache 2.0 License with LLVM Exceptions. |
| See [LICENSE](LICENSE) for more information. |