4/x: Add LoadBackendOptionsMap support to Module::load() by metascroy · Pull Request #17687 · pytorch/executorch

metascroy · 2026-02-25T00:49:02Z

Summary:
This diff exposes the LoadBackendOptionsMap API at the Module level, providing the user-facing interface for configuring backend options at model load time.

Key changes:

Added Module::load() overload accepting LoadBackendOptionsMap parameter
Options are forwarded through the executor layer to backend delegates
Backward compatible: existing load() calls continue to work without options

This completes the end-to-end user flow:

// Configure backend options
LoadOptionsBuilder coreml_opts;
coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU);

LoadBackendOptionsMap options;
options.set_options(coreml_opts);

// Load model with options
Module module(model_path);
module.load("forward", options);

Reviewed By: larryliu0820

Differential Revision: D92358607

pytorch-bot · 2026-02-25T00:49:07Z

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/17687

📄 Preview Python docs built from this PR

Note: Links to docs will display an error until the docs builds have been completed.

❌ 5 New Failures

As of commit bd530b3 with merge base 19de115 ():

NEW FAILURES - The following jobs have failed:

pull / test-samsung-models-linux / linux-job (gh)
RuntimeError: Command docker exec -t 1e6fc26b1d73122c29e632464f59c3f2c675347930c5c5ab8e9183b44e0b2c6b /exec failed with exit code 1
pull / test-samsung-quantmodels-linux / linux-job (gh)
RuntimeError: Command docker exec -t ef0c87cd596a8f470a965a244f16e5c03f63356d0c81b3380ed758d895c70bd9 /exec failed with exit code 1
pull / unittest-editable / macos / macos-job (gh)
backends/xnnpack/test/ops/test_conv2d.py::TestConv2d::test_fp16_conv2d
Test CUDA Builds / check-all-cuda-builds (gh)
Process completed with exit code 1.
Test CUDA Builds / test-executorch-cuda-build-12.6 / linux-job (gh)
RuntimeError: Command docker exec -t 7b526b43a97daaf875e11dde9cb0a5e9768f9dd7e7e5371b72d9096a65309637 /exec failed with exit code 1

This comment was automatically generated by Dr. CI and updates every 15 minutes.

meta-codesync · 2026-02-25T00:49:09Z

@metascroy has exported this pull request. If you are a Meta employee, you can view the originating Diff in D92358607.

larryliu0820

Review automatically exported from Phabricator review in Meta.

github-actions · 2026-02-25T00:49:48Z

This PR needs a `release notes:` label

If your change should be included in the release notes (i.e. would users of this library care about this change?), please use a label starting with release notes:. This helps us keep track and include your important work in the next release notes.

To add a label, you can comment to pytorchbot, for example
@pytorchbot label "release notes: none"

For more information, see
https://github.com/pytorch/pytorch/wiki/PyTorch-AutoLabel-Bot#why-categorize-for-release-notes-and-how-does-it-work.

Summary: This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: Pull Request resolved: pytorch#17687 This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: Pull Request resolved: pytorch#17687 This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: Pull Request resolved: pytorch#17687 This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: Pull Request resolved: pytorch#17687 This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

Summary: This diff exposes the `LoadBackendOptionsMap` API at the `Module` level, providing the user-facing interface for configuring backend options at model load time. Key changes: - Added `Module::load()` overload accepting `LoadBackendOptionsMap` parameter - Options are forwarded through the executor layer to backend delegates - Backward compatible: existing `load()` calls continue to work without options This completes the end-to-end user flow: ```cpp // Configure backend options LoadOptionsBuilder coreml_opts; coreml_opts.setComputeUnit(LoadOptionsBuilder::ComputeUnit::CPU_AND_GPU); LoadBackendOptionsMap options; options.set_options(coreml_opts); // Load model with options Module module(model_path); module.load("forward", options); ``` Reviewed By: larryliu0820 Differential Revision: D92358607

metascroy requested a review from shoumikhin as a code owner February 25, 2026 00:49

meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Feb 25, 2026

meta-codesync Bot added fb-exported meta-exported labels Feb 25, 2026

larryliu0820 approved these changes Feb 25, 2026

View reviewed changes

metascroy force-pushed the export-D92358607 branch from bac6930 to a3d9f72 Compare February 25, 2026 18:09

metascroy force-pushed the export-D92358607 branch from a3d9f72 to 867a1fd Compare February 25, 2026 18:13

metascroy force-pushed the export-D92358607 branch from 867a1fd to c3e3994 Compare February 25, 2026 23:10

metascroy force-pushed the export-D92358607 branch 2 times, most recently from 4a6df62 to e78661a Compare February 26, 2026 17:59

metascroy force-pushed the export-D92358607 branch from e78661a to 7af3852 Compare February 26, 2026 18:02

metascroy force-pushed the export-D92358607 branch from 7af3852 to c290017 Compare February 26, 2026 19:50

metascroy force-pushed the export-D92358607 branch from c290017 to 2beb57e Compare February 26, 2026 19:54

metascroy force-pushed the export-D92358607 branch from 2beb57e to bd530b3 Compare February 26, 2026 23:20

meta-codesync Bot merged commit 4528ae2 into pytorch:main Feb 27, 2026
158 of 164 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

4/x: Add LoadBackendOptionsMap support to Module::load()#17687

4/x: Add LoadBackendOptionsMap support to Module::load()#17687
meta-codesync[bot] merged 1 commit into
pytorch:mainfrom
metascroy:export-D92358607

metascroy commented Feb 25, 2026

Uh oh!

pytorch-bot Bot commented Feb 25, 2026 •

edited

Loading

Uh oh!

meta-codesync Bot commented Feb 25, 2026

Uh oh!

larryliu0820 left a comment

Uh oh!

github-actions Bot commented Feb 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

metascroy commented Feb 25, 2026

Uh oh!

pytorch-bot Bot commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/17687

❌ 5 New Failures

Uh oh!

meta-codesync Bot commented Feb 25, 2026

Uh oh!

larryliu0820 left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Feb 25, 2026

This PR needs a release notes: label

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

pytorch-bot Bot commented Feb 25, 2026 •

edited

Loading

This PR needs a `release notes:` label