Skip to content

Commit 66f6b34

Browse files
Document grpcio installation for OS X (#6067)
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.
1 parent e322b61 commit 66f6b34

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/Installation.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,14 @@ Note that on Windows, you may also need Microsoft's
157157
if you don't have it already. See the [PyTorch installation guide](https://pytorch.org/get-started/locally/)
158158
for more installation options and versions.
159159

160+
#### (OS X) Installing GRPC libraries
161+
162+
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'`.
163+
164+
```sh
165+
pip3 install grpcio
166+
```
167+
160168
#### Installing `mlagents`
161169

162170
To install the `mlagents` Python package, activate your virtual environment and

0 commit comments

Comments
 (0)