diff --git a/README.md b/README.md
index 1b0d386..4ef266f 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,41 @@
 # Python library for set class music theory
 
-A hopefully useful class for exploring set classes in music theory, of arbitrary tonalities (any
+A hopefully useful library for exploring set classes in music theory, of arbitrary tonalities (any
 number of equal divisions of the octave).
 
+
+## Run tests
+
+To download the code, and run the tests:
+
+```
+git clone https://git.jon.geek.nz/public/setclass
+cd setclass
+python -m virtualenv .venv
+source .venv/bin/activate
+pip install -r requirements-dev.txt
+tox
+```
+
+## Usage
+
+In Python:
+
+```python
+from setclass import SetClass
+sc = SetClass(0, 3, 5, 6, 7, 10, 11)  # Forte 7-20; pitch classes as integers 0-11
+sc.versions
+sc.brightest_form
+sc.darkest_form
+sc.duodecimal_notation  # SetClass[0,3,5,6,7,T,E]
+```
+
+Proper library documentation to come soon with Sphinx.
+
+
 ## TODO
 
+- Documentation (Sphinx)
 - Interoperate with music21 objects
 - Generate MIDI files
 - Generate LilyPond files for set pitches