From 3b05675cedc0aefbdbea2e252e3b556acbf838b7 Mon Sep 17 00:00:00 2001 From: alex-mccarthy-unity Date: Mon, 4 Mar 2024 16:20:29 +0100 Subject: [PATCH] Document grpcio installation for OS X Before installing `grpcio` on my Apple Silicon mac, running `mlagents-learn --help` threw the following error: ``` ImportError: dlopen(/Users/alex.mccarthy/miniconda3/envs/mlagents/lib/python3.10/site-packages/grpc/_cython/cygrpc.cpython-310-darwin.so, 0x0002): symbol not found in flat namespace '_CFRelease' ``` After installing `grpcio` (which I did from conda, rather than pip), `mlagents-learn --help` ran cleanly. --- docs/Installation.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/Installation.md b/docs/Installation.md index cefb84ad46..8f240ef134 100644 --- a/docs/Installation.md +++ b/docs/Installation.md @@ -157,6 +157,14 @@ Note that on Windows, you may also need Microsoft's if you don't have it already. See the [PyTorch installation guide](https://pytorch.org/get-started/locally/) for more installation options and versions. +#### (OS X) Installing GRPC libraries + +On OS X, you may need to explicitly install the GRPC runtime libraries to avoid hitting errors when training like `dlopen(/Users/alex.mccarthy/miniconda3/envs/mlagents/lib/python3.10/site-packages/grpc/_cython/cygrpc.cpython-310-darwin.so, 0x0002): symbol not found in flat namespace '_CFRelease'`. + +```sh +pip3 install grpcio +``` + #### Installing `mlagents` To install the `mlagents` Python package, activate your virtual environment and