Installer Unsloth via pip et uv

Installez Unsloth Studio manuellement ou installez Unsloth Core avec pip, uv ou un environnement virtuel.

Unsloth Desktop, Unsloth Studio, et Unsloth Core sont installés différemment. Cette page couvre l'installation manuelle de Studio et le package Core basé sur le code.

Unsloth Desktop

Pour l'application de bureau native, utilisez le téléchargement de l'OS au lieu des commandes ci-dessous :

Unsloth Studio

Unsloth Studio est notre interface web. Suivez ci-dessous pour l'installation native :

Installez Unsloth :

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

Utilisez la même commande pour mettre à jour.

Installez Unsloth :

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

Utilisez la même commande pour mettre à jour.

L'image Docker Unsloth Docker image unsloth/unsloth est disponible sur Docker. Lire le guide.

Installez Unsloth :

winget install --id UnslothAI.Unsloth -e

Mettre à jour Unsloth :

brew upgrade --cask unsloth

Installez Unsloth :

winget install --id UnslothAI.Unsloth -e

Mettre à jour Unsloth :

winget upgrade --id UnslothAI.Unsloth -e

Lancer :

Lancement local standard :

unsloth studio

Pour plus de détails sur l'installation et la désinstallation, veuillez consulter la section Installation d'Unsloth Studio section.

Lancez Unsloth en toute sécurité via HTTPS :

unsloth studio --secure

Utilisez un tunnel Cloudflare gratuit sous Windows, Mac ou Linux.

Installer depuis le dépôt principal

Installations développeur pour macOS, Linux, WSL :

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

Installations développeur PowerShell sous Windows :

winget install -e --id Python.Python.3.13 --source winget
winget install --id=astral-sh.uv  -e --source winget
winget install --id Git.Git -e --source winget
git clone https://github.com/unslothai/unsloth
cd unsloth
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1 --local
unsloth studio -H 0.0.0.0 -p 8888

Installation Nightly

Nightly - macOS, Linux, WSL :

git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
./install.sh --local

Ensuite, pour le lancer à chaque fois :

unsloth studio -H 0.0.0.0 -p 8888

Nightly - Windows :

Exécutez dans Windows PowerShell :

winget install -e --id Python.Python.3.13 --source winget
winget install --id=astral-sh.uv  -e --source winget
winget install --id Git.Git -e --source winget
git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1 --local

Ensuite, pour le lancer à chaque fois :

unsloth studio -H 0.0.0.0 -p 8888

Désinstallation

La méthode recommandée pour supprimer complètement Unsloth Studio est le script de désinstallation correspondant à votre système d'exploitation. Il arrête tous les serveurs en cours d'exécution, supprime l'application, la commande CLI, les données du lanceur, les raccourcis et les entrées spécifiques à la plateforme (macOS .app bundle + Launch Services ; menu Démarrer Windows + registre + PATH) :

macOS, WSL, Linux :

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

Windows (PowerShell) :

irm https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.ps1 | iex

Désinstallation manuelle

Si vous préférez supprimer seulement certaines parties :

1. Supprimer uniquement l'application (conserve l'historique, les chats, les points de contrôle et les exportations intacts) :

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

2. Supprimer entièrement Unsloth (conserve les autres outils Unsloth intacts) :

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

3. Supprimer tout ce qui est lié à Unsloth :

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

Remarque : les étapes 1 à 5 ne touchent pas à vos fichiers de modèle HF téléchargés. Voir ci-dessous Suppression des fichiers de modèle HF mis en cache si vous souhaitez récupérer cet espace.

4. Supprimer les raccourcis et les liens symboliques :

macOS :

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

Linux :

rm -f ~/.local/share/applications/unsloth-studio.desktop ~/Desktop/unsloth-studio.desktop

WSL / Windows (PowerShell) :

Remove-Item -Force "$HOME\Desktop\Unsloth Studio.lnk"
Remove-Item -Force "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Unsloth Studio.lnk"

5. Supprimer la commande CLI :

macOS, Linux, WSL : rm -f ~/.local/bin/unsloth
Windows (PowerShell) : Le programme d'installation a ajouté le répertoire Scripts du venv à votre PATH utilisateur. Pour le supprimer, ouvrez Paramètres → Système → À propos → Paramètres système avancés → Variables d'environnement, recherchez Path dans Variables utilisateur, et supprimez l'entrée pointant vers .unsloth\studio\...\Scripts.

Remarque : les étapes 1 à 5 ne touchent pas à vos fichiers de modèle HF téléchargés. Voir Suppression des fichiers de modèle HF mis en cache ci-dessous si vous souhaitez récupérer cet espace.

Suppression des fichiers de modèle HF mis en cache

Vous pouvez supprimer les anciens fichiers de modèle soit depuis l'icône de la corbeille dans la recherche de modèles, soit en supprimant le dossier de modèle mis en cache correspondant dans le répertoire de cache Hugging Face par défaut. Par défaut, Hugging Face utilise ~/.cache/huggingface/hub/ sur macOS/Linux/WSL et C:\Users\<username>\.cache\huggingface\hub\ sur Windows.

macOS, Linux, WSL : ~/.cache/huggingface/hub/
Windows : %USERPROFILE%\.cache\huggingface\hub\

Si HF_HUB_CACHE ou HF_HOME est défini, utilisez cet emplacement à la place. Sous Linux et WSL, XDG_CACHE_HOME peut également modifier la racine du cache par défaut.

Unsloth Core

Installez uv avec la commande suivante :

macOS, WSL, Linux :

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell) :

irm https://astral.sh/uv/install.ps1 | iex

