diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a21c588
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# GOnyxia-api
+
+WIP experiment to rewrite the [Onyxia API](https://github.com/inseefrlab/onyxia-api) currently written in spring-boot / Java in Go.  
+This experiment is still at early stage and may never succeed and be abandonned at any point.  
+Idea is to write it as much as possible as a drop-in replacement to the current Docker image.
\ No newline at end of file