# Installation d'Unsloth Studio Unsloth Studio fonctionne sous Windows, Linux, WSL et MacOS. Vous devez utiliser le même processus d'installation sur chaque appareil, même si les exigences système peuvent varier selon l'appareil. Windows MacOS Linux et WSL Docker Installation pour développeur * **Mac :** Comme CPU - [Chat](/docs/fr/nouveau/studio/chat.md#using-unsloth-studio-chat) + [Recettes de données](/docs/fr/nouveau/studio/data-recipe.md) fonctionne pour le moment. **MLX** l'entraînement arrive très bientôt. * **CPU : Unsloth fonctionne toujours sans GPU**, mais pour Chat + Recettes de données. * **Entraînement :** Fonctionne sur **NVIDIA**: RTX 30, 40, 50, Blackwell, DGX Spark/Station, etc. + **Intel** GPU * **Bientôt disponible :** Prise en charge de **Apple MLX** et **AMD**. ### Démarrage rapide {% tabs %} {% tab title="MacOS" %} #### Étape 1 : Configurer Unsloth Lancez le `terminal` depuis un Mac, puis installez Unsloth en entrant la commande ci-dessous. ```bash curl -fsSL https://unsloth.ai/install.sh | sh ``` Unsloth commencera à configurer l'environnement et à installer les packages requis comme indiqué ci-dessous. Tapez **Y** et appuyez sur `Entrée` lorsqu'on vous demande si vous souhaitez autoriser Studio à démarrer maintenant. Cela lancera Unsloth sur votre **8888** port

{% hint style="info" %} local. Si vous avez choisi de ne pas démarrer Unsloth pendant le processus d'installation, vous pouvez toujours lancer l'application Unsloth en utilisant `unsloth studio -p 8888` . Si vous souhaitez que votre instance Unsloth soit accessible aux clients en dehors de votre PC/ordinateur, ajoutez `-H 0.0.0.0` à la commande `unsloth studio` . {% endhint %} #### Étape 2 : Démarrer Unsloth Ouvrez votre navigateur préféré et allez à l'URL `http://127.0.0.1:8888` . Si c'est votre première installation d'Unsloth, il vous sera demandé de créer un nouveau mot de passe. Ensuite, l'application Unsloth devrait maintenant s'ouvrir sur la page Chat comme indiqué ci-dessous.

Vous pouvez également le lancer avec la commande suivante : ```bash unsloth studio -H 0.0.0.0 -p 8888 ``` {% hint style="info" %} Si vous souhaitez que votre instance soit accessible aux clients en dehors de votre PC/ordinateur.\ Ajoutez `-H 0.0.0.0` à la commande `unsloth studio` . {% endhint %} #### Étape 2 : Démarrer Unsloth Ouvrir `http://127.0.0.1:8888` dans votre navigateur. Au premier lancement, créez un nouveau mot de passe pour continuer vers la page Chat. **Unsloth Studio** est maintenant installé et prêt à l'emploi. L'application Unsloth devrait maintenant s'ouvrir sur la page Chat comme indiqué ci-dessous.

{% hint style="info" %} local. Si vous avez choisi de ne pas démarrer Unsloth pendant le processus d'installation, vous pouvez toujours lancer l'application Unsloth en utilisant `unsloth studio -p 8888` . Si vous souhaitez que votre instance Unsloth soit accessible aux clients en dehors de votre PC/ordinateur, ajoutez `-H 0.0.0.0` à la commande `unsloth studio` . {% endhint %} #### Étape 2 : Démarrer Unsloth Ouvrez votre navigateur préféré et tapez `http://127.0.0.1:8888` dans la zone d'URL. Si c'est votre première installation d'Unsloth, vous serez redirigé vers la page `http://127.0.0.1:8888/change-password` comme indiqué ci-dessous :

Saisissez un nouveau mot de passe dans le champ `Nouveau mot de passe` et ressaisissez le même mot de passe dans `Confirmer le mot de passe` puis cliquez sur le bouton **Changer le mot de passe** Le bouton**.**

L'application Unsloth devrait maintenant s'ouvrir sur la page Chat comme indiqué. **Unsloth Studio** est maintenant installé et prêt à l'emploi.

