Skip to content

Commit da0495f

Browse files
authored
Merge pull request #23 from ibelem/OS-2024H
Update WebNN Windows ML and LiteRT installation
2 parents 51741f2 + 909800e commit da0495f

File tree

2 files changed

+32
-124
lines changed

2 files changed

+32
-124
lines changed

content/en/learn/get-started/installation.mdx

Lines changed: 16 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -5,84 +5,38 @@ import InfoIcon from '../../../../app/_components/icons/info.jsx'
55

66
> <InfoIcon /> To use WebNN before the [Origin Trial](https://developer.chrome.com/docs/web-platform/origin-trials) milestone, complete these setup requirements.
77
8-
- Window 11, version 21H2 or newer
9-
- It's recommended to install the latest [Intel® Arc™ & Iris® Xe Graphics on Windows](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html)
10-
- It's recommended to install the latest [Intel® Core™ Ultra NPU Driver on Windows](https://www.intel.com/content/www/us/en/download/794734/intel-npu-driver-windows.html)
8+
Windows OS:
9+
- It's recommended to install the latest [Intel® Arc™ & Iris® Xe Graphics](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html)
10+
- It's recommended to install the latest [Intel® Core™ Ultra NPU Driver](https://www.intel.com/content/www/us/en/download/794734/intel-npu-driver-windows.html)
1111

1212
## Enabling WebNN
1313

1414
<Steps>
15-
### Download and install the latest [Chrome Canary](https://google.com/chrome/canary) or [Edge Canary](https://www.microsoft.com/en-us/edge/download/insider?form=MA13FJ)
15+
### Install the latest [Chrome Canary](https://google.com/chrome/canary) or [Edge Canary](https://www.microsoft.com/en-us/edge/download/insider?form=MA13FJ)
1616
### Navigate to `about://flags` in browser address bar
1717
### Search for `Enables WebNN API` and change it to `Enabled`
1818
### Exit browser
1919
</Steps>
2020

21-
## Running WebNN on Windows ML backend 🚧 (CPU, GPU and NPU)
21+
## Running WebNN on Windows ML backend (CPU, GPU and NPU)
22+
23+
> <InfoIcon /> Window 11, version 24H2 or newer
2224
2325
<Steps>
2426
### Install [Windows ML Runtime](https://apps.microsoft.com/detail/9mvl55dvgwww) from Microsoft Store
2527
### Install [Windows ML Runtime Intel OpenVINO Execution Provider](https://apps.microsoft.com/detail/9ph4ckr43xlp) from Microsoft Store
2628
### Navigate to `about://flags` in browser address bar
2729
### Search for `ONNX Runtime backend for WebNN` and change it to `Enabled`
28-
### Exit browser
30+
### Relaunch browser
2931
</Steps>
3032

31-
#### Launch Chrome Canary or Edge Canary
32-
33-
```bash copy showLineNumbers filename="launch-chrome-canary"
34-
"%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe"
35-
```
36-
37-
```bash copy showLineNumbers filename="launch-edge-canary"
38-
"%LOCALAPPDATA%\Microsoft\Edge SxS\Application\msedge.exe"
39-
```
40-
41-
## Running WebNN on DirectML backend
42-
43-
### GPU
44-
45-
#### Launch Chrome Canary or Edge Canary
46-
47-
```bash copy showLineNumbers filename="launch-chrome-canary"
48-
"%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe"
49-
```
50-
51-
```bash copy showLineNumbers filename="launch-edge-canary"
52-
"%LOCALAPPDATA%\Microsoft\Edge SxS\Application\msedge.exe"
53-
```
54-
55-
### NPU
33+
## Running WebNN on LiteRT backend (CPU and GPU)
5634

57-
- Window 11, version 24H2 or newer
58-
- It's recommended to install the [Intel® Core™ Ultra NPU Driver 32.0.100.3717 on Windows](https://www.intel.com/content/www/us/en/download/794734/848729/intel-npu-driver-windows.html) for improved WebNN compatibility and performance
59-
- Prepare the `DirectML.dll`. Download the latest redistributable [Microsoft.AI.DirectML](https://www.nuget.org/packages/Microsoft.AI.DirectML/1.15.2), rename `microsoft.ai.directml.[version].nupkg` to `microsoft.ai.directml.[version].nupkg.zip` and extract it
35+
> <InfoIcon /> Windows 11, Windows 10 and Linux
6036
61-
#### Chrome Canary
62-
63-
##### Put the `DirectML.dll` into correct path
64-
65-
Copy `\bin\x64-win\DirectML.dll` to `%LOCALAPPDATA%\Google\Chrome SxS\Application\[version]\`
66-
- `%LOCALAPPDATA%` means `C:\Users\<username>\AppData\Local\`
67-
- Note that Chrome Canary frequently updates automatically. When this occurs, recopy the `DirectML.dll` to the new version's directory.
68-
##### Launch Chrome Canary in Windows Command Line
69-
70-
```bash copy showLineNumbers filename="enable-webnn-npu-chrome-canary"
71-
"%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe" --use-redist-dml --disable_webnn_for_npu=0
72-
```
73-
74-
#### Edge Canary
75-
76-
##### Put the `DirectML.dll` into correct path
77-
78-
Copy `\bin\x64-win\DirectML.dll` to `%LOCALAPPDATA%\Microsoft\Edge SxS\Application\[version]\`
79-
- `%LOCALAPPDATA%` means `C:\Users\<username>\AppData\Local\`
80-
- Note that Edge Canary frequently updates automatically. When this occurs, recopy the `DirectML.dll` to the new version's directory.
81-
82-
##### Launch Edge Canary in Windows Command Line
83-
84-
```bash copy showLineNumbers filename="enable-webnn-npu-edge-canary"
85-
"%LOCALAPPDATA%\Microsoft\Edge SxS\Application\msedge.exe" --disable_webnn_for_npu=0
86-
```
87-
88-
Test your WebNN API installation at [Playground - Hello WebNN](../../playground/webnn/hello-webnn).
37+
<Steps>
38+
### Navigate to `about://flags` in browser address bar
39+
### Search for `ONNX Runtime backend for WebNN` and change it to `Disabled`
40+
### Search for `DirectML backend for WebNN` and change it to `Disabled`
41+
### Relaunch browser
42+
</Steps>

content/zh/learn/get-started/installation.mdx

Lines changed: 16 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -5,84 +5,38 @@ import InfoIcon from '../../../../app/_components/icons/info.jsx'
55

66
> <InfoIcon /> To use WebNN before the [Origin Trial](https://developer.chrome.com/docs/web-platform/origin-trials) milestone, complete these setup requirements.
77
8-
- Window 11, version 21H2 or newer
9-
- It's recommended to install the latest [Intel® Arc™ & Iris® Xe Graphics on Windows](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html)
10-
- It's recommended to install the latest [Intel® Core™ Ultra NPU Driver on Windows](https://www.intel.com/content/www/us/en/download/794734/intel-npu-driver-windows.html)
8+
Windows OS:
9+
- It's recommended to install the latest [Intel® Arc™ & Iris® Xe Graphics](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html)
10+
- It's recommended to install the latest [Intel® Core™ Ultra NPU Driver](https://www.intel.com/content/www/us/en/download/794734/intel-npu-driver-windows.html)
1111

1212
## Enabling WebNN
1313

1414
<Steps>
15-
### Download and install the latest [Chrome Canary](https://google.com/chrome/canary) or [Edge Canary](https://www.microsoft.com/en-us/edge/download/insider?form=MA13FJ)
15+
### Install the latest [Chrome Canary](https://google.com/chrome/canary) or [Edge Canary](https://www.microsoft.com/en-us/edge/download/insider?form=MA13FJ)
1616
### Navigate to `about://flags` in browser address bar
1717
### Search for `Enables WebNN API` and change it to `Enabled`
1818
### Exit browser
1919
</Steps>
2020

21-
## Running WebNN on Windows ML backend 🚧 (CPU, GPU and NPU)
21+
## Running WebNN on Windows ML backend (CPU, GPU and NPU)
22+
23+
> <InfoIcon /> Window 11, version 24H2 or newer
2224
2325
<Steps>
2426
### Install [Windows ML Runtime](https://apps.microsoft.com/detail/9mvl55dvgwww) from Microsoft Store
2527
### Install [Windows ML Runtime Intel OpenVINO Execution Provider](https://apps.microsoft.com/detail/9ph4ckr43xlp) from Microsoft Store
2628
### Navigate to `about://flags` in browser address bar
2729
### Search for `ONNX Runtime backend for WebNN` and change it to `Enabled`
28-
### Exit browser
30+
### Relaunch browser
2931
</Steps>
3032

31-
#### Launch Chrome Canary or Edge Canary
32-
33-
```bash copy showLineNumbers filename="launch-chrome-canary"
34-
"%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe"
35-
```
36-
37-
```bash copy showLineNumbers filename="launch-edge-canary"
38-
"%LOCALAPPDATA%\Microsoft\Edge SxS\Application\msedge.exe"
39-
```
40-
41-
## Running WebNN on DirectML backend
42-
43-
### GPU
44-
45-
#### Launch Chrome Canary or Edge Canary
46-
47-
```bash copy showLineNumbers filename="launch-chrome-canary"
48-
"%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe"
49-
```
50-
51-
```bash copy showLineNumbers filename="launch-edge-canary"
52-
"%LOCALAPPDATA%\Microsoft\Edge SxS\Application\msedge.exe"
53-
```
54-
55-
### NPU
33+
## Running WebNN on LiteRT backend (CPU and GPU)
5634

57-
- Window 11, version 24H2 or newer
58-
- It's recommended to install the [Intel® Core™ Ultra NPU Driver 32.0.100.3717 on Windows](https://www.intel.com/content/www/us/en/download/794734/848729/intel-npu-driver-windows.html) for improved WebNN compatibility and performance
59-
- Prepare the `DirectML.dll`. Download the latest redistributable [Microsoft.AI.DirectML](https://www.nuget.org/packages/Microsoft.AI.DirectML/1.15.2), rename `microsoft.ai.directml.[version].nupkg` to `microsoft.ai.directml.[version].nupkg.zip` and extract it
35+
> <InfoIcon /> Windows 11, Windows 10 and Linux
6036
61-
#### Chrome Canary
62-
63-
##### Put the `DirectML.dll` into correct path
64-
65-
Copy `\bin\x64-win\DirectML.dll` to `%LOCALAPPDATA%\Google\Chrome SxS\Application\[version]\`
66-
- `%LOCALAPPDATA%` means `C:\Users\<username>\AppData\Local\`
67-
- Note that Chrome Canary frequently updates automatically. When this occurs, recopy the `DirectML.dll` to the new version's directory.
68-
##### Launch Chrome Canary in Windows Command Line
69-
70-
```bash copy showLineNumbers filename="enable-webnn-npu-chrome-canary"
71-
"%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe" --use-redist-dml --disable_webnn_for_npu=0
72-
```
73-
74-
#### Edge Canary
75-
76-
##### Put the `DirectML.dll` into correct path
77-
78-
Copy `\bin\x64-win\DirectML.dll` to `%LOCALAPPDATA%\Microsoft\Edge SxS\Application\[version]\`
79-
- `%LOCALAPPDATA%` means `C:\Users\<username>\AppData\Local\`
80-
- Note that Edge Canary frequently updates automatically. When this occurs, recopy the `DirectML.dll` to the new version's directory.
81-
82-
##### Launch Edge Canary in Windows Command Line
83-
84-
```bash copy showLineNumbers filename="enable-webnn-npu-edge-canary"
85-
"%LOCALAPPDATA%\Microsoft\Edge SxS\Application\msedge.exe" --disable_webnn_for_npu=0
86-
```
87-
88-
Test your WebNN API installation at [Playground - Hello WebNN](../../playground/webnn/hello-webnn).
37+
<Steps>
38+
### Navigate to `about://flags` in browser address bar
39+
### Search for `ONNX Runtime backend for WebNN` and change it to `Disabled`
40+
### Search for `DirectML backend for WebNN` and change it to `Disabled`
41+
### Relaunch browser
42+
</Steps>

0 commit comments

Comments
 (0)