# Comment fine-tuner des LLMs dans VS Code avec Unsloth et les GPU Colab

Vous pouvez désormais affiner des LLM directement depuis Visual Studio Code (VS Code), localement ou en utilisant l'extension Google Colab. Dans ce guide, vous apprendrez à utiliser l'entraînement open source [dépôt : Unsloth](https://github.com/unslothai/unsloth), pour connecter n'importe quel [carnet de fine-tuning](https://unsloth.ai/docs/fr/commencer/unsloth-notebooks) dans VS Code à un runtime Colab, afin que vous puissiez entraîner sur votre GPU local ou sur le GPU gratuit de Colab. Vous pouvez aussi regarder notre tutoriel vidéo [ici](#video-tutorial).

{% stepper %}
{% step %}

### Tutoriel VS Code et Colab :

Pour commencer, nous aurons besoin de :

* Installé [VS Code](https://code.visualstudio.com/). Git (pour cloner le dépôt du notebook) devrait être installé par défaut.
* Un **compte Google** (pour s'authentifier avec Colab)
* Recommandé : **Jupyter** extension (la plupart des configurations VS Code l'ont déjà)
  {% endstep %}

{% step %}

#### Installez l'extension Colab dans VS Code

1. Ouvrez **Extensions** dans VS Code (`Ctrl+Shift+X` / `Cmd+Shift+X`)
2. Recherchez **« Colab »** et installez **l'extension Google Colab** extension

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FJ1f5BS4EK0ok5QLy6vz5%2Fcolab_img_1.png?alt=media&#x26;token=1faa7aac-c016-4c31-90ba-ccad655244e1" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Ouvrir un notebook Unsloth

1. Clonez le dépôt [de notebooks Unsloth](https://github.com/unslothai/notebooks):

```bash
git clone https://github.com/unslothai/notebooks
cd notebooks/nb
```

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FwRL8pvgtLRpz5rcmS6vy%2FScreenshot%202026-02-18%20at%206.29.16%E2%80%AFPM.png?alt=media&#x26;token=7a72c2ec-6f94-4015-8355-27e76ba9b974" alt="" width="375"><figcaption></figcaption></figure>

2. Ouvrez le notebook souhaité. Unsloth prend en charge la plupart des modèles, y compris [l'embedding](https://unsloth.ai/docs/fr/bases/embedding-finetuning), [TTS](https://unsloth.ai/docs/fr/bases/text-to-speech-tts-fine-tuning). Par exemple, nous utiliserons Qwen3-4B RL : `nb/Qwen3_(4B)-GRPO.ipynb`

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FleZtIzyflSgi1o1QcZDU%2Fcolab_img_2.png?alt=media&#x26;token=805ebe8b-cb50-49a4-83d4-0daf96ad21c1" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Sélectionnez un noyau et choisissez Colab

Dans la barre d'outils du notebook, cliquez sur **Sélectionner le noyau**, puis choisissez **Colab**

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FleGtAKSVehrlspPGvDy2%2Fcolab_img_3.png?alt=media&#x26;token=ba3d8f1d-9cbb-44ed-8e52-8d0e52280607" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Ajouter un nouveau serveur Colab

Après avoir choisi **Colab**, vous verrez un menu déroulant avec des options de serveur.

1. Cliquez **+ Ajouter un nouveau serveur Colab**
2. La première fois, une fenêtre de navigateur peut s'ouvrir pour l'authentification Google
   * Connectez-vous, accordez l'accès, puis revenez à VS Code

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FZcDsB2i0aUStIKEeFTvF%2Fcolab_img_4.png?alt=media&#x26;token=a7c3642f-db35-4215-933f-99c17ebc92a2" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Sélectionnez le GPU et nommez le serveur

1. Définissez **Accélérateur matériel** sur **GPU**
2. Choisissez un type de GPU (par exemple **T4**, si disponible)
3. Donnez un nom au serveur (n'importe quel nom de votre choix)

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FLuK8oheihdCNn9MAZSlk%2Fcolab_img_5.png?alt=media&#x26;token=e5ed396f-afe2-4c09-b1b8-120c7301793c" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Remarque : la disponibilité des GPU dépend de votre plan Colab et de la capacité actuelle. Si vous ne voyez pas d'options GPU, consultez le dépannage ci-dessous.
{% endhint %}
{% endstep %}

{% step %}

#### Choisir le noyau Python

Une fois connecté au serveur Colab, sélectionnez le **noyau Python** qui apparaît pour ce runtime (généralement un noyau Python 3).

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FBexUiXJ7LRFBXs95tX2S%2Fcolab_img_6.png?alt=media&#x26;token=391e343d-d2fa-4a77-8e3f-ef244adfcb4c" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Exécuter le notebook

* Cliquez **Exécuter tout** dans la barre d'outils du notebook (ou exécutez les cellules de haut en bas)
* Regardez les cellules de configuration installer les dépendances puis lancer le workflow Unsloth
* Vous pouvez consulter nos guides dédiés [de fine-tuning](https://unsloth.ai/docs/fr/commencer/fine-tuning-llms-guide) ou [d'apprentissage par renforcement](https://unsloth.ai/docs/fr/commencer/reinforcement-learning-rl-guide) pour plus d'informations sur la manière de commencer précisément avec Unsloth.
  {% endstep %}
  {% endstepper %}

### Tutoriel vidéo

{% embed url="<https://youtu.be/5NNggTrEWNQ>" %}

### Dépannage

#### Après la déconnexion du serveur Colab, le notebook ne s'exécute pas sur un nouveau serveur

**Ce qui se passe :**\
Si le notebook reste ouvert pendant la déconnexion du serveur Colab, VS Code peut rester bloqué dans un mauvais état de noyau/runtime après la reconnexion. Problème lié sur [le dépôt GitHub](https://github.com/googlecolab/colab-vscode/issues/200).

**Correction :** Fermez complètement l'onglet du notebook et ouvrez de nouveau le notebook.

#### Vous ne pouvez pas sélectionner un GPU (seul le CPU apparaît)

Causes possibles et solutions :

* **Capacité du niveau gratuit de Colab :** Les GPU peuvent être temporairement indisponibles → réessayez plus tard.
* **Pas réellement connecté à un runtime Colab :** vérifiez de nouveau **Sélectionner le noyau → Colab** et assurez-vous qu'un serveur Colab est actif.
* **Restrictions de compte/région ou limites atteintes :** vous devrez peut-être attendre ou utiliser un autre compte Google / un autre plan.

#### Tout a fonctionné, mais les paquets ont “disparu” après la reconnexion

Les runtimes Colab sont **éphémères**. Lorsqu'un serveur redémarre, vous devez généralement relancer les cellules de configuration/d'installation (souvent les premières cellules du notebook).


---

# 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/vs-code.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.