Skip to content

Commit

Permalink
Document grpcio installation for OS X (#6067)
Browse files Browse the repository at this point in the history
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.
  • Loading branch information
alex-mccarthy-unity authored Mar 6, 2024
1 parent e322b61 commit 66f6b34
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions docs/Installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit 66f6b34

Please sign in to comment.