diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3c744fb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Diffusion Model Playground
+
+This repo is a playground for implementing, training and visualising diffusion 
+models.
+
+![](./assets/sampling.gif)
+
+# Getting Started
+This tool uses the [poetry python manager](https://python-poetry.org/).
+To install the dependencies, simply run `poetry install`.
+
+