diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e7bc63c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# TAGGR
+taggr, short for Taggr is A Genuinely Great Resource is a tagging program made in zig
+# HOW TO
+just
+```bash
+git clone https://dario48.site/git/Dario48/taggr.git
+cd taggr
+zig build
+```
+this program is split in 2 parts
+- the library, in src/root.zig
+- the cli frontend, in src/main.zig
+one can use the library as a base for other programs to have alternative frontends
+
+# TODO
+- make it work
+- add C bindings