Installation d'Unsloth Studio

Unsloth Studio fonctionne sur Windows, Linux, WSL et MacOS. Vous devriez utiliser le même processus d'installation sur chaque appareil, bien que les exigences système puissent différer selon l'appareil.

Installer avec Unsloth Desktop

La façon la plus simple d'installer Unsloth Studio est d'utiliser l'application native Desktop. Téléchargez-la pour votre système d'exploitation :

• Télécharger pour macOS

• Télécharger pour Windows

• Télécharger pour Linux

Le reste de cette page installe Unsloth Studio manuellement.

Installation manuelle d'Unsloth Studio

WindowsMacOSLinux et WSLDockerInstallation pour développeurs

• Mac : Comme le CPU - le chat + Recettes de données fonctionne pour l'instant. MLX l'entraînement fonctionne maintenant !

• CPU : Unsloth fonctionne toujours sans GPU, mais pour le Chat + les recettes de données.

• Entraînement : Fonctionne sur NVIDIA, Intel, AMD GPU et appareils Mac

Démarrage rapide

MacOS

Windows

Linux, WSL

Étape 1 : Configurer Unsloth

Lancez le terminal sur Mac, puis installez Unsloth en saisissant la commande ci-dessous.

Copier

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

Unsloth commencera à configurer l'environnement et à installer les paquets requis comme indiqué ci-dessous. Tapez Y et appuyez sur Entrée lorsqu'on vous demande si vous souhaitez autoriser Unsloth à démarrer maintenant. Cela lancera Unsloth sur votre local 8888 port.

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 par des clients en dehors de votre PC/ordinateur, ajoutez -H 0.0.0.0 à unsloth studio commande.

Étape 2 : Démarrer Unsloth

Ouvrez le navigateur de votre choix et accédez à l' http://127.0.0.1:8888 URL. Si c'est la première fois que vous installez Unsloth, il vous sera demandé de créer un nouveau mot de passe. Ensuite, l'application Unsloth devrait s'ouvrir sur la page Chat comme indiqué ci-dessous.

Lancez Unsloth en toute sécurité avec HTTPS et Cloudflare. Unsloth propose désormais une manière sécurisée de lancer Unsloth via HTTPS à l'aide d'un tunnel Cloudflare gratuit. Utilisez ce qui suit (fonctionne sous Windows, Mac et Linux) :

Vous pouvez commencer à entraîner et à exécuter des modèles immédiatement. Vous pouvez consulter notre guide plus détaillé étape par étape pour commencer ci-dessous :

Get Started

Étape 1 : Configurer Unsloth

Ouvrez le menu Démarrer, recherchez PowerShell, puis lancez-le. Copiez et collez la commande d'installation ci-dessous :

l'installation commencera automatiquement. Une fois l'installation terminée, PowerShell vous demandera si vous souhaitez démarrer Unsloth Studio.

Vous pouvez également le lancer avec la commande suivante :

Si vous souhaitez que votre instance soit accessible par des clients en dehors de votre PC/ordinateur. Ajoutez -H 0.0.0.0 à unsloth studio commande.

Étape 2 : Démarrer Unsloth

Ouvrez http://127.0.0.1:8888 dans votre navigateur. Lors du 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.

Lancez Unsloth en toute sécurité avec HTTPS et Cloudflare. Unsloth propose désormais une manière sécurisée de lancer Unsloth via HTTPS à l'aide d'un tunnel Cloudflare gratuit. Utilisez ce qui suit (fonctionne sous Windows, Mac et Linux) :

Vous pouvez commencer à entraîner et à exécuter des modèles immédiatement. Vous pouvez consulter notre guide plus détaillé étape par étape pour commencer ci-dessous :

Get Started

Étape 1 : Configurer Unsloth

Linux

WSL

Ouvrez votre application de terminal. Vous pouvez la lancer en appuyant sur Ctrl + Alt + T, ou en recherchant Terminal dans le menu des applications de votre système.

