Aller au contenu
Cercle IA Tech · IA en local Un site du réseau Cercle IA Tech

Guide

llama.cpp : installer et lancer un modèle GGUF

llama.cpp, le moteur derrière beaucoup d'outils locaux : installation, lancement d'un modèle Hugging Face, serveur compatible OpenAI, options utiles.

Mis à jour le

llama.cpp est un moteur d'exécution de modèles de langage écrit en C/C++, publié sous licence MIT. Il lit les modèles au format GGUF, tourne sur processeur comme sur carte graphique, et fournit un serveur compatible avec l'interface d'OpenAI. Il est au cœur d'autres outils : la documentation de Hugging Face présente Ollama comme une application fondée sur llama.cpp, et LM Studio l'utilise comme moteur. Ce qui suit vient du dépôt officiel, lu le 15/11/2026.

Pourquoi passer par llama.cpp directement

  • Vous voulez le moteur seul, sans couche supplémentaire, pour l'intégrer dans votre propre logiciel.
  • Vous avez un matériel particulier : le dépôt liste de nombreux moteurs de calcul, dont Metal (Apple Silicon), CUDA (NVIDIA), HIP (AMD), Vulkan (cartes graphiques en général), SYCL, OpenCL et d'autres, ainsi qu'une compilation simple pour processeur, avec les jeux d'instructions AVX, AVX2, AVX512 et ARM NEON.
  • Vous voulez choisir finement la quantification : le dépôt annonce des quantifications entières sur 1,5, 2, 3, 4, 5, 6 et 8 bits (voir Quantification GGUF).

Installer

Le README propose plusieurs voies :

# avec curl
curl -LsSf https://llama.app/install.sh | sh
# avec PowerShell
irm https://llama.app/install.ps1 | iex

Autres possibilités : Docker, les binaires précompilés de la page des versions du dépôt, ou une compilation depuis les sources d'après le guide de compilation. Sur un serveur, lisez le script avant de l'exécuter.

Lancer un modèle

Le README montre deux commandes, écrites ainsi :

# Télécharger et lancer un modèle depuis Hugging Face
llama cli -hf ggml-org/Qwen3.5-0.8B-GGUF

# Lancer le serveur compatible avec l'interface d'OpenAI
llama serve -hf ggml-org/Qwen3.5-0.8B-GGUF

L'option -hf désigne un dépôt Hugging Face contenant des fichiers GGUF. Le catalogue des modèles GGUF de Hugging Face permet d'en trouver d'autres. Le README du serveur montre aussi la forme qui charge un fichier déjà téléchargé :

./llama-server -m models/7B/ggml-model.gguf -c 2048

Le serveur : les options à connaître

D'après le README du serveur :

Option Rôle Par défaut
--host adresses d'écoute 127.0.0.1
--port port d'écoute 9931
-c, --ctx-size taille du contexte 0, c'est-à-dire la valeur du modèle
-ngl, --n-gpu-layers nombre maximal de couches placées en mémoire vidéo : un nombre, auto ou all auto
--api-key clé exigée des clients, plusieurs possibles séparées par des virgules aucune

Le serveur expose notamment /v1/chat/completions, /v1/completions, /v1/models et /v1/embeddings, ainsi qu'une interface web intégrée. Deux réglages comptent pour un usage en entreprise :

  • --api-key : sans elle, aucune clé n'est demandée. Dès que le serveur est joignable par d'autres postes, définissez-en une.
  • -ngl : quand le modèle ne tient pas entièrement dans la carte graphique, une partie des couches reste sur le processeur. C'est possible, mais plus lent.

Fabriquer son propre fichier GGUF

Le dépôt fournit les outils pour convertir un modèle publié sur Hugging Face, puis le quantifier. La démarche (conversion avec convert_hf_to_gguf.py, puis llama-quantize) est détaillée sur Quantification GGUF. Hugging Face propose aussi un outil en ligne, gguf-my-repo, pour convertir et quantifier.

Appeler le serveur depuis un programme

Le README du serveur donne l'exemple d'un client Python pour l'interface d'OpenAI pointé sur http://localhost:9931/v1. Le principe commun à Ollama, LM Studio, llama.cpp et vLLM est expliqué sur Appeler un LLM local depuis son code.

Limites

  • Les commandes et options évoluent vite : la forme llama cli du README et l'ancien binaire llama-server coexistent dans la documentation lue. Vérifiez --help sur votre version.
  • llama.cpp ne gère ni comptes ni droits : pour une équipe, ajoutez un proxy et une interface comme Open WebUI.

Questions fréquentes

Sur quel port écoute le serveur de llama.cpp ?

D'après le README du serveur lu le 15/11/2026, il écoute par défaut sur 127.0.0.1, port 9931. Les options --host et --port changent ces valeurs.

Quelle est la licence de llama.cpp ?

Le dépôt affiche la licence MIT.

Quelle différence entre llama.cpp et Ollama ?

La documentation de Hugging Face décrit Ollama comme une application fondée sur llama.cpp. llama.cpp est le moteur ; Ollama ajoute la gestion des modèles et un service prêt à l'emploi.

Sources

Pages consultées pour écrire cet article :

  1. https://raw.githubusercontent.com/ggml-org/llama.cpp/master/README.md
  2. https://github.com/ggml-org/llama.cpp
  3. https://raw.githubusercontent.com/ggml-org/llama.cpp/master/tools/server/README.md
  4. https://huggingface.co/docs/hub/gguf
  5. https://huggingface.co/docs/hub/ollama

À lire aussi