Install Unsloth on MacOS

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

Install Unsloth

curl -fsSL https://unsloth.ai/install.sh | sh

Use the same command to update.

Launch

Every time you want to launch Unsloth again:

unsloth studio -H 0.0.0.0 -p 8888

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

Uninstall

You can uninstall Unsloth Studio by deleting its install folder usually located under $HOME/.unsloth/studio on Mac/Linux/WSL. Or run:

• MacOS, WSL, Linux: rm -rf ~/.unsloth/studio

• Optional: remove ~/.unsloth on MacOS/Linux/WSL if you want to delete all Unsloth files

Note: Using the rm -rf commands will delete everything, including your history, cache, chats etc.

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

Deleting model files

You can delete old model files either from the bin icon in model search or by removing the relevant cached model folder from the default Hugging Face cache directory. By default, Hugging Face uses ~/.cache/huggingface/hub/ on macOS/Linux/WSL.

• MacOS, Linux, WSL: ~/.cache/huggingface/hub/

On Linux and WSL, XDG_CACHE_HOME can also change the default cache root.