Sommaire de la documentation

// Documentation Singularity

Fournisseurs IA & réglages agents

Singularity orchestre sept fournisseurs exactement : Claude Code, Codex, Copilot, Cursor, Gemini, Mistral et Ollama. Il lance leurs outils en ligne de commande sur votre poste ; le CLI choisi doit donc être installé, authentifié et utilisable avant de démarrer un agent.

Le modèle : Singularity pilote des CLI

Singularity ne contacte pas directement les API des fournisseurs. Il prépare le ticket, ouvre un processus local et pilote le CLI du fournisseur sélectionné. Installez d’abord ce CLI avec la méthode recommandée par son éditeur, ouvrez un terminal, lancez-le une première fois et terminez son authentification.

Le test le plus simple consiste à demander une réponse au CLI depuis le dossier d’un projet. S’il réclame une connexion, une approbation de dossier ou une mise à jour, réglez cela avant de lancer un ticket dans Singularity.

Réglages IA de Singularity sans clé ni jeton affiché
Réglages IA : chaque onglet correspond à un fournisseur piloté par son CLI.

Claude Code

Installez Claude Code, lancez claude, puis suivez la connexion interactive Anthropic. La liste de modèles (Auto et les modèles Claude accessibles à votre compte) est chargée depuis le catalogue du fournisseur, donc elle peut évoluer sans mise à jour de cette page.

L’onglet permet de régler le mode de permissions, l’effort, la réflexion étendue ou adaptative, le mode rapide réservé à Opus, le cache de prompts, le contexte étendu, la mémoire, les limites de réflexion et de sortie, ainsi que les équipes d’agents.

Codex

Installez le CLI Codex, lancez codex et connectez votre compte OpenAI dans le parcours proposé. Les modèles affichés sont ceux du catalogue Codex disponible sur le poste, avec le choix Auto.

L’onglet expose la personnalité, la politique d’approbation, le bac à sable, l’effort et le résumé de raisonnement, ainsi que l’éditeur utilisé pour ouvrir les références. Les choix de sécurité modifient réellement les droits accordés au processus : préférez l’accès à l’espace de travail sauf besoin explicite.

Copilot

Installez le CLI GitHub Copilot, lancez copilot et authentifiez-vous auprès de GitHub. Votre compte et votre organisation doivent autoriser Copilot. Auto et les modèles retournés par Copilot sont ensuite proposés.

L’onglet règle le mode d’approbation (suggestion, édition automatique ou autonomie complète), la recherche web, le mode plan et la délégation. Commencez en suggestion sur un dépôt sensible.

Cursor

Installez Cursor et son agent CLI, puis lancez agent pour terminer la connexion. Auto et les modèles publiés par Cursor alimentent la sélection. Une clé peut aussi être saisie dans l’onglet ; le champ est masqué.

Les réglages couvrent les permissions (force, shell ou plan), les confirmations du mode shell, la recherche web et la conservation de l’historique de session.

Gemini

Installez Gemini CLI, lancez gemini et choisissez la connexion Google proposée. Auto et les modèles Gemini autorisés sont découverts par le catalogue.

C’est l’onglet le plus détaillé : approbations, nombre de tentatives et de tours, compression et rétention des sessions, détection de boucle, routage des plans, stratégie de dépassement, format texte ou JSON, bac à sable, mode Vim, mise à jour automatique, notifications et intégration IDE.

Mistral

Installez le CLI Mistral Vibe et vérifiez qu’il démarre depuis un terminal. Configurez ensuite un profil ou une clé Mistral dans le champ masqué de l’onglet. Auto et les modèles renvoyés par le fournisseur sont proposés.

Vous pouvez activer les modèles hors ligne, choisir entre YOLO, demande et plan pour les permissions, puis régler la recherche web et la persistance de l’historique.

Ollama et les modèles locaux

Installez Ollama, démarrez son démon local et vérifiez ollama list. Singularity utilise par défaut l’endpoint local http://127.0.0.1:11434 et pilote Claude Code vers ce serveur. L’onglet sait rechercher, télécharger, supprimer et actualiser les modèles ; il recommande aussi ceux adaptés à la RAM et au processeur via llmfit ou une estimation.

Téléchargez le modèle avant de le sélectionner. Un petit modèle quantifié répond plus vite et consomme moins de mémoire, mais suit moins bien les longues consignes et les refactorings complexes. Sur CPU, attendez-vous à une génération nettement plus lente ; sur une machine sans assez de RAM ou de mémoire GPU, le modèle peut devenir inutilisable. Gardez un fournisseur distant pour les tâches difficiles.

Choisir le modèle par défaut

Le réglage du fournisseur définit le modèle par défaut pour les nouveaux agents de l’espace de travail. Auto — choisir selon le contexte laisse la préqualification sélectionner un modèle admissible selon la tâche.

Au niveau d’un ticket, le sélecteur d’agent peut remplacer ce choix pour cette exécution : utile pour réserver un modèle puissant à une migration, ou choisir un modèle rapide pour une correction mécanique. Le réglage du ticket gagne sur le défaut de l’espace sans modifier celui-ci.

Exclure des modèles ou des niveaux de réflexion

Dans « Modèles pour la sélection automatique », décochez un modèle pour empêcher Auto de le choisir. Il reste disponible pour une sélection manuelle. Utilisez cette exclusion pour éviter un modèle trop coûteux, trop lent, déprécié ou inadapté à votre dépôt.

Quand le fournisseur expose une profondeur de raisonnement, vous pouvez aussi retirer certains niveaux des sélecteurs de ticket. Cela évite par exemple une réflexion minimale sur du code critique ou un niveau maximal sur les tâches courtes. Ces exclusions réduisent les choix automatiques ; elles ne désinstallent rien.

Ce qui sort du poste

Singularity ne téléverse pas de lui-même votre code vers un fournisseur IA. Seuls les CLI que vous avez installés et configurés communiquent avec leurs services extérieurs, selon leurs propres conditions, réglages et politiques de conservation. Les prompts, extraits de fichiers et résultats d’outils nécessaires à l’agent peuvent donc transiter par le fournisseur choisi.

Avec Ollama sur l’adresse locale, l’inférence reste sur le poste ; le téléchargement initial d’un modèle contacte toutefois le registre Ollama. Un endpoint Ollama distant n’est plus local. Vérifiez toujours l’URL configurée et les permissions de l’agent avant de traiter un dépôt confidentiel.

Questions fréquentes

Singularity a-t-il besoin de mes clés d’API ?

Non pour les fournisseurs qui authentifient leur propre CLI. Cursor et Mistral exposent aussi un champ de clé dans leurs réglages ; il est masqué dans l’interface. Ollama peut recevoir un jeton si votre endpoint local ou privé en exige un.

Pourquoi un modèle n’apparaît-il pas ?

La liste vient du catalogue du fournisseur actif. Vérifiez que son CLI est installé et authentifié, puis relancez ou actualisez Singularity. Pour Ollama, le modèle doit aussi être téléchargé localement.