Vous pouvez commencer immédiatement à entraîner et à exécuter des modèles. Vous pouvez consulter notre guide plus détaillé, étape par étape, pour commencer ci-dessous : {% content-ref url="/pages/a4ab77cc976ec484d13317b14422a754e2f1d4e8" %} [Get Started](/docs/fr/nouveau/studio/start.md) {% endcontent-ref %} {% endtab %} {% endtabs %} ### Mettre à jour Unsloth Studio Pour mettre à jour Unsloth Studio, utilisez : {% code overflow="wrap" %} ```bash unsloth studio update ``` {% endcode %} Si cela ne fonctionne pas, vous pouvez utiliser ce qui suit : #### **MacOS, Linux, WSL :** ```bash curl -fsSL https://unsloth.ai/install.sh | sh ``` #### **Windows PowerShell :** ```bash irm https://unsloth.ai/install.ps1 | iex ``` ## Exigences système ### Fenêtre**s** Unsloth Studio fonctionne directement sous Windows sans WSL. Pour entraîner des modèles, assurez-vous que votre système satisfait à ces exigences : **Exigences** * Windows 10 ou Windows 11 (64 bits) * GPU NVIDIA avec pilotes installés * **Programme d'installation d'applications** (inclut `winget`): [ici](https://learn.microsoft.com/en-us/windows/msix/app-installer/install-update-app-installer) * **Git**: `winget install --id Git.Git -e --source winget` * **Python**: version 3.11 jusqu'à, mais sans inclure, 3.14 * Travaillez dans un environnement Python tel que **uv**, **venv**, ou **conda/mamba** ### MacOS Unsloth Studio fonctionne sur les appareils Mac pour [Chat](#run-models-locally) pour les modèles GGUF et [Recettes de données](/docs/fr/nouveau/studio/data-recipe.md) ([Exportation](/docs/fr/nouveau/studio/export.md) à venir très bientôt). **L'entraînement MLX arrive bientôt !** * macOS 12 Monterey ou plus récent (Intel ou Apple Silicon) * Installez Homebrew : [ici](https://brew.sh/) * Git : `brew install git` * cmake : `brew install cmake` * openssl : `brew install openssl` * Python : version 3.11 jusqu'à, mais sans inclure, 3.14 * Travaillez dans un environnement Python tel que **uv**, **venv**, ou **conda/mamba** ### Linux et WSL * Ubuntu 20.04+ ou distribution similaire (64 bits) * GPU NVIDIA avec pilotes installés * Kit d'outils CUDA (12.4+ recommandé, 12.8+ pour Blackwell) * Git : `sudo apt install git` * Python : version 3.11 jusqu'à, mais sans inclure, 3.14 * Travaillez dans un environnement Python tel que **uv**, **venv**, ou **conda/mamba** ### Docker {% hint style="success" %} Notre image Docker fonctionne maintenant pour Studio ! Nous travaillons sur la compatibilité Mac. {% endhint %} * Récupérez la dernière image de conteneur Unsloth : `docker pull unsloth/unsloth` * Exécutez le conteneur via : ```bash 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 ``` Pour plus d'informations, [voir ici](https://hub.docker.com/r/unsloth/unsloth#unsloth-docker-image). * Accédez à votre instance Studio à `http://localhost:8000` ou à l'adresse IP externe `http://external_ip_address:8000/` ### CPU uniquement Unsloth Studio prend en charge les appareils CPU pour [Chat](#run-models-locally) pour les modèles GGUF et [Recettes de données](/docs/fr/nouveau/studio/data-recipe.md) ([Exportation](/docs/fr/nouveau/studio/export.md) à venir très bientôt) * Les mêmes que ceux mentionnés ci-dessus pour Linux (sauf les pilotes GPU NVIDIA) et MacOS. ## Installation pour développeur (avancée) ### **Installation du dépôt principal** #### **installations pour 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 pour développeur sous 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 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 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_studio` * Windows (PowerShell) : `Remove-Item -Recurse -Force "$HOME\.unsloth\studio\unsloth_studio"` Cela supprime l'application mais conserve intacts vos points de contrôle de modèles, exports, historique, cache et conversations. #### **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 → Informations système → Paramètres système avancés → Variables d'environnement, recherchez `Path` dans Variables utilisateur, et supprimez l'entrée pointant vers `.unsloth\studio\...\Scripts`. #### **4. Tout supprimer (facultatif)** Pour supprimer également l'historique, le cache, les conversations, les points de contrôle des modèles et les exports de modèles, 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èles 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 commandes `rm -rf` va **tout supprimer**, y compris votre historique, cache, conversations, etc. {% endhint %} ### **Suppression des fichiers de modèle HF en cache** Vous pouvez supprimer d'anciens fichiers de modèle soit via l'icône de corbeille dans la recherche de modèles, soit en supprimant le dossier de modèle en cache correspondant du 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\` sous 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. ### Utilisation d'anciens modèles GGUF / déjà existants {% columns %} {% column %} **Mise à jour du 1er avril :** Vous pouvez maintenant sélectionner un dossier existant à partir duquel Unsloth doit détecter. **Mise à jour du 27 mars :** Unsloth Studio détecte désormais **automatiquement les modèles plus anciens / préexistants** téléchargés depuis Hugging Face, LM Studio, etc. {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} **Instructions manuelles :** Unsloth Studio détecte les modèles téléchargés dans votre cache Hugging Face Hub `(C:\Users{votre_nom_utilisateur}.cache\huggingface\hub)`. Si vous avez téléchargé des modèles GGUF via LM Studio, notez qu'ils sont stockés dans `C:\Users{votre_nom_utilisateur}.cache\lm-studio\models` ***OU*** `C:\Users{votre_nom_utilisateur}\lm-studio\models` . Parfois, lorsqu'ils ne sont pas visibles, vous devrez déplacer ou copier ces fichiers .gguf dans votre répertoire de cache Hugging Face Hub (ou dans un autre chemin accessible à llama.cpp) pour qu'Unsloth Studio puisse les charger. Après avoir affiné un modèle ou un adaptateur dans Studio, vous pouvez l'exporter en GGUF et exécuter une inférence locale avec **llama.cpp** directement dans le chat de Studio. Unsloth Studio est alimenté par llama.cpp et Hugging Face. ### Notebook Google Colab Nous avons créé un [notebook Google Colab gratuit](https://colab.research.google.com/github/unslothai/unsloth/blob/main/studio/Unsloth_Studio_Colab.ipynb) afin que vous puissiez explorer toutes les fonctionnalités d'Unsloth sur les GPU T4 de Colab. Vous pouvez entraîner et exécuter la plupart des modèles jusqu'à 22 milliards de paramètres, et passer à un GPU plus grand pour des modèles plus volumineux. Il suffit de cliquer sur « Exécuter tout » et l'interface devrait apparaître après l'installation. {% columns %} {% column %} {% embed url="" %} Une fois l'installation terminée, faites défiler jusqu'à **Démarrer Unsloth Studio** et cliquez sur **Ouvrir Unsloth Studio** dans la case blanche affichée à gauche : **Faites défiler davantage vers le bas pour voir l'interface réelle.** {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% hint style="warning" %} Parfois, le lien Studio peut renvoyer une erreur. Cela se produit parce que vous avez peut-être désactivé les cookies ou que vous utilisez un bloqueur de publicités ou Mozilla. Vous pouvez toujours accéder à l'interface en faisant défiler sous le bouton. Google Colab s'attend également à ce que vous restiez sur la page Colab ; s'il détecte une inactivité, il peut arrêter la session GPU. {% endhint %} ## Dépannage

Problème	Correction
Erreur de version de Python	`sudo apt install python3.12 python3.12-venv` version 3.11 jusqu'à, mais sans inclure, 3.14
`nvidia-smi introuvable`	Installez les pilotes NVIDIA depuis https://www.nvidia.com/Download/index.aspx
`nvcc introuvable` (CUDA)	`sudo apt install nvidia-cuda-toolkit` ou ajoutez `/usr/local/cuda/bin` au PATH
échec de la compilation de llama-server	Non critique, Studio fonctionne toujours, l'inférence GGUF ne sera pas disponible. Installez `cmake` et relancez la configuration pour corriger le problème.
`cmake introuvable`	`sudo apt install cmake`
`git introuvable`	`sudo apt install git`
Échec de la compilation	Supprimez `~/.unsloth/llama.cpp` et relancez la configuration

--- # 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/nouveau/studio/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.