# Installer Unsloth sur MacOS

Pour installer Unsloth localement sur votre appareil Apple MacOS local, suivez les étapes ci-dessous :

### Installer Unsloth

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

Utilisez la même commande pour mettre à jour ou utiliser `unsloth studio update`.

### Lancer

Chaque fois que vous voulez relancer Unsloth :

```bash
unsloth studio -H 0.0.0.0 -p 8888
```

Pour des instructions détaillées sur l’installation d’Unsloth Studio et les exigences, [consultez notre guide](https://unsloth.ai/docs/fr/nouveau/studio/install).

### Désinstaller

Pour désinstaller Unsloth Studio sur macOS, suivez ces 4 étapes :

#### **1. Supprimer l’application**

* MacOS, Linux : `rm -rf ~/.unsloth/studio/unsloth ~/.unsloth/studio/studio`

Cela supprime l’application mais conserve intacts vos points de contrôle de modèle, exportations, historique, cache et discussions.

#### **2. Supprimer les raccourcis et les liens symboliques**

**macOS :**

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

#### **3. Supprimer la commande CLI**

**macOS, Linux :**

```bash
rm -f ~/.local/bin/unsloth
```

#### **4. Tout supprimer (facultatif)**

Pour supprimer également l’historique, le cache, les discussions, les points de contrôle de modèle et les exportations de modèle, supprimez l’intégralité du dossier Unsloth :

* MacOS, Linux : `rm -rf ~/.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, votre cache, vos discussions, etc.
{% endhint %}

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 :

{% 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 %}

### **Suppression des fichiers de modèle**

Vous pouvez supprimer d’anciens fichiers de modèle soit depuis l’icône de corbeille dans la recherche de modèles, soit en supprimant le dossier de modèle mis en cache correspondant dans le répertoire du cache Hugging Face.

L’emplacement du cache par défaut est :

{% code expandable="true" %}

```bash
~/.cache/huggingface/hub/
```

{% endcode %}

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. Vous pouvez vérifier avec :

{% code expandable="true" %}

```bash
echo ${HF_HUB_CACHE:-${HF_HOME:-${XDG_CACHE_HOME:-$HOME/.cache}/huggingface}/hub}
```

{% endcode %}

Pour supprimer un modèle spécifique, supprimez son dossier (par ex. `models--unsloth--Llama-3.1-8B-bnb-4bit`) du répertoire du cache. Pour vider tous les modèles mis en cache :

{% code expandable="true" %}

```bash
rm -rf ~/.cache/huggingface/hub/
```

{% 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/mac.md?ask=<question>
```

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.