Merge pull request totalgood#35 from totalgood/feature-requirements

Feature requirements

conda/environment.yml

@@ -19,11 +19,10 @@ dependencies:
   - pytest-cov
   - python-levenshtein>=0.12.0,<0.13.0
   - redis-py>=2.10.6
-  - scipy>=1.1.0
   - swig>=3.0.12
   - theano>=1.0.2
   # this will fail on windows:
   # - python-annoy>=1.9.5,<2.0.0
 
   - pip:
-    - -r ../requirements/requirements-base.txt
+    - -r ../requirements/requirements.txt

requirements.txt

@@ -1 +1 @@
--r requirements/requirements-3.6.txt
+-r requirements/requirements.txt

requirements/README-OS-specific-dependencies.md

@@ -0,0 +1,55 @@
+# OS-Specific Binary Dependencies
+
+## Ubuntu (apt)
+
+On newish Ubuntu OSes you need the python header files:
+
+```bash
+$ sudo apt-get install python-dev python3.5-dev python3-virtualenv python-pip build-essential gfortran
+```
+
+But python-igraph often requires the binary igraph package
+```bash
+$ sudo apt-get install python-igraph
+```
+
+# SpeechRecognizer requires PyAudio
+```bash
+$ sudo apt-get install install portaudio19-dev python-pyaudio
+```
+
+## Mac OSX (homebrew)
+
+On Mac OSX you need python3 and pip (brew installs the python-dev header files automatically?):
+```bash
+$ brew install python3
+```
+
+SpeechRecognizer requires PyAudio
+```bash
+$ brew install portaudio
+```
+
+Offline SpeechRecognizer requires pocketsphinx and swig
+```bash
+$ brew install cmu-pocketsphinx
+$ brew install swig
+```
+
+############################
+# scipy requires:
+#$ sudo apt-get install gfortran libopenblas-dev liblapack-dev python-scipy python-matplotlib python-numpy
+
+# matplotlib requires:
+#$ sudo apt-get install libpng12-dev libfreetype6-dev
+
+# matplotlib requires a backend (see matplotlibrc), tkagg is one option:
+#$ sudo apt-get install tcl-dev tk-dev python-tk python3-tk
+
+# pugnlp includes:
+# coverage>=4.3.4 nltk>=3.2.2 fuzzywuzzy>=0.15.0 python-slugify>=1.2.4 nlup>=0.5
+
+# optional packages:
+# boto==2.46
+# editdistance>=0.3.1
+