Install Unsloth on Linux

Install Unsloth Desktop, Unsloth Studio, or Unsloth Core on Linux.

To install Unsloth Desktop on Linux, follow the steps below.

1

Download

Download Unsloth for Linux

2

Install

1. Open the Unsloth installer (.deb file)

2. Select Install

3. Launch the app and wait for installation to complete

3

Choose a model

Open Select model or Model hub, choose a model and quantization, then download it. Once it finishes, start chatting - no setup required.

4

Unsloth is now ready

To start chatting, type a message and press Enter.

• Connect tools: Claude Code, Codex, web search, MCP and more

• Train models: Fine-tune text, diffusion, embedding, and more

• Generate media: Create and train images, video, TTS locally

Advanced installation

Use these options for developer builds, nightly Unsloth Studio, or code-based Unsloth Core.

Install Unsloth Studio from the main repo

git clone https://github.com/unslothai/unsloth
cd unsloth
./install.sh --local
unsloth studio -H 0.0.0.0 -p 8888

Install nightly Unsloth Studio

git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
./install.sh --local
unsloth studio -H 0.0.0.0 -p 8888

Install Unsloth Core with uv

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv unsloth_env --python 3.13
source unsloth_env/bin/activate
uv pip install unsloth --torch-backend=auto

Or install the latest pip release directly:

pip install unsloth

To install vLLM with Unsloth:

uv pip install unsloth vllm --torch-backend=auto

For virtual environments, CUDA and Torch-specific commands, and advanced pip options:

View the advanced pip installation guide

Install Unsloth Studio manually

The command below installs Unsloth Studio, the browser-based web UI. It does not install the native Desktop app.

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

Use the same command to update Unsloth Studio.

Launch Unsloth Studio

unsloth studio -H 0.0.0.0 -p 8888

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

Uninstall

Unsloth Desktop

Ubuntu or Debian (.deb)

1. Close Unsloth if it is running.

2. Remove the package:

sudo apt remove unsloth

AppImage

1. Close Unsloth if it is running.

2. Delete the downloaded .AppImage file.

Uninstalling Unsloth Desktop does not remove downloaded models or your files.

Unsloth Studio (manual installation)

Run the Linux uninstall script:

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

This removes Unsloth Studio, its CLI command, launcher data, and Linux desktop shortcuts. It does not remove downloaded Hugging Face models.

Delete downloaded model files

The default Hugging Face cache is:

~/.cache/huggingface/hub/

If HF_HUB_CACHE, HF_HOME, or XDG_CACHE_HOME is set, use that location instead.