Skip to content

Commit b409bd0

Browse files
committed
update instructions blender
1 parent c35ed08 commit b409bd0

File tree

1 file changed

+39
-0
lines changed

1 file changed

+39
-0
lines changed

docs/gettingstarted/blender.rst

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,11 @@ It is important that the version of Python installed in the ``conda`` environmen
1212
the version of Python that was originally shipped with Blender. For Blender 2.83 LTS
1313
the version of the bundled Python is 3.7, and for 2.93 LTS it is 3.9.
1414

15+
.. note::
16+
17+
On windows, the standard installation procedure recently stopped working.
18+
For an alternative procedure see `Installation on Windows`_.
19+
1520

1621
Installation
1722
============
@@ -178,3 +183,37 @@ Alternatively, you can create a new environment and simply install entire COMPAS
178183
conda activate blender
179184
pip install compas
180185
python -m compas_blender.install
186+
187+
188+
Installation on Windows
189+
=======================
190+
191+
On Windows, the procedure described above no longer works.
192+
However, an alternative procedure is still possible.
193+
Note that since this procedure is based on installing COMPAS directly using the `python` and `pip` executables shipped with Blender,
194+
it is limited to packages that can be installed from the Python Package Index (PyPI).
195+
196+
The basic command will install `compas` and `compas_blender` (and `compas_rhino` and `compas_ghpython`) for the default version of Blender (2.93),
197+
if that version can be found in the default installation location.
198+
199+
.. code-block:: bash
200+
201+
python -m compas_blender.install_windows
202+
203+
Install for a different version.
204+
205+
.. code-block:: bash
206+
207+
python -m compas_blender.install_windows -v 3.1
208+
209+
Install additional packages.
210+
211+
.. code-block:: bash
212+
213+
python -m compas_blender.install_windows -p compas_cloud
214+
215+
Install with `pip` configuration options.
216+
217+
.. code-block:: bash
218+
219+
python -m compas_blender.install_windows --force-reinstall --no-deps

0 commit comments

Comments
 (0)