diff --git a/modele-social/README.md b/modele-social/README.md
index e40933de5..23056b900 100644
--- a/modele-social/README.md
+++ b/modele-social/README.md
@@ -2,5 +2,26 @@
 
 Ce paquet contient les règles publicodes utilisées sur https://mon-entreprise.fr
 pour le calcul des cotisations sociales, des impôts et des droits sociaux.
+### Installation
+```
+npm install publicodes modele-social 
+```
 
-Pour voir des exemples d'utilisation rendez-vous sur https://mon-entreprise.fr/int%C3%A9gration/biblioth%C3%A8que-de-calcul
+### Exemple d'utilisation
+```js
+import Engine, { formatValue } from "publicodes";
+import rules from "modele-social";
+
+const engine = new Engine(rules);
+
+const net = engine
+  .setSituation({
+    "contrat salarié . rémunération . brut de base": "3000 €/mois",
+  })
+  .evaluate("contrat salarié . rémunération . net");
+
+console.log(formatValue(net));
+
+```
+
+[Voir le tutoriel complet](https://mon-entreprise.fr/int%C3%A9gration/biblioth%C3%A8que-de-calcul)