diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..7b750e1
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,24 @@
+# KorAP-E2E-Tests
+
+Perform basic end-to-end tests on a KorAP-Kalamar instance with a headless browser using [mocha](https://mochajs.org/), [puppeteer](https://github.com/puppeteer/puppeteer) and [chai](https://www.chaijs.com/).
+
+##  Install
+
+```bash
+npm install
+```
+## Run
+
+```bash
+npm test
+```
+
+defaults to:
+
+```bash
+KORAP_URL="http://localhost:64543" KORAP_LOGIN="user2" KORAP_PWD="password2"\
+ KORAP_QUERIES="npm test" KORAP_QUERIES='geht, [orth=geht & cmc/pos=VVFIN]'\
+ npm test
+```
+
+