> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/fr/commencer/install/pip-install.md).
# Installez Unsloth via pip et uv
**Unsloth Desktop**, **Unsloth Studio**, et **Unsloth Core** s’installent 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 pour votre système d’exploitation au lieu des commandes ci-dessous :
* :apple: [Télécharger pour macOS](https://unsloth.ai/download/mac)
* :windows: [Télécharger pour Windows](https://unsloth.ai/download/windows)
* :linux: [Télécharger pour Linux](https://unsloth.ai/download/linux)
## **Unsloth Studio**
#### **MacOS, Linux, WSL :**
```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```
Utilisez la même commande pour mettre à jour.
#### **Windows PowerShell :**
```bash
irm https://unsloth.ai/install.ps1 | iex
```
Utilisez la même commande pour mettre à jour.
#### Lancer :
```bash
unsloth studio -H 0.0.0.0 -p 8888
```
Pour des instructions d'installation et des exigences détaillées pour Unsloth Studio, [consultez notre guide](/docs/fr/nouveau/studio/install.md).
### **Installer depuis le dépôt principal**
#### **Installations pour développeurs 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 pour développeurs sur 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 Nightly**
#### **Nightly - macOS, Linux, WSL :**
```bash
git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
./install.sh --local
```
Puis pour le lancer à chaque fois :
```bash
unsloth studio -H 0.0.0.0 -p 8888
```
#### **Nightly - 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 le lancer à chaque fois :
unsloth studio -H 0.0.0.0 -p 8888
### Désinstaller
La méthode recommandée pour supprimer entièrement Unsloth Studio est le script de désinstallation de 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 :**
```shellscript
curl -fsSL https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.sh | sh
```
**Windows (PowerShell) :**
```ps1
irm https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.ps1 | iex
```
#### Désinstallation manuelle
Si vous préférez supprimer uniquement des éléments spécifiques :
**1. Supprimer seulement l’application** (conserve l’historique, les conversations, les checkpoints et les exports 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"`
{% hint style="warning" %}
Remarque : l’étape 3 supprime tout l’historique, les conversations, les checkpoints de modèles et les exports. Cela ne peut pas être annulé.
{% endhint %}
**4. Supprimer les raccourcis et les liens symboliques :**
**macOS :**
```shellscript
rm -rf ~/Applications/Unsloth\ Studio.app ~/Desktop/Unsloth\ Studio
```
**Linux :**
```shellscript
rm -f ~/.local/share/applications/unsloth-studio.desktop ~/Desktop/unsloth-studio.desktop
```
**WSL / Windows (PowerShell) :**
```shellscript
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) :** 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 `Scripts` dans Variables utilisateur, puis supprimez l’entrée pointant vers `Path` .unsloth\studio\\...\Scripts `Remarque : les étapes 1 à 5 ne touchent pas à vos fichiers de modèles HF téléchargés. Voir ci-dessous la suppression des fichiers de modèles HF mis en cache si vous souhaitez récupérer cet espace.`.
{% hint style="info" %}
Suppression des fichiers de modèles HF mis en cache
{% endhint %}
### **Vous pouvez supprimer les anciens fichiers de modèle soit via l’icône de corbeille dans la recherche de modèles, soit en supprimant le dossier du modèle mis en cache correspondant depuis le répertoire de cache Hugging Face par défaut. Par défaut, Hugging Face utilise**
sur macOS/Linux/WSL et `~/.cache/huggingface/hub/` C:\Users\\\\\.cache\huggingface\hub\ `sur Windows.` Windows :
* **MacOS, Linux, WSL :** `~/.cache/huggingface/hub/`
* **%USERPROFILE%\\.cache\huggingface\hub\\** `est défini, utilisez plutôt cet emplacement. Sur Linux et WSL,`
Si `HF_HUB_CACHE` ou `HF_HOME` peut également modifier la racine de cache par défaut. `XDG_CACHE_HOME` Installez uv avec la commande suivante :
## **Unsloth Core**
**irm | iex**
**macOS, WSL, Linux :**
```shellscript
curl -LsSf https://astral.sh/uv/install.sh | sh
```
**Windows (PowerShell) :**
```powershell
Installez unsloth core avec uv pip (recommandé) pour la dernière version de pip :
```
**Ou simplement pip :**
```bash
uv venv unsloth_env --python 3.13
source unsloth_env/bin/activate
uv pip install unsloth --torch-backend=auto
```
Pour installer
```bash
pip install unsloth
```
vLLM et Unsloth **ensemble, faites :** Pour installer la
```bash
uv pip install unsloth vllm --torch-backend=auto
```
branche principale la plus récente **d’Unsloth, faites :** pip uninstall unsloth unsloth\_zoo -y && pip install --no-deps git+ && pip install --no-deps git+
{% code overflow="wrap" %}
```bash
uv pip install unsloth --torch-backend=auto
Installations avec venv et environnements virtuels
```
{% endcode %}
Pour **pour isoler votre installation, éviter de casser les paquets système et 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
{% code overflow="wrap" %}
```bash
python -m venv unsloth_env
pip install --upgrade pip && pip install uv
source unsloth_env/bin/activate
Si vous installez Unsloth dans Jupyter, Colab ou d’autres notebooks, veillez à préfixer la commande avec
uv pip install unsloth --torch-backend=auto
```
{% endcode %}
. Ce n’est pas nécessaire lors de l’utilisation d’un terminal `!`Python 3.13 est désormais pris en charge !
{% hint style="info" %}
Désinstaller Unsloth Core
{% endhint %}
### 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 :
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth
{% code overflow="wrap" %}
```bash
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth_zoo
Installation avancée de Pip
```
{% endcode %}
### Faites
{% hint style="warning" %}
utilisez ceci si vous avez **PAS** Conda [Pip est un peu plus complexe car il y a des problèmes de dépendances. La commande pip est différente pour](/docs/fr/commencer/install/conda-install.md).
{% endhint %}
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 `cu121` et `cu124` et `. Pour les appareils Ampere (A100, H100, RTX3090) et supérieurs, utilisez`cu118-ampere `cu121-ampere` ou `cu124-ampere` ou `Par exemple, si vous avez`.
torch 2.4 `CUDA 12.1` et `, utilisez :`pip install --upgrade pip
```bash
pip install "unsloth[cu121-torch240] @ git+https://github.com/unslothai/unsloth.git"
Autre exemple, si vous avez
```
torch 2.5 `CUDA 12.4` et `pip install "unsloth[cu124-torch250] @ git+https://github.com/unslothai/unsloth.git"`pip install --upgrade pip
```bash
pip install "unsloth[cu121-torch240] @ git+https://github.com/unslothai/unsloth.git"
Et d’autres exemples :
```
pip install "unsloth\[cu121-ampere-torch240] @ git+"
```bash
pip install "unsloth[cu118-ampere-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu118-torch240] @ git+https://github.com/unslothai/unsloth.git"
Autre exemple, si vous avez
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
```
optimale **commande d’installation pip :** wget -qO- | python -
```bash
Ou exécutez ce qui suit manuellement dans un REPL Python :
```
\# Sous licence Apache, version 2.0 (« License »)
{% code overflow="wrap" %}
```python
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} non prise en charge !")
if v <= V('2.1.0'): raise RuntimeError(f"Torch = {v} trop ancien !")
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} trop récent !")
if v > V('2.6.9') and cuda not in ("11.8", "12.6", "12.8", "13.0"): raise RuntimeError(f"CUDA = {cuda} non prise en charge !")
x = x.format(cuda.replace(".", ""), "-ampere" if False else "") # is_ampere est cassé à cause de 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')
Désinstaller Unsloth Core
```
{% endcode %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://unsloth.ai/docs/fr/commencer/install/pip-install.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.