diff --git a/README.md b/README.md
new file mode 100644
index 0000000..291cb96
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# HelloAsso Paheko Adapter
+
+[HelloAsso](https://www.helloasso.com/) <-> [Paheko](https://paheko.cloud/)
+
+The goal is to provide a way for organizations:
+- to import helloasso membership information and members into paheko
+
+And with some specifics features:
+- manage subscriptions and activities
+- implement helloasso custom fields mapping to paheko custom fields
+- avoid duplication
+
+Written in Rust.
+
+## Getting started
+
+Create a `.env` file from `.env.example` and fill in some secrets.
+
+Run the program `dotenv cargo run`