Implementing basic `--iree-execution-model=async-external` support.
Currently only coarse fences are supported: when the flag is specified
exported functions will take a wait and signal fence pair. Upon return to
a caller execution is not assumed to have completed and the caller can
either wait on the signal fence or chain further invocations with it.
Future invocation models will support specifying an arbitrary set of
fences that allow for up to per-I/O granularity (attention layers could
signal sooner than full decoders, etc) and specifying fences for in-place
buffers (wait until buffer is available to write in before filling).

This initial version is conservative and may include additional queue
barriers in order to signal the user-provided fence but future
improvements to timepoint elision and IPO will make that better. Nearly
all models we work with today end up becoming async with the current
heuristics.

iree-run-module/mlir has been updated to support programs compiled with
the async-external mode. iree-benchmark-module now supports pipelined
and concurrent execution via the --batch_size= and --batch_concurrency=
flags: batch_size defines how many invocations there are and
batch_concurrency defines how many of those are able to run concurrently.
Examples:
--batch_size=1 --batch_concurrency=1: default single-shot invocation
--batch_size=4 --batch_concurrency=1: 4 sequential invocations
--batch_size=4 --batch_concurrency=4: 4 concurrent invocations
--batch_size=4 --batch_concurrency=2: 2 concurrent sequences of 2 invocations
45 files changed
tree: 6038f3317f1ec66927490372889e595715b8c4a6
  1. .github/
  2. benchmarks/
  3. build_tools/
  4. compiler/
  5. docs/
  6. experimental/
  7. integrations/
  8. llvm-external-projects/
  9. runtime/
  10. samples/
  11. tests/
  12. third_party/
  13. tools/
  14. .bazelignore
  15. .bazelrc
  16. .bazelversion
  17. .clang-format
  18. .gitignore
  19. .gitmodules
  20. .pylintrc
  21. .style.yapf
  22. .yamllint.yml
  23. AUTHORS
  24. BUILD.bazel
  25. CITATION.cff
  26. CMakeLists.txt
  27. configure_bazel.py
  28. CONTRIBUTING.md
  29. LICENSE
  30. README.md
  31. WORKSPACE
README.md

IREE: Intermediate Representation Execution Environment

IREE (Intermediate Representation Execution Environment, pronounced as “eerie”) is an MLIR-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 for project details, user guides, and instructions on building from source.

CI Status

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

Related Project Channels

  • MLIR topic within LLVM Discourse: IREE is enabled by and heavily relies on MLIR. IREE sometimes is referred to in certain MLIR discussions. Useful if you are also interested in MLIR evolution.

Architecture Overview

IREE Architecture IREE Architecture

See our website for more information.

Presentations and Talks

  • 2021-06-09: IREE Runtime Design Tech Talk (recording and slides)
  • 2020-08-20: IREE CodeGen: MLIR Open Design Meeting Presentation (recording and slides)
  • 2020-03-18: Interactive HAL IR Walkthrough (recording)
  • 2020-01-31: End-to-end MLIR Workflow in IREE: MLIR Open Design Meeting Presentation (recording and slides)

License

IREE is licensed under the terms of the Apache 2.0 License with LLVM Exceptions. See LICENSE for more information.