Official Windows Support

Summary

This is the top-level tracking task for official Windows support. Native Windows support is in experimental status, meaning that the build interface, feature set, and timeline are subject to change.

Features

Support is planned for both the ahead of time (Python) and runtime on native Windows. The following are targeted for official support:

• Python Packages: Install the ExecuTorch python package through pip or install from source using install_executorch.bat.
• Runtime Build: Compile the C++ runtime for x86 and x84-64 using Clang-CL.
• Python Runtime Bindings: Run models from Python.
• Kernel Libraries: Build the portable, optimized, and quantized operator libraries.
• XNNPACK Backend: Build the XNNPACK (CPU) backend.

Disclaimers

• Building using MSVC is not supported. You'll need Clang-CL. See Clang/LLVM support in Visual Studio for installation instructions.
• Backends other than XNNPACK aren't officially supported on Windows (yet).
• Cross-compilation for Android from a Windows host isn't officially supported.

If these constraints are limiting for your use case, please file an issue or reach out on Discord. This workstream is driven by community requests and we will be happy to consider feature and pull requests.

Task List

• Enable core runtime and operator library build on Windows.
  • https://github.com/pytorch/executorch/pull/13700
  • https://github.com/pytorch/executorch/pull/13702
• Enable the XNNPACK backend on Windows.
  • https://github.com/pytorch/executorch/pull/13259
• Set up Windows CMake presets.
  • https://github.com/pytorch/executorch/pull/13257
• Support Windows in Tokenizers.
  • https://github.com/meta-pytorch/tokenizers/pull/121
  • https://github.com/pytorch/executorch/pull/13888
  • https://github.com/pytorch/executorch/pull/14180
• Run unit tests in CI on Windows.
  • https://github.com/pytorch/executorch/pull/13716
  • Run C++ unit tests in CI.
  • https://github.com/pytorch/executorch/issues/13883
• Run example model tests in CI on Windows.
  • https://github.com/pytorch/executorch/pull/13836
• Setup Windows wheel build jobs.
  • https://github.com/pytorch/executorch/pull/13837
• Update top-level and build from source documentation for Windows.

In addition to the above, there have been a number of community contributions that have laid the groundwork. The following list is not exhaustive, but covers a large chunk of the Windows contributions:

• @python3kgae
  • https://github.com/pytorch/executorch/pull/4748
  • https://github.com/pytorch/executorch/pull/4856
  • And many more...
• @SamGondelman
  • https://github.com/pytorch/executorch/pull/8912
  • https://github.com/pytorch/executorch/pull/8913
  • And many more...
• @ykhrustalev
  • https://github.com/pytorch/executorch/pull/13071

cc @larryliu0820 @jathu