diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9ed851c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# inspiro
+
+A tiny package for generating a link from https://inspirobot.me
+
+## Example
+
+```go
+package main
+
+import (
+    "fmt"
+
+    "go.etztech.xyz/inspiro"
+)
+
+func main() {
+    link, err := inspiro.Generate()
+    if err != nil {
+        panic(err)
+    }
+    
+    fmt.Println(link)
+}
+```
\ No newline at end of file