diff --git a/README.md b/README.md
new file mode 100644
index 0000000..dc2f910
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# py-gitea
+A very simple API client for Gitea
+
+This is just a quick translation of swagger doc to python using simple hack and has not been throughly tested.
+
+Its easy enough to understand for making changes and making it usable for purpose. 
+
+
+
+# Todo:
+Many things...
+- Validations 
+- Cleanup etc...