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

The recommended way to fully remove Unsloth Studio is the uninstall script for your OS. It stops any running servers, removes the app, CLI command, launcher data, shortcuts, and platform-specific entries (macOS .app bundle + Launch Services; Windows Start Menu + registry + PATH):

curl -fsSL https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.sh | sh

Manual uninstall

If you prefer to remove only specific parts:

1. Remove app only (keeps history, chats, checkpoints, and exports intact):

• rm -rf ~/.unsloth/studio/unsloth_studio

2. Remove Studio entirely (keeps other Unsloth tools intact):

• rm -rf ~/.unsloth/studio

3. Remove everything Unsloth-related:

• rm -rf ~/.unsloth

Note: Step 3 deletes everything in history, chats, model checkpoints, and exports. This cannot be undone.

4. Remove shortcuts and symlinks:

rm -rf ~/Applications/Unsloth\ Studio.app ~/Desktop/Unsloth\ Studio

5. Remove the CLI command:

• rm -f ~/.local/bin/unsloth

Note: Steps 1-5 dont touch your downloaded HF model files. See Deleting cached HF model files below if you want to reclaim that space.

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 Hugging Face cache directory.

The default cache location is:

~/.cache/huggingface/hub/

If HF_HUB_CACHE or HF_HOME is set, use that location instead. You can check with:

echo ${HF_HUB_CACHE:-${HF_HOME:-${XDG_CACHE_HOME:-$HOME/.cache}/huggingface}/hub}

To delete a specific model, remove its folder (e.g. models--unsloth--Llama-3.1-8B-bnb-4bit) from the cache directory. To clear all cached models:

rm -rf ~/.cache/huggingface/hub/