Info::IA:: Mode d'emploi du plugin vim llama

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: LLAMA, VIM, PLUSGIN

Le 11/09/2026:

llama.vim

Dépôt : ggml-org/llama.vim

Installation locale : plugin natif vim8, cloné dans ~/.vim/pack/vendor/start/llama.vim (chargement automatique au démarrage de vim, sans plugin manager).

Rôle : complétion de code par FIM (Fill-In-the-Middle) et édition de sélection par instruction, en s'appuyant sur un ou plusieurs serveurs llama-server (llama.cpp).

Configuration locale (~/.vimrc) :

let g:llama_config = {
    \ 'endpoint_fim': 'http://hal:8012/infill',
    \ }

Le serveur FIM tourne sur la machine hal, port 8012 (port par défaut du plugin, hôte non local). L'endpoint d'instruction (endpoint_inst) n'est pas surchargé et reste à sa valeur par défaut (http://127.0.0.1:8012/v1/chat/completions).

Raccourcis par défaut

Touche leader : <leader> est un préfixe configurable de vim/nvim (variable g:mapleader), utilisé pour éviter les conflits avec les raccourcis natifs. Elle n'est définie ni dans .vimrc ni par le plugin, donc elle vaut ici la valeur par défaut de vim : \ (backslash). Concrètement, <leader>lli s'obtient en tapant \lli (backslash puis l, l, i), à la suite, en mode Normal/Visuel.

Mode Insertion

  • Tab — accepter la suggestion FIM en entier
  • Shift+Tab — accepter uniquement la première ligne
  • <leader>ll] — accepter uniquement le premier mot
  • Ctrl+H — passer à la complétion précédente (si plusieurs

disponibles)

  • Ctrl+L — passer à la complétion suivante
  • <leader>llf — déclencher manuellement la complétion FIM

Mode Visuel

  • <leader>lli — déclencher l'édition par instruction

(mode « instruct ») sur la sélection

Mode Normal

  • <leader>llr — relancer l'instruction
  • <leader>llc — continuer l'instruction
  • Tab — accepter le résultat de l'instruction
  • Esc — annuler l'instruction
  • <leader>lld — afficher/masquer le panneau de debug

Commandes

:LlamaEnable / :LlamaDisable / :LlamaToggle

Active, désactive, ou bascule les autocommandes et raccourcis du plugin pour la session vim en cours.

Exemple : :LlamaDisable

:LlamaToggleAutoFim

Bascule la complétion FIM automatique (déclenchée à la frappe) pour la session en cours, sans toucher au reste du plugin.

Exemple : :LlamaToggleAutoFim

:LlamaStatus

Affiche la disponibilité des modèles FIM et instruction sur le(s) serveur(s) configuré(s), ainsi que le profil actif le cas échéant.

Exemple : :LlamaStatus

:LlamaProfile [nom]

Sans argument : liste le profil actif et les profils nommés disponibles (définis via g:llama_config.profiles). Avec un nom de profil (complétion en ligne de commande disponible), bascule à la fois l'endpoint FIM et l'endpoint instruction sur ce profil.

Exemple : :LlamaProfile spark

:LlamaProfileReset

Abandonne le profil sélectionné en session et restaure les endpoints (profil ou endpoint_fim/endpoint_inst explicites) tels que définis au chargement de llama.vim, normalement dans .vimrc.

Exemple : :LlamaProfileReset

:LlamaInstruct

Déclenche l'édition par instruction sur le texte sélectionné. Équivalent en mode visuel du raccourci <leader>lli.

Exemple (en mode visuel, sur une sélection) : :LlamaInstruct

:LlamaDebugToggle / :LlamaDebugClear

Affiche/masque le panneau de debug, ou en vide les logs.

Exemple : :LlamaDebugToggle

Pièges

  • Deux endpoints distincts : endpoint_fim (complétion,

modèle FIM-compatible) et endpoint_inst (édition par instruction, modèle instruct-compatible) peuvent pointer vers des serveurs llama-server différents. Ici seul l'endpoint FIM est repointé vers hal:8012 ; vérifier où tourne le service d'instruction avant d'utiliser <leader>lli.

  • Modèle requis côté serveur : le serveur FIM doit être lancé avec

un modèle compatible FIM (ex. Qwen3 Coder) et les options adaptées (--port 8012 -fa --cache-reuse 256, etc.) ; un modèle generaliste sans support FIM répondra à /health mais pas correctement à /infill.

  • Pas de vérification d'auth : comme pour pcClaude,

rien n'indique que llama-server vérifie une clé API ; ne pas exposer ces ports au-delà du réseau local de confiance.