diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7d2e402
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# PyAlibert
+
+Parses elegantly and precisely.
+
+## Description
+
+PyAlibert is a fully typed parser combinator library fully written in python strongly inspired by [parsy](https://github.com/python-parsy/parsy) and [chumsky](https://github.com/zesterer/chumsky).
+
+## Usage
+
+You might be interested by the example folder for demonstrations of the API.