diff --git a/doc/source/installation.rst b/doc/source/installation.rst index 2a09ff050..3ad348e09 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -336,3 +336,32 @@ that you've cloned the git repository. .. code-block:: bash python -m pytest -v python/ray/tests/test_mini.py + +Troubleshooting +--------------- + +If importing Ray (``python3 -c "import ray"``) in your development clone results +in this error: + +.. code-block:: python + + Traceback (most recent call last): + File "", line 1, in + File ".../ray/python/ray/__init__.py", line 63, in + import ray._raylet # noqa: E402 + File "python/ray/_raylet.pyx", line 98, in init ray._raylet + import ray.memory_monitor as memory_monitor + File ".../ray/python/ray/memory_monitor.py", line 9, in + import psutil # noqa E402 + File ".../ray/python/ray/thirdparty_files/psutil/__init__.py", line 159, in + from . import _psosx as _psplatform + File ".../ray/python/ray/thirdparty_files/psutil/_psosx.py", line 15, in + from . import _psutil_osx as cext + ImportError: cannot import name '_psutil_osx' from partially initialized module 'psutil' (most likely due to a circular import) (.../ray/python/ray/thirdparty_files/psutil/__init__.py) + +Then you should run the following commands: + +.. code-block:: bash + + rm -rf python/ray/thirdparty_files/ + python3 -m pip install setproctitle