Adding getting started, and QAExample reward metadata match ds (#4)

Author: jamesbraza

README.md

@@ -30,7 +30,7 @@ ether0 is a reasoning language model post-trained through a loop of:
 4. SFT on the base model again to make a 'generalist' reasoning model.
 5. RLVR to recover any lost performance and push further in an all-task setting.
 
-![ether0 logo](docs/assets/training_info.png)
+![ether0 training info](docs/assets/training_info.png)
 
 ### Repo Structure
 
@@ -68,3 +68,63 @@ from datasets import load_dataset
 
 test_ds = load_dataset("futurehouse/ether0-benchmark", split="test")
 ```
+
+## Usage
+
+### Installation
+
+The easiest way to get started is a `pip install` from GitHub:
+
+```bash
+pip install git+https://github.com/Future-House/ether0.git
+```
+
+Or if you want the full set up, clone the repo and use `uv`:
+
+```bash
+git clone https://github.com/Future-House/ether0.git
+cd ether0
+uv sync
+```
+
+### Reward Functions
+
+Here is a basic example of how to use the reward functions:
+
+```python
+from ether0.rewards import valid_mol_eval
+
+# Task: provide a valid completion of this molecule
+partial_smiles = "O=C(OC1C(OC(=O)C=2C=CC=CC2)C3(O)C(C)(C)CCCC3(C)C4CC=5OC=CC5C(C)C14"
+
+# Here's two model-proposed SMILES completions
+invalid_completion_smiles = "CCC"
+valid_completion_smiles = ")C=6C=CC=CC6"
+
+# Evaluate the completions
+assert not valid_mol_eval(invalid_completion_smiles, partial_smiles)
+assert valid_mol_eval(valid_completion_smiles, partial_smiles)
+```
+
+### Visualization
+
+If it helps, you can visualize the molecules:
+
+```python
+from ether0.data import draw_molecule
+
+# See above reward functions demo for where these came from
+partial_smiles = "O=C(OC1C(OC(=O)C=2C=CC=CC2)C3(O)C(C)(C)CCCC3(C)C4CC=5OC=CC5C(C)C14"
+invalid_completion_smiles = "CCC"
+valid_completion_smiles = ")C=6C=CC=CC6"
+
+valid_mol_text = draw_molecule(partial_smiles + valid_completion_smiles)
+with open("valid_molecule.svg", "w") as f:
+    f.write(valid_mol_text)
+```
+
+The output of `draw_molecule` can also be easily visualized using `IPython.display`,
+or in your terminal via `chafa valid_molecule.svg`
+([chafa docs](https://hpjansson.org/chafa/)).
+
+![valid molecule](docs/assets/valid_molecule.svg)