From c4b37a5e82af65a0b43274c205a4fbab51627d7b Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Sat, 21 Jun 2025 13:25:58 -0400
Subject: [PATCH] docs: add venv install instructions

---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index 630c7fb..32a913d 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,14 @@ pipx install voxvera  # recommended
 pip install --user voxvera
 ```
 
+If your system reports an "externally-managed" Python environment and blocks installation, create a virtual environment first:
+
+```bash
+python3 -m venv voxvera-venv
+source voxvera-venv/bin/activate
+pip install voxvera
+```
+
 The legacy `src/create_flyer.sh` script remains for backward compatibility. It
 simply forwards its arguments to the Python CLI so existing workflows continue
 to work.