Install Unsloth on MacOS

To install Unsloth locally on your local Apple MacOS device, follow the steps below:

Install Unsloth

For MacOS, ensure you have cmake installed. If not, run brew install cmake.

brew install cmake
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv unsloth_studio --python 3.13
source unsloth_studio/bin/activate
uv pip install unsloth --torch-backend=auto
unsloth studio setup
unsloth studio -H 0.0.0.0 -p 8888

Launch Unsloth

Every time you want to launch Unsloth again:

source unsloth_studio/bin/activate
unsloth studio -H 0.0.0.0 -p 8888

For detailed Unsloth Studio install instructions and requirements, view our guide.

Updating Unsloth

uv pip install --force-reinstall --no-deps unsloth

Uninstall or Reinstall

If you're still encountering dependency issues with Unsloth, many users have resolved them by forcing uninstalling and reinstalling Unsloth:

pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth_zoo