Info::IA:: Mode d'emploi du plugin vim llama
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 entierShift+Tab— accepter uniquement la première ligne<leader>ll]— accepter uniquement le premier motCtrl+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'instructionTab— accepter le résultat de l'instructionEsc— 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.