Update README.md with PythonMonkey installation and description

Author: wiwichips

README.md

@@ -1,20 +1,31 @@
 # PythonMonkey Examples
 
 ## What is PythonMonkey
-- TODO
+[PythonMonkey](https://pythonmonkey.io/) is a Python library for executing JavaScript in Python
+and executing Python in JavaScript. It uses [Mozilla's SpiderMonkey](https://firefox-source-docs.mozilla.org/js/index.html)
+JavaScript Engine and shares memory with Python for fast execution.
+
+Check out [PythonMonkey on GitHub](https://github.com/Distributive-Network/PythonMonkey#pythonmonkey)!
 
 ## Installation
 - requires Python 3.8 or higher
-`pip install pythonmonkey`
-- TODO fill this out when everything is ready
+```bash
+pip install pythonmonkey
+```
+
+## Running Examples
+- Run the examples via `python3`. Refer to the README.md files in each of the directories for more information.
 
 ## Examples:
 - `hello-world-eval.py`
   - A "Hello, World" which evaluates a string in JavaScript
+  - Run with `python3 hello-world-eval.py`
 - `function-call-eval.py`
   - Calling a JavaScript function in Python
+  - Run with `python3 function-call-eval.py`
 - `function-passing-eval.py`
   - Calling a Python function in a JavaScript function from Python
+  - Run with `python3 function-passing-eval.py`
 - `require-js-file-from-py/`
   - Loading a JavaScript module from Python
 - `require-py-file-from-js/`
@@ -25,4 +36,6 @@
   - Calling JavaScript code that uses NPM modules
 - `load-wasm-from-py/`
   - Loading a WebAssembly module in Python and calling WASM function
+- `promises/`
+  - Using JavaScript promises in Python