diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aeb7816
--- /dev/null
+++ b/README.md
@@ -0,0 +1,42 @@
+# 🧰 cli_modbus_ivsr
+
+Ein kleines CLI-Tool zum **Steuern und Abfragen von Modbus-Sensoren** über **Modbus TCP**.  
+Gedacht als internes Testwerkzeug, um schnell Messwerte zu lesen oder Sollwerte zu setzen — direkt im Terminal.
+
+---
+
+## 🚀 Features
+- Modbus TCP-Unterstützung (pymodbus)  
+- Zyklisches Auslesen eines Registers (0,5 s Takt, Oneline-Ausgabe mit Zeitstempel)  
+- Einfaches Setzen eines Sollwerts (Eingabe 0–35)  
+- Plattformunabhängig: läuft überall, wo Python 3 läuft (getestet auf macOS & Raspberry Pi / Ubuntu)
+
+---
+
+## 📦 Dateien
+- `read.py` — zyklisches Auslesen eines Registers (Start → Eingabe 3. IP-Bereich → Eingabe 4. IP-Bereich → Endlosschleife bis `Ctrl+C`)  
+- `test.py` — Eingabe eines Sollwerts (0–35) und Senden an das Gerät  
+- `requirements.txt` — benötigte Python-Pakete
+
+---
+
+## ⚙️ Voraussetzungen
+- Python 3.7+  
+- `pymodbus` (in `requirements.txt`)  
+- Netzwerkzugriff auf das Modbus TCP-Gerät
+
+---
+
+## 🔧 Installation (Beispiel mit virtuellem Environment)
+
+```bash
+git clone https://github.com/dein-user/cli_modbus_ivsr.git
+cd cli_modbus_ivsr
+
+# virtuelles Environment erstellen & aktivieren
+python3 -m venv venv
+source venv/bin/activate   # macOS / Linux
+# venv\Scripts\activate    # Windows
+
+# Abhängigkeiten installieren
+pip install -r requirements.txt
\ No newline at end of file