Add README.md and run.py

Author: JCGrant

README.md

@@ -0,0 +1,34 @@
+# Emojibot
+
+Emojibot can predict how the user feels, and responds with a relevant Emoji.
+
+![Emojibot prediciting the emotion of the user](resources/predicting-emotion.png)
+
+You can also tell Emojibot your favourite Emoji and he'll remember it for later!
+
+![Emojibot prediciting the emotion of the user](resources/setting-favourite.png)
+
+Most of the heavy lifting is done by [DeepMoji](https://github.com/bfelbo/DeepMoji) and an [intent matcher](https://github.com/JCGrant/emojibot/blob/master/app/matcher.py).
+
+The only endpoint the server exposes is a GET handler to "/transform?s=some sentence".
+
+## Running
+
+This code depends on Python2, mostly because that's what DeepMoji uses.
+
+    git clone [email protected]:JCGrant/emojibot.git
+    cd emojibot
+    pip install -r requirements.txt
+    pushd client
+    npm run build
+    popd
+
+    FLASK_APP=app flask run
+
+Or, if you don't have Python binaries in your PATH:
+
+    python run.py
+
+## Testing
+
+    pytest tests.py -v

resources/predicting-emotion.png

@@ -0,0 +1,4 @@
+from app import app
+
+if __name__ == '__main__':
+    app.run(debug=False, host='0.0.0.0')