diff --git a/README.md b/README.md
index 728c1ae..ca3f88e 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,27 @@
-# DerekoVecs
+# DerekoVecs.jl
 
-[![Build Status](https://github.com/kupietz@ids-mannheim.de/DerekoVecs.jl/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/kupietz@ids-mannheim.de/DerekoVecs.jl/actions/workflows/CI.yml?query=branch%3Amain)
+Minimal Julia package to load and use [dereko2vec](https://korap.ids-mannheim.de/gerrit/plugins/gitiles/ids-kl/dereko2vec) language models.
+
+Currently, only paradigmatic analysis is supported.
+
+## Installation
+
+```Julia
+pkg> add "https://korap.ids-mannheim.de/gerrit/ids-kl/DerekoVecs.jl"
+```
+
+## Example Usage
+
+```Julia
+using DerekoVecs
+
+model = load("model.vecs")
+
+knn(model, "interessant", 10)
+
+cos_dist(model, "gut", "besser")
+```
+
+## License
+
+This packages is licensed under Apache 2.0