diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6cafac2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# the biblioteca carriônica repository
+
+## what is it?
+    these are the files of my personal library catalog (https://carriunix.tildeteam.org/bib/biblioteca.html).
+
+## copyleft
+   i can't see how these files whould be useful for someone, but they are here distribute under MIT license. See COPYING.txt.
+
+## author
+    carriunix (carriunix@tilde.team)
\ No newline at end of file