DeepCreamPy/docs/INSTALLATION.md

57 lines
2.0 KiB
Markdown
Raw Normal View History

2018-11-02 09:29:09 +00:00
# Installation
2018-11-02 09:22:11 +00:00
2018-11-02 09:29:09 +00:00
## Download Prebuilt Binaries
2018-11-02 09:22:11 +00:00
You can download the latest release [here](https://github.com/deeppomf/DeepCreamPy/releases/latest) or find all previous releases [here](https://github.com/deeppomf/DeepCreamPy/releases).
Binary only available for Windows 64-bit.
2018-11-02 09:29:09 +00:00
## Run Code Yourself
2019-08-07 08:17:57 +00:00
If you want to run the code yourself, you can clone this repo and download the model from https://drive.google.com/open?id=1YbN0iPS-RDJaCyyaBRJon-tMsFgrUNSH. Unzip the file into the /models/ folder.
2018-11-02 09:22:11 +00:00
2018-11-02 09:29:09 +00:00
### Dependencies (for running the code yourself)
2018-11-02 09:22:11 +00:00
- Python 3.6.7
2019-08-07 08:17:57 +00:00
- TensorFlow 1.14
2018-11-02 09:22:11 +00:00
- Keras 2.2.4
- Pillow
2019-08-07 08:17:57 +00:00
- Scipy
- OpenCV
2018-11-02 09:22:11 +00:00
No GPU required! Tested on Ubuntu 16.04 and Windows. Tensorflow on Windows is compatible with Python 3 and not Python 2. Tensorflow is not compatible with Python 3.7.
Tensorflow, Keras, Pillow, and h5py can all be installed by running in the command line
```
$ pip install -r requirements.txt
```
2018-11-04 10:34:13 +00:00
## Run Code Yourself on CPUs that don't support AVX instructions
2018-11-04 09:56:59 +00:00
2018-11-04 10:33:23 +00:00
CPUs that don't support AVX instructions may experience this error when using the above install instructions:
2018-11-02 09:22:11 +00:00
```
ModuleNotFoundError: No module named '_pywrap_tensorflow_internal'
```
2018-11-04 09:56:59 +00:00
2018-11-04 10:34:25 +00:00
Follow these alternate install instructions if that happens:
2018-11-04 10:32:00 +00:00
1. Start from a clean Python 3.6.7 install.
2018-11-06 18:53:39 +00:00
2. Download a version of tensorflow that does not support AVX instructions from (https://github.com/fo40225/tensorflow-windows-wheel/tree/master/1.10.0/py36/CPU/sse2). I assume you picked tensorflow-1.10.0-cp36-cp36m-win_amd64.whl for 64-bit and the other for 32-bit computers.
2018-11-04 10:32:00 +00:00
3. Open the command line in the same directory as the file downloaded in step 2. Run
```
pip install tensorflow-1.10.0-cp36-cp36m-win_amd64.whl
```
or
```
pip install tensorflow-1.10.0-cp36-cp36m-win32.whl
```
depending on what you installed in step 2.
2018-11-06 18:53:39 +00:00
2018-11-04 10:32:00 +00:00
4. Open the command line in the directory of "DeepCreamPy-master" and run
```
pip install -r requirements.txt
```
Instructions are from https://github.com/deeppomf/DeepCreamPy/issues/26#issuecomment-434043166.