diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7e3634a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Go Random
+
+Functions to create random values. That's about the size of it.
+
+## Example
+
+```go
+package main
+
+import (
+	"fmt"
+
+	"github.com/annybs/go/random"
+)
+
+func main() {
+	n := make([]bool, 10)
+	for i := range n {
+		fmt.Println(random.Str(4 + i))
+	}
+}
+```
+
+## License
+
+See [LICENSE.md](../LICENSE.md)