JulianSlzr commented on a change in pull request #9353: added mac gpu install;
refactored windows install
URL: https://github.com/apache/incubator-mxnet/pull/9353#discussion_r160801817
##########
File path: docs/install/index.md
##########
@@ -689,11 +689,50 @@ $ bash install-mxnet-osx-python.sh
<div class="python">
<div class="gpu">
-More details and verified installation instructions for macOS, with GPUs,
coming soon.
+<div class="pip virtualenv docker">
+</br>
+
+Try the **Build from Source** option for now.
+
+</div>
+
+<div class="build-from-source">
+
+The following instructions are for CUDA 9.1 and cuDNN 7 for MacOS X 10.12+ and
a CUDA-capable GPU. They summarize confirmed successful builds in
[#9217](https://github.com/apache/incubator-mxnet/issues/9217).
+Alternatively, you may follow the [CUDA installation instructions for Mac OS
X](https://docs.nvidia.com/cuda/cuda-installation-guide-mac-os-x/index.html).
+
+1. [Download Xcode 8.3.3 from
Apple](https://download.developer.apple.com/Developer_Tools/Xcode_8.3.3/Xcode8.3.3.xip).
This is the version [NVIDIA specifies in its instructions for Mac OS
X](https://docs.nvidia.com/cuda/cuda-installation-guide-mac-os-x/index.html).
Unzip and rename to `Xcode8.3.3.app`.
+
+2. Run `sudo xcode-select -s /Applications/Xcode8.3.3.app` or to wherever you
have placed Xcode.
+
+3. Run `xcode-select --install` to install all command line tools, compilers,
etc.
+
+4. Install CUDA for MacOS X. Specific steps are provided in NVIDIA's [CUDA
installation
instructions](https://docs.nvidia.com/cuda/cuda-installation-guide-mac-os-x/index.html#installation).
+
+5. Run `git clone --recursive https://github.com/apache/incubator-mxnet.git
mxnet` to get the latest version.
+
+6. Run `cd mxnet`.
+7. Edit the `make/osx.mk` file to set the following parameters:
-*MXNet* is expected to be compatible on macOS with NVIDIA GPUs. Please install
CUDA 9.0 and cuDNN 7, prior to installing GPU version of *MXNet*.
+ ```
+ USE_CUDA = 1
+ USE_CUDA_PATH = /usr/local/cuda
+ USE_CUDNN = 1
+ USE_OPENCV = 0
Review comment:
Users will probably be interested in using OpenCV (we don't even mention it
as optional in the Linux instructions). Mention that one could do this if one
has Homebrew, via `brew tap homebrew/science; brew install opencv`.
In general, the install won't go through unless you have `brew` or `port`
installed, along with dependencies like `numpy` (which most users on the issue
have implicitly done). I can confirm this on my own Mac+GPU install.
Really, the right thing to do would be to either:
1) Tell the user to edit the build script we have for Mac OS X > CPU > Build
from Source
2) Roll a modified build script that sets environment variables then calls
the build script above
3) Be very explicit about packages we need to install, which is what we do
for the Linux docs anyways. That is, go back to something like what we had in
the past (https://mxnet.incubator.apache.org/get_started/osx_setup.html)
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
