diff --git a/README.md b/README.md
index c28ede4..3d3f686 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,38 @@
-# Ansible-x-Terraform
+#### 🚀 Project: Ansible x Terraform (Proxmox Automation)
 
-Combinaison Ansible Terraform
\ No newline at end of file
+Ce projet permet d'automatiser entièrement la création et la configuration d'infrastructure sur un hyperviseur Proxmox.
+
+L'objectif est de déployer un container LXC via Terraform, puis d'y installer des services (Docker, WordPress, etc.) avec Ansible.
+
+--- 
+
+### 🏗️ Architecture du Projet
+
+    Provisioning (Terraform) : Création du container LXC (CPU, RAM, Réseau) via l'API Proxmox.
+
+    Configuration (Ansible) : Installation des logiciels et sécurisation une fois la machine en ligne.
+
+---
+### 📂 Structure des Dossiers
+
+    terraform/ : Contient les fichiers .tf et le script de lancement run_terraform.sh.
+
+    ansible/ : Contient les playbooks (recettes) et l'inventaire des machines.
+
+    .gitignore : Empêche l'envoi des mots de passe et des secrets sur le serveur Git.
+
+---
+### 🛠️ Mode d'emploi rapide
+
+    Lancer l'infrastructure :
+    Allez dans terraform/ et lancez ./run_terraform.sh.
+
+    Lancer la configuration :
+    Allez dans ansible/ et lancez ansible-playbook -i inventory/inventory.ini playbook/sites.yml.
+---
+
+>👤 Auteur
+
+Maxime - Version 1.0
+
+---
\ No newline at end of file