Setup Guide for Mac OS X 10.12 or higher
16.0.1 Please discuss on telegram if there are any issues.
24 OCT 2018 - Build confirmed for Python 3.7 on OSX 10.13.6
16.2 Tested on MacOS High Sierra 10.13.6 , scroll down for Sierra version 10.12.6
16.3.1 Bring up a terminal
16.3.2 First, make sure you have the python3 version installed from https://python.org. This install will not work with default python v2
16.3.3 check to make sure that the python3 install is in your path by typing it at the command line to check.
$ python3
Python 3.7.0 (v3.7.0:1bf9cc5093, Jun 26 2018, 23:26:24)
[Clang 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>
16.3.4 Second, check the version of openssl and its location
$ openssl version -a
OpenSSL 1.0.2p 14 Aug 2018
16.3.5 if not installed you can install with the following commands
$ brew install openssl
$ cd /usr/local/include
$ ln -s ../opt/openssl/include/openssl .
16.3.6 check if the openssl version is now correct. If it is not correct, then you need to fix the path by adding to ~/.bash_profile
export PATH="/usr/local/opt/openssl/bin:$PATH"
16.4 If you have a lot of modifications to your OS, we suggest you build inside a virtual env.
16.4.1 To create one, make sure you create it in the directory above the source code:
$ gunzip DEXBot-0.7.9.tar.gz
$ tar -xvpf DEXBot-0.7.9.tar
$ ls
DEXBot-0.7.9
DEXBot-0.7.9.tar
$ python3 -m venv env
$ source env/bin/activate
(env)$ cd DEXBot-0.7.9
16.4.2 Want to know more about virtualenv? have a look here: https://realpython.com/python-virtual-environments-a-primer/
16.5 From Within the DEXbot directory, Copy and paste the following commands into the terminal one line at a time and press Enter. Don't copy the $-sign, as it just signifies that you run the command as a normal user - not superuser.
16.5.1 Be sure to add to your PATH: ~/Library/Python/3.6/bin/ , as this is where dexbot-gui and cli are installed
$ cd DEXBot-0.7.9
$ make check
$ pip install --upgrade pip (if needed)
$ git clone https://github.com/Codaone/DEXBot.git dexbot
$ cd dexbot
$ make install-user
$ dexbot-gui or dexbot-cli
16.5.2 If you get an error on make install-user and the error message says : TEST FAILED: /Users/<>/Library/Python/3.7/lib/python/site-packages/ does NOT support .pth files error: bad install directory or PYTHONPATH then you need to copy and paste into the command line:
$export PYTHONPATH=/Users/<<YOUR USERNAME>>/Library/Python/3.7/lib/python/site-packages/
16.5.3 Then check that the export is valid : Be sure to replace the above path with the one suggested by the installer
$ echo $PYTHONPATH
16.5.4 It should return something like: /Users/<>/Library/Python/3.7/lib/python/site-packages/
16.5.5 run $ make install-user again
16.6 If you just want the CLI version without graphics (which will work on more systems), instead of make install-user do pip3 install --user -e . (the dot included)
16.7.1 If you have problem building, there may be an environment issue. Perhaps you may want to consider using a virtual env. Here is what you need to do :
- 16.7.1.1 In the same top level directory as the downloaded source code if you get an Error on dexbot-gui startup: SSL: CERTIFICATE_VERIFY_FAILED with Python3:
16.7.1.1.1 Go to the folder where Python is installed, e.g., in my case it is installed in the Applications folder with the folder name 'Python 3.6'. Now double click on 'Install Certificates.command'. After that the error should be fixed.
- 16.8.1 https://stackoverflow.com/questions/38670295/homebrew-refusing-to-link-openssl
- 16.8.2 https://medium.com/@katopz/how-to-upgrade-openssl-8d005554401
- 16.8.3 https://stackoverflow.com/questions/35569042/ssl-certificate-verify-failed-with-python3#43855394
- 16.8.4 https://apple.stackexchange.com/questions/324107/uninstalled-openssl-with-homebrew-broke-everything
16.9.1 (Sierra with python version 3.6.3 with openssl 0.9.8zh 14 Jan 2016)
16.10.1 Bring up a terminal
16.10.2 First, make sure you have the python3 version installed from https://python.org. This install will not work with default python version 2
16.10.3 Copy and paste the following commands into the terminal one line at a time and press Enter. Don't copy the $-sign, as it just signifies that you run the command as a normal user - not superuser.
$ make check
$ pip install --upgrade pip (if needed)
$ git clone https://github.com/Codaone/DEXBot.git dexbot
$ cd dexbot
$ make install-user
16.11 If you just want the CLI version without graphics (which will work on more systems), instead of make install-user do pip3 install --user -e . (the dot included)