diff --git a/README.md b/README.md
index 2750909..b6e472b 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,7 @@ client/
   gui_client.py         — PyQt5 GUI client
   client.py             — minimal CLI test client
   requirements.txt      — client dependencies
+  install.sh            — client installer (creates venv + run.sh launcher)
 credentials/            — JSON config files (gitignored)
 ```
 
@@ -169,14 +170,27 @@ mismatch produces garbled output.
 
 ## Client
 
+### Install
+
+```bash
+cd client
+chmod +x install.sh
+./install.sh
+```
+
+This creates `client/.venv` and writes a `client/run.sh` launcher.
+
+### Manual start
+
 ```bash
 pip install -r client/requirements.txt
+python client/gui_client.py
 ```
 
 ### GUI client (`client/gui_client.py`)
 
 ```bash
-python client/gui_client.py
+client/run.sh        # after install.sh
 ```
 
 Dark-theme PyQt5 application.  Three tabs: **Connector**, **Dashboard**,