diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4dbe9e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# SANEF Patch Manager v2
+
+Gestion du patching Linux via Excel + SSH + vSphere (PyQt/Tkinter + PyInstaller).
+
+## Prérequis
+- Python 3.11+ sur Windows
+- Accès réseau proxy SANEF : `http://proxy.sanef.fr:8080`
+
+## Installation des dépendances
+```
+py -m pip install -r requirements.txt --proxy http://proxy.sanef.fr:8080
+```
+
+## Exécution depuis les sources
+```
+py patch_manager_v2.py
+```
+
+## Build de l'exécutable (PyInstaller)
+```
+py -m PyInstaller patch_manager_v2.spec --clean --noconfirm
+```
+L'exe généré : `dist/SANEF_Patch_Manager.exe`
+
+## Archive packagée
+`dist/SANEF_Patch_Manager.7z` contient l'exe prêt à distribuer.
+
+## Fichiers
+- `patch_manager_v2.py` — code principal
+- `patch_manager_v2.spec` — config PyInstaller
+- `patch_manager_v2_backup_before_theme.py` — backup avant refonte thème
+- `requirements.txt` — dépendances Python
+- `build/`, `dist/` — artefacts PyInstaller (inclus dans le repo pour récup rapide)
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..49b1138
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,6 @@
+paramiko>=3.0
+openpyxl>=3.1
+requests>=2.31
+pyVmomi>=8.0
+ttkbootstrap>=1.10
+pyinstaller>=6.0