diff --git a/docs/installation.rst b/docs/installation.rst index 2f26358..f3b900d 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -85,6 +85,33 @@ Which should return something similar to: ├── Face at 0x165e88218f0, Center(0.5, 1.0, 0.0) └── Face at 0x165eb21ee70, Center(0.5, 1.0, 3.0) +Special notes on Apple Silicon intalls +---------------------------------------------- + +Due to some dependencies not being available via pip, there is a bit of a hacky work around for Apple Silicon installs (M1 or M2 ARM64 architecture machines - if you aren't sure, try `uname -p` in a terminal and see if it returns arm). Specifically the cadquery-ocp dependency fails to resolve at install time. The error looks something like this: + +.. doctest:: + + └[~]> python3 -m pip install git+https://github.com/gumyr/build123d + Collecting git+https://github.com/gumyr/build123d + ... + INFO: pip is looking at multiple versions of build123d to determine which version is compatible with other requirements. This could take a while. + ERROR: Could not find a version that satisfies the requirement cadquery-ocp~=7.7.0a0 (from build123d) (from versions: none) + ERROR: No matching distribution found for cadquery-ocp~=7.7.0a0 + +A procedure for avoiding this issue is to install in a conda environment, which does have the missing dependency (substituting for the environment name you want to use for this install): + +.. doctest:: + + conda create -n python=3.10 + conda activate + conda install -c cadquery -c conda-forge cadquery=master + pip install --no-deps git+https://github.com/gumyr/build123d svgwrite svgpathtools anytree scipy + pip install --no-deps ocp_tessellate webcolors==1.12 numpy numpy-quaternion cachetools==5.2.0 + pip install --no-deps ocp_vscode requests orjson urllib3 certifi + +`You can track the issue here `_ + Adding a nicer GUI ----------------------------------------------