Configuration Aristote¶
Aristote donne accès à un service de modèles LLM souverains. À CentraleSupélec, la connexion à ce service se fait avec une clé API personnelle.
La clé API sert à se connecter au service. Pour utiliser les modèles, il faut aussi une interface locale, par exemple OpenCode.
Ce guide explique pas à pas comment installer OpenCode, renseigner votre clé API, indiquer l'adresse du service et choisir un modèle.
Commencez par obtenir votre clé, puis consultez le guide d'installation d'OpenCode en version Desktop ou CLI :
Repères utiles¶
| Élément | À quoi ça correspond | Exemple |
|---|---|---|
| Clé API personnelle | Code d'accès à copier dans OpenCode. | sk-... |
| Adresse du service | URL du service de modèles Aristote. | https://llm.aristote.education/v1 |
| Modèle | Modèle LLM à choisir dans l'interface. | commencer par qwen-3.6-35b-instruct |
Clé personnelle
Ne partagez jamais votre clé API. Ne l'envoyez pas par mail, ne la mettez pas dans un dépôt Git et ne l'affichez pas dans une capture d'écran.
Travaillez avec Git
Les assistants peuvent modifier des fichiers. Des changements catastrophiques peuvent arriver : fichiers supprimés, dossier réécrit, modifications difficiles à comprendre. Il n'est pas nécessaire d'être expert Git, ni d'utiliser GitLab ou GitHub : un dépôt Git local suffit. Vous pouvez simplement demander à OpenCode de créer un dépôt Git dans le dossier de travail et de faire des commits réguliers. Sans Git ni sauvegarde, il peut être impossible de revenir en arrière.
Installation de logiciels
Les assistants peuvent aussi aider à installer les logiciels nécessaires. Vous pouvez leur demander de vérifier si Git, Python ou une autre dépendance sont installés et à jour, puis de proposer les commandes adaptées à votre système. Validez les commandes proposées avant exécution.
Quel outil utiliser ?¶
OpenCode Desktop
Application graphique pour Windows, macOS et Linux. C'est le choix conseillé pour commencer avec une interface visuelle.
OpenCode CLI
Version en ligne de commande. À utiliser si vous êtes déjà à l'aise avec le terminal. Cette procédure permet aussi d'utiliser OpenCode dans VS Code.
OpenCode Desktop et OpenCode CLI peuvent coexister sur le même ordinateur.
Hermes et OpenClaw : accès aux fichiers
Hermes Desktop, Hermes CLI et OpenClaw sont des agents plus autonomes qu'OpenCode. Selon leur configuration, ils peuvent modifier ou effacer des fichiers, parfois partout sur le disque et sans avertissement. Testez-les uniquement dans un environnement maîtrisé, avec une sauvegarde.
Valeurs à saisir dans les outils¶
Ces valeurs reviennent dans toutes les configurations :
| Champ | Valeur |
|---|---|
| Type de connexion | OpenAI-compatible ou Custom provider |
| Base URL / Endpoint | https://llm.aristote.education/v1 |
| API key / Clé API | votre clé Aristote |
| Model ID / Modèle | commencer par qwen-3.6-35b-instruct |
Qwen Reasoning High, Gemma, GPT OSS, Llama et Mistral sont aussi proposés. Voir les modèles et leurs usages.
Les champs de nommage comme Provider ID, Display name ou Model name
servent seulement à nommer la connexion dans l'outil. Utilisez des noms simples,
par exemple aristote et Aristote.
Pour un usage sans installation locale, utilisez AristoTchat si ce service est disponible : chat.aristote.education.
Autres outils¶
Ces outils ne sont pas validés pour un usage courant avec Aristote. Ils peuvent modifier des fichiers en dehors du dossier de travail, parfois sans avertissement.
| Outil | Usage possible |
|---|---|
| Hermes Desktop | Agent généraliste avec application Windows/macOS. Installation plus complexe. |
| Hermes CLI | Configuration et usage Hermes en ligne de commande |
| OpenClaw | Agent personnel connecté à des applications de messagerie et à des outils locaux |