diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ca2531e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# sachet
+
+sachet is a small file share server.
+
+## development
+
+To start sachet in development mode:
+
+Clone the repo.
+
+```
+git clone https://github.com/dogeystamp/sachet
+cd sachet
+```
+
+Create a venv with required dependencies:
+
+```
+python -m venv venv
+source venv/bin/activate
+python -m pip3 install -r requirements.txt
+```
+
+Start Flask in development mode:
+
+```
+flask --debug --app sachet.server run
+```
+
+### tests
+
+Tests are available with the following command:
+
+```
+pytest --cov --cov-report term-missing
+```