# Installer Unsloth via pip et uv
Unsloth peut être utilisé de deux façons : via [Unsloth Studio](#unsloth-studio)，l’interface web, ou via [Unsloth Core](#unsloth-core)，la version basée sur le code.
## **Unsloth Studio**
#### **MacOS, Linux, WSL :**
```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```
Utilisez la même commande pour mettre à jour ou utilisez `unsloth studio update`.
#### **Windows PowerShell :**
```bash
irm https://unsloth.ai/install.ps1 | iex
```
Utilisez la même commande pour mettre à jour ou utilisez `unsloth studio update`.
#### Lancer :
```bash
unsloth studio -H 0.0.0.0 -p 8888
```
Pour des instructions d’installation et des exigences détaillées d’Unsloth Studio, [consultez notre guide](https://unsloth.ai/docs/fr/nouveau/studio/install).
### **Installer depuis le dépôt principal**
#### **Installations développeur sur macOS, Linux, WSL :**
```bash
git clone https://github.com/unslothai/unsloth
cd unsloth
./install.sh --local
unsloth studio -H 0.0.0.0 -p 8888
```
#### **Installations développeur Windows PowerShell :**
```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
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1 --local
unsloth studio -H 0.0.0.0 -p 8888
```
### **Installation nocturne**
#### **Nocturne - MacOS, Linux, WSL :**
```bash
git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
./install.sh --local
```
Puis pour lancer à chaque fois :
```bash
unsloth studio -H 0.0.0.0 -p 8888
```
#### **Nocturne - Windows :**
Exécutez dans Windows PowerShell :
```bash
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
```
Puis pour lancer à chaque fois :
unsloth studio -H 0.0.0.0 -p 8888
### Désinstaller
Pour désinstaller Unsloth Studio, suivez ces 4 étapes :
#### **1. Supprimer l’application**
* MacOS, WSL, Linux : `rm -rf ~/.unsloth/studio/unsloth ~/.unsloth/studio/studio`
* Windows (PowerShell) : `Remove-Item -Recurse -Force "$HOME\.unsloth\studio\unsloth", "$HOME\.unsloth\studio\studio"`
Cela supprime l’application mais conserve vos checkpoints de modèle, exports, historique, cache et chats.
#### **2. Supprimer les raccourcis et les liens symboliques**
**macOS :**
```bash
rm -rf ~/Applications/Unsloth\ Studio.app ~/Desktop/Unsloth\ Studio
```
**Linux :**
```bash
rm -f ~/.local/share/applications/unsloth-studio.desktop ~/Desktop/unsloth-studio.desktop
```
**WSL / Windows (PowerShell) :**
```bash
Remove-Item -Force "$HOME\Desktop\Unsloth Studio.lnk"
Remove-Item -Force "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Unsloth Studio.lnk"
```
#### **3. Supprimer la commande CLI**
**macOS, Linux, WSL :**
```bash
rm -f ~/.local/bin/unsloth
```
**Windows (PowerShell) :** L’installateur 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 les variables utilisateur, et supprimez l’entrée pointant vers `.unsloth\studio\...\Scripts`.
#### **4. Tout supprimer (facultatif)**
Pour supprimer aussi l’historique, le cache, les chats, les checkpoints de modèle et les exports de modèle, supprimez tout le dossier Unsloth :
* MacOS, WSL, Linux : `rm -rf ~/.unsloth`
* Windows (PowerShell) : `Remove-Item -Recurse -Force "$HOME\.unsloth"`
Notez que les fichiers de modèle HF téléchargés sont stockés séparément dans le cache Hugging Face — aucune des étapes ci-dessus ne les supprimera. Voir **Suppression des fichiers de modèle** ci-dessous si vous souhaitez récupérer cet espace disque.
{% hint style="warning" %}
Remarque : l’utilisation des `rm -rf` commandes va **tout supprimer**y compris votre historique, cache, chats, etc.
{% endhint %}
### **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 corbeille dans la recherche de modèles, soit en supprimant le dossier de cache du modèle concerné 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\\.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. Sur Linux et WSL, `XDG_CACHE_HOME` peut aussi modifier la racine du cache par défaut.
## **Unsloth Core**
**Installez avec uv pip (recommandé) pour la dernière version de pip :**
```bash
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
```
Ou simplement pip :
```bash
pip install unsloth
```
Pour installer **vLLM et Unsloth** ensemble, faites :
```bash
uv pip install unsloth vllm --torch-backend=auto
```
Pour installer la **dernière branche principale** d’Unsloth, faites :
{% code overflow="wrap" %}
```bash
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
```
{% endcode %}
Pour **les installations dans venv et environnements virtuels** afin d’isoler votre installation pour ne pas casser les paquets système, et de réduire les dommages irréparables à votre système, utilisez venv :
{% code overflow="wrap" %}
```bash
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
```
{% endcode %}
Si vous installez Unsloth dans Jupyter, Colab ou d’autres notebooks, assurez-vous de préfixer la commande avec `!`. Ce n’est pas nécessaire lors de l’utilisation d’un terminal
{% hint style="info" %}
Python 3.13 est désormais pris en charge !
{% endhint %}
### Désinstaller Unsloth Core
Si vous rencontrez encore 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 :
{% code overflow="wrap" %}
```bash
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth_zoo
```
{% endcode %}
### Installation avancée avec pip
{% hint style="warning" %}
N’ **UTILISEZ PAS** cela si vous avez [Conda](https://unsloth.ai/docs/fr/commencer/install/conda-install).
{% endhint %}
Pip est un peu plus complexe en raison de 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-dessus, utilisez `cu118-ampere` ou `cu121-ampere` ou `cu124-ampere`.
Par exemple, si vous avez `torch 2.4` et `CUDA 12.1`, utilisez :
```bash
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 :
```bash
pip install --upgrade pip
pip install "unsloth[cu124-torch250] @ git+https://github.com/unslothai/unsloth.git"
```
Et autres exemples :
```bash
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 optimale** d’installation pip :
```bash
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 :
{% code overflow="wrap" %}
```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')
```
{% endcode %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://unsloth.ai/docs/fr/commencer/install/pip-install.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.