Comment utiliser un LLM local dans Cursor
Cette note d’insights YouTube a été créée avec LilysAI. Inscrivez‑vous gratuitement et obtenez des insights 10× plus rapides et plus profonds à partir des vidéos.
Q: Comment utiliser un LLM local dans Cursor ?
Q: Quels sont les outils essentiels nécessaires ?
Ce guide explique comment intégrer un LLM local dans Cursor, en utilisant Olama pour exécuter des modèles sur votre machine et Enrok pour les rendre accessibles. Vous apprendrez à configurer Cursor pour utiliser ces modèles locaux, offrant ainsi une puissance de traitement privée et personnalisée pour vos tâches de développement.
1. Utilisation d'un LLM local dans Cursor
1.1. Installation et configuration d'Olama
- Télécharger et installer l'IDE Cursor
- Il est nécessaire de télécharger l'IDE Cursor depuis cursor.com et d'installer le logiciel correspondant au système d'exploitation de l'utilisateur.
- Télécharger et installer Olama
- Olama permet d'exécuter divers modèles de langage sur un système local.
- Le téléchargement se fait sur olama.com, suivi de l'exécution du programme d'installation adapté au système d'exploitation.
- Sous Windows, l'installation se résume à cliquer sur le bouton "Installer" dans l'interface du programme d'installation.
- Une fois installé, Olama s'exécute en arrière-plan, vérifiable via l'icône dans la barre d'état système Windows.
- La commande
olamadans un terminal (comme PowerShell) liste les commandes disponibles pour l'outil CLI Olama.
- Sélectionner et télécharger un modèle LLM
- Les modèles disponibles sont listés sur le site web d'Olama, dans la section "Modèles".
- Le modèle "Gemma 3 12B" est choisi car il est présenté comme performant sur un seul GPU.
- Pour télécharger un modèle, la commande
olama pull [nom_du_modèle]est utilisée. Par exemple,olama pull gemma:3b.
- Lancer le serveur Olama
- Pour rendre le modèle utilisable, il faut lancer l'application web avec la commande
olama serve. - Avant cela, il est nécessaire de définir la variable d'environnement
Olama_originssur*pour autoriser toutes les requêtes, quelle que soit leur origine. Sous Windows, cela se fait avecset OLLAMA_ORIGINS=*. - Si une erreur de liaison survient, il faut fermer l'instance Olama existante en cliquant sur "Quitter Olama" dans le menu contextuel de l'icône.
- Le serveur Olama s'exécute alors à l'URL
127.0.0.1:11434(localhost).
- Pour rendre le modèle utilisable, il faut lancer l'application web avec la commande
1.2. Configuration d'Enrok pour l'accessibilité en ligne
- Comprendre la limitation de Cursor avec localhost
- Cursor ne permet pas d'utiliser directement l'hôte local (
localhost) comme point de terminaison accessible. - Le point de terminaison doit être en ligne et accessible de partout.
- Cursor ne permet pas d'utiliser directement l'hôte local (
- Télécharger et installer Enrok
- Enrok est un outil qui transforme un hôte local en une URL accessible en ligne.
- Le téléchargement se fait depuis la page de téléchargement d'Enrok, en sélectionnant le programme d'installation pour le système d'exploitation.
- Il est nécessaire de placer le fichier exécutable d'Enrok dans la variable d'environnement PATH du système, ou d'y faire référence via son chemin complet.
- Configurer Enrok avec un jeton d'authentification
- Enrok nécessite la création d'un compte gratuit pour obtenir un jeton API (token) et authentifier l'outil CLI.
- Le jeton peut être obtenu après connexion via un compte Google ou GitHub, ou via le processus d'inscription.
- Le jeton est ensuite configuré dans le terminal en utilisant la commande
enrok config set api-token [votre_token].
- Exécuter Enrok pour exposer le serveur Olama
- La commande pour exécuter Enrok est
enrok http --host-header=localhost:11434. - Cette commande génère une nouvelle URL accessible en ligne qui redirige vers le serveur Olama local.
- La commande pour exécuter Enrok est
1.3. Intégration de l'URL Enrok dans Cursor
- Ajouter le modèle LLM dans Cursor
- Ouvrir Cursor et accéder aux paramètres via l'icône d'engrenage en haut à droite.
- Naviguer vers la section "Modèles" et cliquer sur "Ajouter un modèle".
- Entrer le nom du modèle téléchargé (par exemple, "Gemma 3 col 12B") et cliquer sur "Ajouter un modèle".
- Configurer l'URL de base pour le modèle
- Dans la section des modèles, trouver l'option pour remplacer l'URL de base d'OpenAI.
- Coller l'URL fournie par Enrok, en ajoutant
/v1à la fin (par exemple,https://votre-url-enrok.com/v1). - La clé API par défaut est "ollama", il n'est donc pas nécessaire de la modifier.
- Cliquer sur le bouton "Enregistrer".
- Vérifier la connexion du modèle
- Cliquer sur le bouton de vérification pour tester la connexion.
- Un message demandant d'activer la clé API OpenAI peut apparaître ; cliquer sur le bouton pour l'activer.
- Si une erreur 404 se produit, cela peut être dû à une requête tentant d'utiliser un modèle non téléchargé (comme GPT40).
- Pour résoudre ce problème, désélectionner tous les autres modèles dans Cursor, ne laissant que le modèle désiré (par exemple, "Gemma 3 12B").
- Cliquer à nouveau sur vérifier et activer la clé API OpenAI.
- Une fois la vérification réussie, le système s'allume automatiquement, indiquant que le modèle local est prêt à être utilisé sans clé OpenAI externe.
1.4. Utilisation du LLM local dans Cursor
- Sélectionner le modèle LLM local
- En haut à droite de Cursor, sélectionner le modèle LLM local configuré (par exemple, "Gemma 3 12B").
- Interagir avec le LLM
- Poser une question au LLM, par exemple : "À quoi sert un fichier compressé ?".
- Le LLM local génère une réponse, démontrant son bon fonctionnement.
- Il est possible d'ajouter du contexte, comme le nom d'un fichier spécifique (
compression.go).
- Conclusion sur l'installation locale
- L'installation fonctionne en local, bien que l'URL Enrok soit en ligne, ce qui signifie que ce n'est pas une configuration complètement hors ligne.
- Il est possible d'utiliser n'importe quel modèle disponible dans Olama avec cette configuration.
- Cursor est maintenant configuré pour utiliser un LLM local.
Comprenez d’énormes quantités d’informations comme un génie — avec LilysAI
Plus d’un million de chercheurs de connaissances utilisent Lilys AI.
