Search code examples
pythonmacospython-sphinx

OS X install of Sphinx: The 'sphinx-build' and 'sphinx-quickstart' not found

There have been several 'unanswered' postings on this topic pertaining finding 'sphinx-build' not being able to be found: sphinx-build -h command not found in Mac OS

Sphinx was installed upon OSX using both:

  • python3 -m pip install sphinx
  • brew install sphinx

In either case, both commands sphinx-build and sphinx-quickstart cannot be found.

Even though python3 -m pip freeze shows installation:

Sphinx==1.3.6

What am I missing?

Thx

Solution

  • I had a similar issue after installing sphinx on OS X El Capitan. I installed sphinx using pip: pip install sphinx --user. Despite the sphinx-build binary existing in ~/Library/Python/2.7/bin, the command could not be found.

    The issue was that I had path set to PATH="~/Library/Python/2.7/bin:$PATH". Replacing the tilde ~ with $HOME so that it was PATH="$HOME/Library/Python/2.7/bin:$PATH" fixed the problem for me.