Discussion simple¶
Une IA conversationnelle légère, sans outils et sans la machinerie d'un agent. C'est la configuration Diapason la plus simple qui soit : Ollama et un modèle local, rien de plus. Idéale pour discuter de tout et de rien, poser des questions, brasser des idées et démarrer vite.
Démarrage rapide (3 minutes)¶
1. Installer Ollama et télécharger un modèle¶
2. Installer et initialiser Diapason¶
git clone https://github.com/carlitoetienne01-spec/Diapason.git
cd Diapason
uv sync
diapason init --preset chat-simple
3. Poser une question¶
C'est tout. Aucune clé d'API, aucun outil, aucun nuage — juste un modèle local qui répond à tes questions.
Les commandes de la CLI¶
# Une seule question
diapason ask "Explique la différence entre TCP et UDP"
# Une session de discussion interactive (conversation à plusieurs tours)
diapason chat
# Démarrer le serveur d'API pour l'app navigateur ou l'app de bureau
diapason serve
# Changer de modèle pour une seule question
diapason ask -m qwen3.5:9b "Explique la relativité générale"
# Régler la température (0.0 = déterministe, 1.0 = créatif)
diapason ask -t 0.2 "Liste les planètes du système solaire"
# Rendre le JSON brut
diapason ask --json "Combien font 2+2 ?"
Référence de configuration¶
Le préréglage écrit ceci dans ~/.diapason/config.toml :
[engine]
default = "ollama"
[intelligence]
default_model = "qwen3.5:4b" # Rapide et léger
# default_model = "qwen3.5:9b" # Meilleure qualité
# default_model = "llama3.1:8b" # Un autre modèle
[agent]
default_agent = "simple" # Un seul tour, aucun outil
[server]
host = "0.0.0.0"
port = 8000
Le choix du modèle¶
| Modèle | Paramètres | Vitesse | Qualité | Pour quoi |
|---|---|---|---|---|
qwen3.5:4b |
4B | Rapide | Bonne | Réponses rapides, machine modeste |
qwen3.5:9b |
9B | Équilibrée | Meilleure | Discussion générale, explications |
qwen3.5:35b |
35B | Plus lente | La meilleure | Raisonnement complexe, analyse détaillée |
llama3.1:8b |
8B | Équilibrée | Bonne | Une autre voie si tu préfères les modèles Meta |
Pour changer de modèle, modifie ~/.diapason/config.toml ou remplace-le question par question :
Pour télécharger un nouveau modèle :
Utiliser l'app navigateur¶
Démarre le serveur et l'interface React en une seule commande :
Ça ouvre http://localhost:5173 dans ton navigateur, avec l'interface de discussion complète, les réponses au fil de l'eau et le tableau de bord de consommation.
Pour ne lancer que le serveur d'API (pour l'app de bureau ou pour des clients externes) :
Le serveur est compatible OpenAI : n'importe quel client qui fonctionne avec l'API OpenAI peut pointer vers http://localhost:8000/v1.
Utiliser l'app de bureau¶
- Démarre le serveur :
diapason serve(ou./scripts/quickstart.sh). - Construis l'app de bureau depuis le dépôt authentifié. Aucune version n'est
publiée pour l'instant ; sur le Mac de Carlito, lance
./scripts/install-desktop.sh. - L'app se connecte toute seule à
http://localhost:8000.
Changer de modèle¶
Tu peux changer le modèle par défaut quand tu veux :
Modifier la configuration :
# Ouvrir le fichier de configuration
${EDITOR:-nano} ~/.diapason/config.toml
# Remplacer default_model par le modèle de ton choix
Télécharger et basculer d'un coup :
Passer par une variable d'environnement :
Dépannage¶
« No running engine found » — assure-toi qu'Ollama tourne. Démarre-le avec ollama serve ou ouvre l'app de bureau Ollama.
« Model not found » — télécharge d'abord le modèle avec ollama pull <nom-du-modèle>. Liste les modèles disponibles avec ollama list.
Les réponses sont lentes — prends un modèle plus petit (qwen3.5:4b). Vérifie la mémoire disponible : un modèle a besoin d'à peu près autant de Go de mémoire vive qu'il compte de milliards de paramètres (un modèle 9B demande environ 9 Go).
Tu veux ajouter des outils plus tard ? — bascule sur la configuration Assistant de code ou Recherche approfondie. La discussion simple est minimale à dessein.
L'app navigateur ne charge pas — assure-toi que le serveur (diapason serve) et l'interface tournent tous les deux. Le script ./scripts/quickstart.sh démarre les deux tout seul.