Cliquez sur le menu Démarrer de Windows, saisissez le nom de votre distribution installée (par ex. Ubuntu), puis ouvrez-la.

Sur WSL, assurez-vous que vos les pilotes NVIDIA sont installés sur Windows (pas dans WSL) et que le kit d'outils CUDA est installé dans votre distribution WSL. Consultez les exigences système ci-dessous pour plus de détails.

Pour installer, copiez et exécutez la commande d'installation :

Ensuite :

1. Cliquez dans la fenêtre du terminal

2. Collez la commande avec Ctrl + Shift + V

3. Appuyez sur Entrée

Unsloth commencera à configurer l'environnement et à installer les paquets requis comme indiqué ci-dessous. Tapez Y et appuyez sur Entrée lorsqu'on vous demande si vous souhaitez autoriser Unsloth à démarrer maintenant. Cela lancera Unsloth sur votre local 8888 port.

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 par des clients en dehors de votre PC/ordinateur, ajoutez -H 0.0.0.0 à unsloth studio commande.

Étape 2 : Démarrer Unsloth

Ouvrez le navigateur de votre choix et saisissez http://127.0.0.1:8888 dans la barre d'URL. Si c'est la première fois que vous installez Unsloth, vous serez redirigé vers http://127.0.0.1:8888/change-password la page comme indiqué ci-dessous :

Lancez Unsloth en toute sécurité avec HTTPS et Cloudflare. Unsloth propose désormais une manière sécurisée de lancer Unsloth via HTTPS à l'aide d'un tunnel Cloudflare gratuit. Utilisez ce qui suit (fonctionne sous Windows, Mac et Linux) :

Vous pouvez commencer à entraîner et à exécuter des modèles immédiatement. Vous pouvez consulter notre guide plus détaillé étape par étape pour commencer ci-dessous :

Get Started

Mettre à jour Unsloth Studio

Pour mettre à jour Unsloth Studio, utilisez les mêmes commandes que pour l'installation :

macOS, WSL, Linux :

Windows (PowerShell) :

Exigences système

Fenêtres

Unsloth Studio fonctionne directement sur 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

• Installateur d'applications (inclut winget): ici

• 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 le chat et l'entraînement et toutes les fonctionnalités. Vous pouvez exécuter des modèles MLX avec Unsloth.

• macOS 12 Monterey ou plus récent (Intel ou Apple Silicon)

• 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

• Récupérez notre dernière image de conteneur Unsloth : docker pull unsloth/unsloth

• Lancez le conteneur via :

Pour plus d'informations, voir ici.

