From d4c8c0cb8441a2333290ca8ed4f25c0b5be50830 Mon Sep 17 00:00:00 2001 From: Datta Nimmaturi Date: Wed, 18 Mar 2026 22:18:02 +0530 Subject: [PATCH 1/2] Make instructions mac friendly (#4432) --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f412091bfb..81c04dcd85 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,9 @@ Unsloth Studio works on **Windows, Linux, WSL** and **macOS**. #### MacOS, Linux or WSL Setup (One time): ```bash -pip install -U pip uv +curl -LsSf https://astral.sh/uv/install.sh | sh +export PATH="$HOME/.local/bin:$PATH" # To add uv to the path and make it available in the current session. Add this to your shell script (e.g. ~/.zshrc) for persistence +# echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc (or ~/.bashrc depending on your shell) uv venv unsloth_studio source unsloth_studio/bin/activate uv pip install unsloth --torch-backend=auto From e0a9e772d1e186aa0ecfa6ee5490d7f8096d0626 Mon Sep 17 00:00:00 2001 From: Daniel Han Date: Wed, 18 Mar 2026 09:57:44 -0700 Subject: [PATCH 2/2] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 81c04dcd85..6fb3e2160a 100644 --- a/README.md +++ b/README.md @@ -54,8 +54,6 @@ Unsloth Studio works on **Windows, Linux, WSL** and **macOS**. #### MacOS, Linux or WSL Setup (One time): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh -export PATH="$HOME/.local/bin:$PATH" # To add uv to the path and make it available in the current session. Add this to your shell script (e.g. ~/.zshrc) for persistence -# echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc (or ~/.bashrc depending on your shell) uv venv unsloth_studio source unsloth_studio/bin/activate uv pip install unsloth --torch-backend=auto @@ -70,7 +68,8 @@ unsloth studio -H 0.0.0.0 -p 8888 #### Windows PowerShell (One time): ```bash -pip install -U pip uv +winget install -e --id Python.Python.3.13 +winget install --id=astral-sh.uv -e uv venv unsloth_studio .\unsloth_studio\Scripts\activate uv pip install unsloth --torch-backend=auto @@ -87,7 +86,7 @@ Use our [Docker image](https://hub.docker.com/r/unsloth/unsloth) ```unsloth/unsl #### Nightly Installation - MacOS, Linux or WSL Setup (One time): ```bash -pip install -U pip uv +curl -LsSf https://astral.sh/uv/install.sh | sh git clone --filter=blob:none https://github.com/unslothai/unsloth.git unsloth_studio cd unsloth_studio uv venv @@ -105,7 +104,8 @@ unsloth studio -H 0.0.0.0 -p 8888 #### Nightly Installation - Windows Powershell (One time): ```bash -pip install -U pip uv +winget install -e --id Python.Python.3.13 +winget install --id=astral-sh.uv -e git clone --filter=blob:none https://github.com/unslothai/unsloth.git unsloth_studio cd unsloth_studio uv venv