diff --git a/src/bonsai/bonsai/__init__.py b/src/bonsai/bonsai/__init__.py index 54c17a1c6c..be5b497145 100644 --- a/src/bonsai/bonsai/__init__.py +++ b/src/bonsai/bonsai/__init__.py @@ -317,7 +317,7 @@ if IN_BLENDER: # But Blender currently doesn't support separate builds for different Python version, # so those issues might still slip in. box.label(text="Bonsai installed for wrong Python version.") - box.label(text=f"Expected: {py}. Got: {binary_py}.") + box.label(text=f"Expected binary version: {py}. Got: {binary_py}.") # On reinstallation, dependencies versions doesn't change, so Blender will just ignore new dependencies. # So, we need to make user will disable an extension (just uninstallation won't remove dependencies). # Blender restart doesn't seem to be required in that case @@ -325,7 +325,13 @@ if IN_BLENDER: box.label(text="Try reinstalling with the correct Python version.") box.label(text="Before reinstallation make sure to") box.label(text="DISABLE Bonsai (uninstallation won't help).") - box.label(text="You can download correct version below.") + if py == "3.11": + box.label(text="You can download correct version below.") + else: + box.label(text="Since you're using Python >3.11,") + box.label(text="installation from Blender extensions platform") + box.label(text="is not supported and you need to download") + box.label(text="and install Bonsai from the link below.") layout.operator("bim.copy_debug_information", text="Copy Error Message To Clipboard") op = layout.operator("bim.open_uri", text="How Can I Fix This?") diff --git a/src/bonsai/docs/guides/troubleshooting.rst b/src/bonsai/docs/guides/troubleshooting.rst index 882ccecb4f..72b33691fd 100644 --- a/src/bonsai/docs/guides/troubleshooting.rst +++ b/src/bonsai/docs/guides/troubleshooting.rst @@ -80,6 +80,17 @@ can `report a bug `_ or distro's package repositories, then you may be missing some modules like ``numpy``. Try installing it manually like ``apt install python-numpy``. +4. **I get an error saying "Bonsai installed for wrong Python version."**" + + If you have Python >=3.12 then installation from the Blender extensions platform + is not supported and you need to download and install Python 3.12 build from + `Github Releases `__. + + If you have Python 3.11, then you probably downloaded build for wrong Python + version by accident. To fix it uninstall it and download Python 3.11 build + from `Github Releases `__ + or from Blender extensions platform. + Saving and loading blend files ------------------------------