From 2b1bfa533565f582863ece92e1fe0cbf4d64ce0b Mon Sep 17 00:00:00 2001
From: TianyiZhao1437 <tim@gradient.network>
Date: Mon, 13 Oct 2025 08:16:30 +0000
Subject: [PATCH] feat(readme): guide macos to use python venv

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

diff --git a/README.md b/README.md
index 9ac0e866..f1a2f3e9 100644
--- a/README.md
+++ b/README.md
@@ -53,12 +53,22 @@ pip install -e '.[gpu]'
 ```
 
 - For macOS (Apple silicon):
+
+We recommend macOS users to create an isolated Python virtual environment before installation.
+
 ```sh
 git clone https://github.com/GradientHQ/parallax.git
 cd parallax
+
+# Enter Python virtual environment
+python -m venv ./venv
+source ./venv/bin/activate
+
 pip install -e '.[mac]'
 ```
 
+Next time to re-activate this virtual environment, run ```source ./venv/bin/activate```.
+
 - Extra step for development:
 ```sh
 pip install -e '.[dev]'