Codexa Documentation

Introduction

Présentation#

Assistant IA Local est une intelligence artificielle qui s'exécute entièrement en local. Aucun serveur distant, aucun compte, aucun abonnement : le modèle est téléchargé une seule fois, puis fonctionne indéfiniment sur votre machine.

Cette approche la rend particulièrement adaptée à un usage quotidien, y compris sur des configurations modestes.

• Pas besoin de connexion internet
• Les données restent sur la machine
• Fonctionnement rapide
• Plus léger qu'une solution cloud
• Adapté aux machines moins puissantes
• Utilisable comme assistant personnel quotidien

Fonctionnalités

Caractéristiques principales#

Cinq domaines de compétence couvrent l'essentiel des besoins d'un assistant au quotidien.

Cas d'usage

Utilisations#

Un aperçu complet de ce que l'assistant peut prendre en charge, du développement logiciel aux tâches de tous les jours.

Guide

Installer Ollama#

Avant d'installer une IA, installez Ollama, le moteur qui exécute les modèles en local. Une seule commande suffit : aucune dépendance à préparer.

Linux (Ubuntu / Debian par exemple)

$ curl -fsSL https://ollama.com/install.sh | sh

Cela installe :

• le binaire ollama
• le service Ollama
• les composants nécessaires pour exécuter les modèles

Vérifier l'installation

Vous devriez obtenir quelque chose comme :

$ ollama --version
ollama version 0.x.x

Vérifier que le serveur Ollama tourne

Sous Linux, vérifiez l'état du service :

$ systemctl status ollama

Si nécessaire, démarrez-le :

$ systemctl start ollama

Sinon, vous pouvez lancer le serveur directement :

$ ollama serve

Ollama écoute généralement sur http://localhost:11434.

Installation minimale complète (Linux)

En pratique, ces quatre commandes suffisent pour partir de zéro :

$ curl -fsSL https://ollama.com/install.sh | sh
$ ollama --version
$ ollama run mistral
$ ollama list

Guide

Installer une IA#

À ce stade, aucune IA n'est encore installée. Téléchargez un modèle avec la commande ollama pull : il est installé une seule fois, puis reste disponible hors ligne.

$ ollama pull NOM_DE_L_IA

Télécharge et installe un modèle IA local.

$ ollama pull mistral

Télécharge le modèle Mistral.

Guide

Utiliser une IA#

Une fois le modèle installé, lancez-le directement depuis le terminal.

$ ollama run NOM_DE_L_IA

Lance l'intelligence artificielle choisie.

Une session de discussion interactive s'ouvre dans le terminal. Tapez /bye pour quitter la session.

$ ollama run mistral

Guide

Gestion des modèles#

Toutes les commandes nécessaires pour lister, arrêter, supprimer et contrôler les modèles installés.

Voir les IA installées

Affiche tous les modèles présents sur la machine, avec leur taille et leur date d'installation.

$ ollama list

Voir l'IA actuellement chargée en mémoire

Affiche le ou les modèles actuellement chargés en mémoire vive.

$ ollama ps

Arrêter une IA

Décharge le modèle de la mémoire. Le modèle reste installé et peut être relancé à tout moment.

$ ollama stop NOM_DU_MODELE

$ ollama stop qwen2.5-coder:7b

Supprimer une IA

Supprime définitivement le modèle du disque et libère l'espace de stockage correspondant.

$ ollama rm NOM_DU_MODELE

$ ollama rm phi3:mini

Arrêter tous les modèles en une seule commande

Récupère la liste des modèles chargés en mémoire, puis les arrête un par un.

$ ollama ps | awk 'NR>1 {print $1}' | xargs -r -n1 ollama stop

Arrêter complètement le service

Arrête le service Ollama qui tourne en arrière-plan.

$ sudo systemctl stop ollama

Relancer le service

Redémarre le service. Les modèles peuvent à nouveau être lancés normalement.

$ sudo systemctl start ollama

Référence

Modèles recommandés#

Quatre modèles complémentaires suffisent à couvrir la quasi-totalité des usages.

Référence

Stockage#