diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f01f12f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# expression
+
+Another expression parser and executor
+Better version of https://github.com/neonxp/lexpr
+
+## usage
+
+```go
+import "go.neonxp.dev/expression"
+...
+e := expression.New()
+result, err := e.Eval(`2 + 2`) // 4, nil
+...
+```
+
+## defaults
+
+Default operators and functions: [/defaults.go](/defaults.go)