| # 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 | |
| <!-- TODO(scotttodd): switch to <picture> once better supported? https://github.blog/changelog/2022-05-19-specify-theme-context-for-images-in-markdown-beta/ --> | |
|  | |
|  | |
| 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. |