diff --git a/README.md b/README.md
new file mode 100644
index 0000000..afe6624
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# swissgeo
+This library uses the public apis geo.admin.ch and swisspost.opendatasoft.com to get geoinformations.
+## Features
+* find streetnames
+* find postcode by city name
+* find city by postcode
+* find canton by postcode
+* find canton by city
+* find cities nearby