Repository: unslothai/unsloth

Stars: 61937

README.md Copy Chapter

<h1 align="center" style="margin:0;">
<a href="https://unsloth.ai/docs"><picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/unslothai/unsloth/main/images/STUDIO%20WHITE%20LOGO.png">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/unslothai/unsloth/main/images/STUDIO%20BLACK%20LOGO.png">
<img alt="Unsloth logo" src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/STUDIO%20BLACK%20LOGO.png" height="60" style="max-width:100%;">
</picture></a>
</h1>
<h3 align="center" style="margin: 0; margin-top: 0;">
Run and train AI models with a unified local interface.
</h3>

<p align="center">
<a href="#-features">Features</a> •
<a href="#-quickstart">Quickstart</a> •
<a href="#-free-notebooks">Notebooks</a> •
<a href="https://unsloth.ai/docs">Documentation</a> •
<a href="https://www.reddit.com/r/unsloth/">Reddit</a>
</p>
<a href="https://unsloth.ai/docs/new/studio">
<img alt="unsloth studio ui homepage" src="https://raw.githubusercontent.com/unslothai/unsloth/main/studio/frontend/public/studio%20github%20landscape%20colab%20display.png" style="max-width: 100%; margin-bottom: 0;"></a>

Unsloth Studio (Beta) lets you run and train text, audio, embedding, vision models on Windows, Linux and macOS.

⭐ Features Copy Chapter

Inference Copy Section

Training Copy Section

⚡ Quickstart Copy Chapter

Unsloth Studio (web UI) Copy Section

* CPU: Supported for Chat and Data Recipes currently
* NVIDIA: Training works on RTX 30/40/50, Blackwell, DGX Spark, Station and more
* macOS: Currently supports chat and Data Recipes. MLX training is coming very soon
* AMD: Chat + Data works. Train with Unsloth Core. Studio support is out soon.
* Coming soon: Training support for Apple MLX, AMD, and Intel.
* Multi-GPU: Available now, with a major upgrade on the way

#### macOS, Linux, WSL:

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

irm https://unsloth.ai/install.ps1 | iex

#### Launch

unsloth studio -H 0.0.0.0 -p 8888

#### Update
To update, use the same install commands as above. Or run (does not work on Windows):

unsloth studio update

#### Docker
Use our Docker image ``unsloth/unsloth` container. Run:


docker run -d -e JUPYTER_PASSWORD="mypassword" \
  -p 8888:8888 -p 8000:8000 -p 2222:22 \
  -v $(pwd)/work:/workspace/work \
  --gpus all \
  unsloth/unsloth

#### Developer, Nightly, Uninstall
To see developer, nightly and uninstallation etc. instructions, see advanced installation.

Unsloth Core (code-based) Copy Section

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

winget install -e --id Python.Python.3.13
winget install --id=astral-sh.uv  -e
uv venv unsloth_env --python 3.13
.\unsloth_env\Scripts\activate
uv pip install unsloth --torch-backend=auto

#### AMD, Intel:
For RTX 50x, B200, 6000 GPUs: uv pip install unsloth --torch-backend=auto. Read our guides for: Blackwell and DGX Spark. <br>
To install Unsloth on AMD and Intel GPUs, follow our AMD Guide and Intel Guide.

📒 Free Notebooks Copy Chapter

Train for free with our notebooks. You can use our new free Unsloth Studio notebook to run and train models for free in a web UI.
Read our guide. Add dataset, run, then deploy your trained model.

| Model | Free Notebooks | Performance | Memory use |
|-----------|---------|--------|----------|
| Gemma 4 (E2B) | ▶️ Start for free-Vision.ipynb) | 1.5x faster | 50% less |
| Qwen3.5 (4B) | ▶️ Start for free_Vision.ipynb) | 1.5x faster | 60% less |
| gpt-oss (20B) | ▶️ Start for free-Fine-tuning.ipynb) | 2x faster | 70% less |
| Qwen3.5 GSPO | ▶️ Start for free_Vision_GRPO.ipynb) | 2x faster | 70% less |
| gpt-oss (20B): GRPO | ▶️ Start for free-GRPO.ipynb) | 2x faster | 80% less |
| Qwen3: Advanced GRPO | ▶️ Start for free-GRPO.ipynb) | 2x faster | 70% less |
| embeddinggemma (300M) | ▶️ Start for free.ipynb) | 2x faster | 20% less |
| Mistral Ministral 3 (3B) | ▶️ Start for free_Vision.ipynb) | 1.5x faster | 60% less |
| Llama 3.1 (8B) Alpaca | ▶️ Start for free-Alpaca.ipynb) | 2x faster | 70% less |
| Llama 3.2 Conversational | ▶️ Start for free-Conversational.ipynb) | 2x faster | 70% less |
| Orpheus-TTS (3B) | ▶️ Start for free-TTS.ipynb) | 1.5x faster | 50% less |

- See all our notebooks for: Kaggle, GRPO, TTS, embedding & Vision
- See all our models and all our notebooks
- See detailed documentation for Unsloth here

🦥 Unsloth News Copy Chapter

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

unsloth studio update

git clone https://github.com/unslothai/unsloth.git
cd unsloth
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1 --local
unsloth studio -H 0.0.0.0 -p 8888

unsloth studio update

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

unsloth studio -H 0.0.0.0 -p 8888

git clone https://github.com/unslothai/unsloth.git
cd unsloth
git checkout nightly
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1 --local
unsloth studio -H 0.0.0.0 -p 8888

unsloth studio -H 0.0.0.0 -p 8888

#### Uninstall
You can uninstall Unsloth Studio by deleting its install folder usually located under $HOME/.unsloth/studio on Mac/Linux/WSL and %USERPROFILE%\.unsloth\studio on Windows. Using the rm -rf commands will delete everything, including your history, cache:

* ​ MacOS, WSL, Linux: rm -rf ~/.unsloth/studio
* ​ Windows (PowerShell): Remove-Item -Recurse -Force "$HOME\.unsloth\studio"

For more info, see our docs.

#### 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, HF uses:

* ​ MacOS, Linux, WSL: ~/.cache/huggingface/hub/
* ​ Windows: %USERPROFILE%\.cache\huggingface\hub\`

💚 Community and Links Copy Chapter

Citation Copy Section

You can cite the Unsloth repo as follows:

@software{unsloth,
  author = {Daniel Han, Michael Han and Unsloth team},
  title = {Unsloth},
  url = {https://github.com/unslothai/unsloth},
  year = {2023}
}

License Copy Section

This structure helps support ongoing Unsloth development while keeping the project open source and enabling the broader ecosystem to continue growing.

Thank You to Copy Section