Installez Unsloth Core avec uv pip (recommandé) pour la dernière version pip :

uv venv unsloth_env --python 3.13
source unsloth_env/bin/activate
uv pip install unsloth --torch-backend=auto

Ou simplement pip :

pip install unsloth

Pour installer vLLM et Unsloth ensemble, faites :

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

Pour installer la dernière branche principale d'Unsloth, faites :

uv pip install unsloth --torch-backend=auto
pip uninstall unsloth unsloth_zoo -y && pip install --no-deps git+https://github.com/unslothai/unsloth_zoo.git && pip install --no-deps git+https://github.com/unslothai/unsloth.git

Pour les installations venv et dans des environnements virtuels afin d'isoler votre installation, de ne pas casser les paquets système et de réduire les dommages irréparables à votre système, utilisez venv :

apt install python3.10-venv python3.11-venv python3.12-venv python3.13-venv -y
python -m venv unsloth_env
source unsloth_env/bin/activate
pip install --upgrade pip && pip install uv
uv pip install unsloth --torch-backend=auto

Si vous installez Unsloth dans Jupyter, Colab ou d'autres notebooks, veillez à faire précéder la commande de !. Ce n'est pas nécessaire lors de l'utilisation d'un terminal

Python 3.13 est désormais pris en charge !

Désinstaller Unsloth Core

Si vous rencontrez toujours des problèmes de dépendances avec Unsloth, de nombreux utilisateurs les ont résolus en forçant la désinstallation puis la réinstallation d'Unsloth :

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

Installation avancée de Pip

Ne PAS utilisez ceci si vous avez Conda.

Pip est un peu plus complexe car il existe des problèmes de dépendances. La commande pip est différente pour torch 2.2,2.3,2.4,2.5 et les versions de CUDA.

Pour les autres versions de torch, nous prenons en charge torch211, torch212, torch220, torch230, torch240 et pour les versions de CUDA, nous prenons en charge cu118 et cu121 et cu124. Pour les appareils Ampere (A100, H100, RTX3090) et au-delà, utilisez cu118-ampere ou cu121-ampere ou cu124-ampere.

Par exemple, si vous avez torch 2.4 et CUDA 12.1, utilisez :

pip install --upgrade pip
pip install "unsloth[cu121-torch240] @ git+https://github.com/unslothai/unsloth.git"

Autre exemple, si vous avez torch 2.5 et CUDA 12.4, utilisez :

pip install --upgrade pip
pip install "unsloth[cu124-torch250] @ git+https://github.com/unslothai/unsloth.git"

Autres exemples :

pip install "unsloth[cu121-ampere-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu118-ampere-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu121-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu118-torch240] @ git+https://github.com/unslothai/unsloth.git"

pip install "unsloth[cu121-torch230] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu121-ampere-torch230] @ git+https://github.com/unslothai/unsloth.git"

pip install "unsloth[cu121-torch250] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu124-ampere-torch250] @ git+https://github.com/unslothai/unsloth.git"

Ou exécutez ce qui suit dans un terminal pour obtenir la commande d'installation pip optimale :

wget -qO- https://raw.githubusercontent.com/unslothai/unsloth/main/unsloth/_auto_install.py | python -

Ou exécutez ce qui suit manuellement dans un REPL Python :

# Sous licence Apache License, Version 2.0 (la "Licence")
try: import torch
except: raise ImportError('Installez torch via `pip install torch`)`
from packaging.version import Version as V
import re
v = V(re.match(r"[0-9\.]{3,}", torch.__version__).group(0))
cuda = str(torch.version.cuda)
is_ampere = torch.cuda.get_device_capability()[0] >= 8
USE_ABI = torch._C._GLIBCXX_USE_CXX11_ABI
if cuda not in ("11.8", "12.1", "12.4", "12.6", "12.8", "13.0"): raise RuntimeError(f"CUDA = {cuda} not supported!")
if   v <= V('2.1.0'): raise RuntimeError(f"Torch = {v} too old!")
elif v <= V('2.1.1'): x = 'cu{}{}-torch211'
elif v <= V('2.1.2'): x = 'cu{}{}-torch212'
elif v  < V('2.3.0'): x = 'cu{}{}-torch220'
elif v  < V('2.4.0'): x = 'cu{}{}-torch230'
elif v  < V('2.5.0'): x = 'cu{}{}-torch240'
elif v  < V('2.5.1'): x = 'cu{}{}-torch250'
elif v <= V('2.5.1'): x = 'cu{}{}-torch251'
elif v  < V('2.7.0'): x = 'cu{}{}-torch260'
elif v  < V('2.7.9'): x = 'cu{}{}-torch270'
elif v  < V('2.8.0'): x = 'cu{}{}-torch271'
elif v  < V('2.8.9'): x = 'cu{}{}-torch280'
elif v  < V('2.9.1'): x = 'cu{}{}-torch290'
elif v  < V('2.9.2'): x = 'cu{}{}-torch291'
else: raise RuntimeError(f"Torch = {v} too new!")
if v > V('2.6.9') and cuda not in ("11.8", "12.6", "12.8", "13.0"): raise RuntimeError(f"CUDA = {cuda} not supported!")
x = x.format(cuda.replace(".", ""), "-ampere" if False else "") # is_ampere is broken due to flash-attn
print(f'pip install --upgrade pip && pip install --no-deps git+https://github.com/unslothai/unsloth-zoo.git && pip install "unsloth[{x}] @ git+https://github.com/unslothai/unsloth.git" --no-build-isolation')

PrécédentInstallation

SuivantMacOS

Mis à jour il y a 4 heures

Ce contenu vous a-t-il été utile ?