diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..d9729f7
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,51 @@
+# 🎰 Console Blackjack (Python Edition)
+
+![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=for-the-badge&logo=python&logoColor=white)
+![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
+![Maintained](https://img.shields.io/badge/Maintained-Yes-orange?style=for-the-badge)
+
+Une version élégante et entièrement jouable du **Blackjack (21)** dans le terminal.
+Ce projet se distingue par son moteur de rendu **ASCII Art** qui affiche les cartes graphiquement (avec couleurs) plutôt que sous forme de texte simple.
+
+---
+
+## ✨ Fonctionnalités
+
+- **🃏 Rendu Visuel :** Les cartes s'affichent côte à côte avec des symboles (♠ ♥ ♦ ♣).
+- **🎨 Couleurs ANSI :** Gestion automatique des couleurs (Rouge pour ♥/♦, Blanc pour ♠/♣).
+- **💰 Système de Paris :** Gérez votre portefeuille (Bankroll). Vous pouvez tout gagner... ou tout perdre.
+- **🧠 IA du Croupier :** Le croupier respecte la règle stricte du casino (tire jusqu'à 17).
+- **⚡ Règles Avancées :** Comprend le **Double Down** (Doubler la mise) et la gestion dynamique de la valeur de l'As (1 ou 11).
+
+---
+
+## 📸 Aperçu du Jeu
+
+L'interface est propre et immersive :
+
+```text
+╔══════════════════════════════════════════════════════════╗
+║                   🎰 CASINO PYTHON 🎰                    ║
+╚══════════════════════════════════════════════════════════╝
+
+🤠 CROUPIER
+┌─────────┐ ┌─────────┐ 
+│ A       │ │░░░░░░░░░│ 
+│         │ │░░░░░░░░░│ 
+│    ♠    │ │░░PYTHON░│ 
+│         │ │░░░░░░░░░│ 
+│       A │ │░░░░░░░░░│ 
+└─────────┘ └─────────┘ 
+ Score : ?
+
+----------------------------------------
+
+👤 JOUEUR
+┌─────────┐ ┌─────────┐ 
+│ 10      │ │ 9       │ 
+│         │ │         │ 
+│    ♥    │ │    ♦    │ 
+│         │ │         │ 
+│      10 │ │       9 │ 
+└─────────┘ └─────────┘ 
+ Score : 19
\ No newline at end of file