• 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 le chat pour les modèles GGUF et Recettes de données (Exporter (arrive très bientôt)

• Identiques à ceux mentionnés ci-dessus pour Linux (sauf pour les pilotes GPU NVIDIA) et MacOS.

Installations développeur / nightly (avancées)

Installation du dépôt principal

Installations pour développeurs sur macOS, Linux, WSL :

Pour installer dans un emplacement isolé (son propre environnement virtuel, auth/, studio.db, cache et compilation de llama.cpp), définissez UNSLOTH_STUDIO_HOME et transmettez-le à nouveau au lancement :

Puis pour mettre à jour :

Installations pour développeurs sur Windows PowerShell :

Pour installer dans un emplacement isolé (son propre environnement virtuel, auth/, studio.db, cache et compilation de llama.cpp), définissez UNSLOTH_STUDIO_HOME et transmettez-le à nouveau au lancement :

Puis pour mettre à jour :

Accès distant : --secure (tunnel HTTPS) contre port brut

Par défaut unsloth studio écoute sur 127.0.0.1 (cette machine uniquement). Pour y accéder depuis un autre appareil, choisissez l'une des options suivantes :

• --secure (recommandé) : servir uniquement via un lien HTTPS Cloudflare gratuit. Unsloth reste lié à localhost et le tunnel fournit l'URL publique ; il échoue en mode fermé (ne démarre pas) si le tunnel ne peut pas être établi, donc le port brut n'est jamais exposé.

• -H 0.0.0.0: lier le port brut à toutes les interfaces réseau, accessible depuis n'importe où sur le réseau. N'utilisez cela que sur un réseau de confiance.

Les outils côté serveur (recherche web, exécution de code Python et de terminal) s'exécutent sous votre utilisateur et sont activés par défaut. Toute personne pouvant atteindre le serveur avec la clé API peut exécuter du code sur cette machine, alors gardez votre clé API privée et transmettez --disable-tools lors de l'exposition d'Unsloth.

Méthodes de lancement avancées

Les options de l'installateur peuvent être transmises sous forme de variables d'environnement. Sur macOS, Linux et WSL, placez la variable après le pipe afin que le shell la transmette à sh; sur Windows, définissez-la avec $env: avant de la rediriger vers iex.

Ignorer PyTorch (mode GGUF uniquement) :

Verrouiller la version de Python :

Installer à un emplacement personnalisé avec UNSLOTH_STUDIO_HOME:

Limitez les pools de threads CPU natifs d'Unsloth sur les hôtes à grand nombre de cœurs : UNSLOTH_CPU_THREADS=8 unsloth studio -p 8888.

Désinstaller

La manière recommandée de supprimer complètement Unsloth Studio est d'utiliser le script de désinstallation correspondant à votre système d'exploitation. Il arrête tous les serveurs en cours d'exécution, supprime le répertoire d'installation, le répertoire de données du lanceur, le raccourci de bureau et toutes les entrées spécifiques à la plateforme (macOS .app bundle + Launch Services sur Mac ; menu Démarrer, HKCU\Software\Unsloth clé de registre et entrées PATH utilisateur PATH sur Windows) :

•  MacOS, WSL, Linux :

•  Windows (PowerShell) :

Si vous souhaitez uniquement supprimer le répertoire d'installation et conserver le lanceur/raccourci pour une réinstallation ultérieure, vous pouvez à la place exécuter rm -rf ~/.unsloth/studio (Mac/Linux/WSL) ou Remove-Item -Recurse -Force "$HOME\.unsloth\studio" (Windows). Le cache du modèle à ~/.cache/huggingface n'est touché par aucune de ces opérations.

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"

4. Supprimer les raccourcis et les liens symboliques :

macOS :

Linux :

WSL / Windows (PowerShell) :

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, trouvez Path dans les variables utilisateur, et supprimez l'entrée pointant vers .unsloth\studio\...\Scripts.

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\<username>\.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 de cache par défaut.

Utilisation d'anciens modèles GGUF / existants

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.

Instructions manuelles : Unsloth Studio détecte les modèles téléchargés dans le cache de votre Hugging Face Hub (C:\Users{your_username}.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{your_username}.cache\lm-studio\models OU C:\Users{your_username}\lm-studio\models . Parfois, lorsqu'ils ne sont pas visibles, vous devrez déplacer ou copier ces fichiers .gguf dans le répertoire cache de votre 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 Unsloth, vous pouvez l'exporter au format GGUF et exécuter une inférence locale avec llama.cpp directement dans Unsloth Chat. Unsloth Studio est propulsé par llama.cpp et Hugging Face.

Notebook Google Colab

Nous avons créé un notebook Google Colab gratuit 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'à 22B de paramètres, et passer à un GPU plus grand pour les modèles plus volumineux. Cliquez simplement sur « Run all » et l'interface devrait apparaître après l'installation.

Google Colabcolab.research.google.com

Une fois l'installation terminée, faites défiler jusqu'à Démarrer Unsloth Studio et cliquez sur Ouvrir Unsloth Studio dans la boîte blanche affichée à gauche :

Faites défiler plus bas pour voir l'interface utilisateur réelle.

Dépannage