diff --git a/README.md b/README.md
new file mode 100644
index 0000000..241c0ca
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# doses
+Given an alcohol proof in percent, compute the number of alcohol doses in a volume
+or the volume for a number of doses.
+
+## Dev setup
+```shell
+pre-commit install
+```