From 7419ace9262a9d336a54317b503eaa563e5066d0 Mon Sep 17 00:00:00 2001
From: Dobromir Popov <dobromir.popov@gateway.one>
Date: Wed, 8 Jul 2026 17:29:23 +0200
Subject: [PATCH] md

---
 QUICKSTART.md | 39 +++++++++++++++++++++++++++++----------
 1 file changed, 29 insertions(+), 10 deletions(-)

diff --git a/QUICKSTART.md b/QUICKSTART.md
index 5ee3989..43040e0 100644
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -7,28 +7,47 @@ Tested on: AMD Ryzen AI Max (Strix Halo APU), 124 GB RAM, Linux, CPU inference.
 
 ## Prerequisites
 
+Choose the shell you will actually run `meshnet-*` from. Editable installs point
+the command wrappers at this source tree, so normal code edits are picked up
+without reinstalling.
+
+**Linux / WSL**
+
 ```bash
 # Clone and enter repo
 cd /run/media/popov/d/DEV/repos/d-popov.com/AI
 
 # Create the virtualenv if it does not exist yet
 python3 -m venv .venv
-
+source .venv/bin/activate
 # Keep packaging tools current enough for editable installs
 .venv/bin/python -m pip install --upgrade pip setuptools wheel
-
 # Install Python packages (editable — picks up code changes immediately)
-.venv/bin/pip install -e packages/tracker -e packages/node -e packages/p2p -e packages/gateway -e packages/relay
-
-# CPU-only PyTorch (skip if you have CUDA/ROCm already)
-.venv/bin/pip install torch --index-url https://download.pytorch.org/whl/cpu
-
+.venv/bin/python -m pip install -e packages/tracker -e packages/node -e packages/p2p -e packages/gateway -e packages/relay
+# PyTorch: choose one
+.venv/bin/python -m pip install torch
+# .venv/bin/python -m pip install torch --index-url https://download.pytorch.org/whl/cpu
+# .venv/bin/python -m pip install torch --index-url https://download.pytorch.org/whl/rocm6.2
 # HuggingFace model libraries
-.venv/bin/pip install "transformers>=5.12" accelerate
+.venv/bin/python -m pip install "transformers>=5.12" accelerate
 ```
 
-> **NVIDIA GPU (CUDA):** replace the torch line with `pip install torch` (default index).  
-> **AMD GPU (ROCm):** `pip install torch --index-url https://download.pytorch.org/whl/rocm6.2`
+**Windows PowerShell**
+
+```powershell
+cd D:\DEV\workspace\REPOS\git.d-popov.com\neuron-tai
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+.\.venv\Scripts\python.exe -m pip install --upgrade pip setuptools wheel
+.\.venv\Scripts\python.exe -m pip install -e .\packages\tracker -e .\packages\node -e .\packages\p2p -e .\packages\gateway -e .\packages\relay
+# PyTorch: choose one
+.\.venv\Scripts\python.exe -m pip install torch
+# .\.venv\Scripts\python.exe -m pip install torch --index-url https://download.pytorch.org/whl/cpu
+# .\.venv\Scripts\python.exe -m pip install torch --index-url https://download.pytorch.org/whl/rocm6.2
+.\.venv\Scripts\python.exe -m pip install "transformers>=5.12" accelerate
+```
+
+> Torch choices: default index for NVIDIA/CUDA, CPU index for CPU-only, ROCm index for AMD GPU.
 
 ### Version and library notes for Qwen3.5/3.6-MoE models