diff --git a/README.md b/README.md
index e69de29..26959c6 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,16 @@
+# tea3-py
+
+## install
+
+```
+python -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## run tests
+
+```
+pip install pytest
+pytest
+```