diff --git a/QUICKSTART.md b/QUICKSTART.md index e1d2c9b..08c9a92 100644 --- a/QUICKSTART.md +++ b/QUICKSTART.md @@ -11,8 +11,14 @@ Tested on: AMD Ryzen AI Max (Strix Halo APU), 124 GB RAM, Linux, CPU inference. # 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 + +# 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 packages/node packages/p2p packages/relay +.venv/bin/pip install -e packages/tracker -e packages/node -e packages/p2p -e packages/gateway # CPU-only PyTorch (skip if you have CUDA/ROCm already) .venv/bin/pip install torch --index-url https://download.pytorch.org/whl/cpu @@ -24,6 +30,24 @@ cd /run/media/popov/d/DEV/repos/d-popov.com/AI > **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 / WSL2 + +Run the Linux commands from WSL, not Git Bash. From the repo opened in Git Bash: + +```bash +wsl +cd /mnt/d/DEV/workspace/REPOS/git.d-popov.com/neuron-tai +python3 -m venv .venv +.venv/bin/python -m pip install --upgrade pip setuptools wheel +.venv/bin/pip install -e packages/tracker -e packages/node -e packages/p2p -e packages/gateway +.venv/bin/pip install torch --index-url https://download.pytorch.org/whl/cpu +.venv/bin/pip install transformers accelerate +.venv/bin/meshnet-node --help +``` + +If `.venv/bin/meshnet-node` is missing, the editable install step did not finish +successfully. Re-run the `.venv/bin/pip install -e ...` command above inside WSL. + --- ## Step 1 — Start the tracker (Terminal 1)