You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/users/install.md
+32Lines changed: 32 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,6 +27,38 @@
27
27
28
28
Please make sure that you download the [latest ShapeWorks binary release](https://github.com/SCIInstitute/ShapeWorks/releases/latest), or up-to-date development builds from the master branch for [Windows](https://github.com/SCIInstitute/ShapeWorks/releases/tag/dev-windows)*(remember these are in-progress development builds, not official releases).*
29
29
30
+
!!! warning "Windows 11: Smart App Control affects Python features"
31
+
On Windows 11, a security feature called **Smart App Control** will block
32
+
the Python libraries that ShapeWorks installs. **ShapeWorks Studio itself
33
+
will still run**, and you can use its grooming, optimization, and analysis
34
+
features normally. However, the following will not work until Smart App
35
+
Control is turned off:
36
+
37
+
- Python use cases (`python RunUseCase.py ...`)
38
+
- Jupyter notebook examples
39
+
- DeepSSM and other Python-based features inside Studio
40
+
41
+
If affected, you will see errors like:
42
+
43
+
*"ImportError: DLL load failed while importing vtkWebCore: An Application Control policy has blocked this file."*
44
+
45
+
This happens because ShapeWorks relies on common scientific Python
46
+
libraries (VTK, PyTorch, etc.) that are not digitally signed by Microsoft.
47
+
Smart App Control blocks unsigned files, even though they are safe.
48
+
Most other scientific Python tools (PyTorch, SciPy, OpenCV, ...) have the
49
+
same issue.
50
+
51
+
**To turn Smart App Control off:**
52
+
53
+
1. Click the **Start** button and type **Smart App Control**.
54
+
2. Click **Smart App Control settings**.
55
+
3. Select **Off**.
56
+
57
+
**Important:** Turning Smart App Control off is a one-way change. The only
58
+
way to turn it back on later is to reset Windows. If you are unsure
59
+
whether your computer has Smart App Control enabled, the
60
+
`install_shapeworks.bat` script will detect it and warn you.
0 commit comments