diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d306700
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# 🧾 Proxmox Inventory Script
+
+Ein Bash-Skript zur Inventarisierung von **Proxmox Nodes, virtuellen Maschinen (VMs)** und **Containern (CTs)**.  
+Es unterstützt lokale und Remote-Abfragen über SSH und gibt die Ergebnisse in verschiedenen Formaten aus.
+
+---
+
+## 🚀 Funktionen
+
+- 🖥️ Erfasst Informationen zu:
+  - **Nodes (Host)**: Hostname, IP, CPU, RAM
+  - **VMs (QEMU)**: ID, Name, IP, CPU, RAM, Storage
+  - **LXC-Container**: ID, Hostname, IP, CPU, RAM, Storage
+- 🌐 Unterstützt DNS-Auflösung per interner Domain
+- 🔧 Ausgabeformate: `cli`, `csv`, `json`
+- 📡 Remote-Abfrage mehrerer Nodes via SSH
+
+---
+
+## ⚙️ Verwendung
+
+```bash
+# Lokale Inventarisierung mit CLI-Ausgabe
+./inventory.sh --local --output cli
+
+# Remote-Nodes per SSH abfragen, Ausgabe im CSV-Format
+./inventory.sh --nodes node1,node2 --output csv
+
+# Interne Domain verwenden und JSON ausgeben
+INTERNAL_DOMAIN="lan" ./inventory.sh --internal --nodes node1 --output json