Configurer Lumi : recherche locale, CLI et API

Lumi ne traite pas une recherche de fichier comme une question à l’IA. La recherche consulte l’index du système ; la question passe par la CLI ou l’API sélectionnée. Commencez par retrouver un fichier connu, choisissez une connexion, posez une courte question sans données sensibles, puis vérifiez le modèle et la consommation. Retrouver un document ne signifie pas que le modèle l’a lu. Le nom d’une CLI dans le menu ne prouve pas non plus que la requête utilise votre abonnement.

Les commandes et comportements présentés ici correspondent à cette révision précise de Lumi. Une autre version peut modifier l’interface ou les modèles proposés. Copiez les identifiants dans le service actuel plutôt que de prendre un ancien menu pour un catalogue à jour.

Installer Lumi et tester la recherche séparément

Téléchargez la version adaptée depuis les Releases du projet. Sur macOS, ouvrez le DMG et glissez Lumi dans Applications. Sur Windows, choisissez l’installateur ou la version portable. Si le premier lancement affiche un avertissement de signature ou de sécurité, vérifiez la provenance du fichier et les règles de votre organisation avant de poursuivre. Ne désactivez pas les protections générales du système. Consultez les instructions pour macOS et Windows.

Le raccourci par défaut utilise Option et la touche physique immédiatement à gauche du 1 sur macOS, ou Alt et cette même touche sur Windows. Le caractère imprimé dépend du clavier. En cas de conflit, utilisez Change dans la fenêtre d’accueil. Les noms de champs ci-dessous sont ceux de l’interface anglaise.

Recherchez un fichier ordinaire ou une application dont vous connaissez l’existence et l’indexation. Vérifiez le nom et le chemin, sélectionnez le résultat avec les flèches et appuyez sur Entrée pour l’ouvrir. Option+Entrée sur macOS ou Alt+Entrée sur Windows affiche le fichier sélectionné dans le Finder ou l’Explorateur. Cette étape ne nécessite aucune clé d’API de modèle. Le Mac utilise Spotlight ; Windows utilise les raccourcis du menu Démarrer pour les applications et Windows Search pour les fichiers. Un fichier absent invite à vérifier l’index et le périmètre de recherche du système, pas à changer de modèle. Recherche et raccourcis

Comprendre ce que reçoit le modèle

Ouvrir un résultat ou afficher son emplacement ne joint pas automatiquement le document à une conversation. Même lorsqu’un index trouve un mot dans le contenu d’un fichier, cela ne signifie pas que son texte est envoyé au modèle.

Le traitement des API personnalisées envoie normalement une instruction système, l’historique de la conversation actuelle et la nouvelle question. Les modèles lumi distribués pour Ollama disposent d’un cas particulier qui omet l’instruction système. La construction de la requête n’ajoute pas automatiquement tous les résultats de recherche ni le contenu de fichiers arbitraires. Les textes que vous collez, l’historique précédent et les traitements propres au service choisi restent toutefois à prendre en compte pour la confidentialité. Construction de la requête

Les CLI n’ont pas toutes les mêmes limites. Claude démarre dans le dossier personnel avec les outils WebSearch,WebFetch spécifiés par Lumi. Codex utilise un dossier dédié, --sandbox read-only et une instruction demandant de ne pas exécuter de commandes ni lire de fichiers. Gemini utilise son propre dossier et --approval-mode plan. Répertoire de travail, sandbox et consigne textuelle sont des contrôles distincts : ils ne prouvent pas, à eux seuls, l’impossibilité de lire d’autres configurations ou d’accéder au réseau. Les CLI conservent leurs propres paramètres d’authentification. Sur macOS, l’environnement du processus est hérité avant modification de PATH ; sur Windows, les variables d’authentification ne sont pas effacées non plus. Exécution macOS ; exécution Windows

Choisir un chemin de requête, pas un vainqueur tarifaire

Ce dont vous disposez	Point de départ	Vérification nécessaire
CLI installée et compte autorisé à l’utiliser	Claude, Codex ou Gemini CLI	Authentification active et compte dont le quota ou la facture change
Poids téléchargés pour une exécution sur votre ordinateur	Serveur local Ollama ou LM Studio	Modèle chargé, machine d’exécution et éventuel transfert vers le cloud ; matériel et électricité restent nécessaires
Modèle externe précis et compte API	Connexion API personnalisée	Endpoint, clé, identifiant exact et consommation ou solde du compte API

Il s’agit d’un choix de configuration, pas d’un classement des coûts. L’abonnement, la consommation supplémentaire facturée à l’usage et les ressources informatiques locales ne sont pas des dépenses interchangeables. Pour conclure qu’un chemin est moins cher, il faudrait vérifier toutes ses obligations d’abonnement, de consommation et de financement.

CLI existante : vérifier l’authentification avant de la sélectionner

Configurez uniquement la CLI que vous comptez utiliser. Pour Claude, lancez claude, terminez la connexion officielle et consultez /status dans l’interface interactive. Attention à ANTHROPIC_API_KEY : la documentation indique qu’en mode non interactif -p, une clé présente est utilisée ; d’autres mécanismes peuvent encore être prioritaires. Lumi appelle Claude avec -p. Voir un abonnement dans la session interactive ne suffit donc pas à identifier la facturation d’une requête Lumi. Vérifiez l’environnement transmis à Lumi et la consommation réelle, sans afficher les valeurs secrètes. Priorité des authentifications Claude

Pour Codex, utilisez codex login, puis codex login status. OpenAI distingue la connexion ChatGPT donnant accès à l’abonnement de la clé API donnant accès à une consommation facturée à l’usage. Vérifiez aussi les éventuels paramètres d’un fournisseur personnalisé : l’étiquette Codex dans Lumi n’identifie pas à elle seule le service effectivement appelé. Authentification Codex

Pour Gemini, lancez gemini et suivez Sign in with Google lorsque vous choisissez cette méthode. Connexion Google, clé Gemini API et Vertex AI sont des chemins différents. L’exécution sans interface interactive peut réutiliser des identifiants en cache ; elle ne correspond pas automatiquement à un abonnement particulier. Authentification Gemini

Revenez dans Lumi et sélectionnez la CLI correspondante dans le menu des modèles. Après modification de l’authentification ou de l’environnement de lancement, quittez et rouvrez Lumi avant de vérifier. Les conditions du fournisseur liées au compte, à la région et à l’organisation restent applicables. Lumi et une connexion API distincte ne lèvent pas les restrictions de connexion d’un autre service.

Enregistrer une connexion API locale ou externe

Quittez toute réponse précédente pour revenir à une saisie vide, puis ouvrez Connect a model… dans le menu des modèles. Dans Service, choisissez Ollama, LM Studio ou Other address. Remplissez Name, Address, Model et API key, cliquez sur Connect, puis vérifiez que la connexion enregistrée est sélectionnée dans le menu. Formulaire de connexion

Address attend la Base URL, pas l’adresse complète de la requête. Lumi ajoute lui-même /chat/completions. Coller l’endpoint complet duplique ce segment. Name est un libellé de votre choix ; Model doit être un identifiant exact accepté par le serveur.

Destination	Exemple pour Address	Modèle et clé
Ollama local	`http://localhost:11434/v1`	Nom d’un modèle local réellement téléchargé ; le serveur local standard n’exige pas de clé API cloud
LM Studio local	`http://localhost:1234/v1`	Identifiant du modèle dans LM Studio ; fournissez le jeton du serveur si son authentification est activée
Connexion BetterToken personnalisée	`https://www.bettertoken.ai/v1`	Votre clé personnelle et un identifiant actuel copié depuis le catalogue de modèles ou Key Setup

Démarrez d’abord le serveur Ollama ou LM Studio et préparez un modèle utilisable. Les ports indiqués sont ceux des exemples officiels ; utilisez votre port réel si vous l’avez changé. localhost décrit le premier point de connexion, pas nécessairement le lieu de toute l’inférence. Pour travailler hors ligne, vérifiez que les poids sont exécutés localement et que le serveur ne relaie pas la question vers un modèle cloud. Compatibilité Ollama ; serveur et API LM Studio

BetterToken est ici un compte API facultatif, pas un remplacement de connexion à un abonnement. Vérifiez votre éligibilité, créez une clé dans votre compte, suivez les instructions actuelles de configuration et contrôlez le quota ou le solde ainsi que la disponibilité du modèle. YOUR_API_KEY et YOUR_MODEL_ID sont des valeurs fictives à remplacer, pas des identifiants utilisables. Saisissez la vraie clé dans le champ masqué, jamais dans une question, une capture ou un journal. La documentation indique actuellement la Russie comme région desservie ; ailleurs, confirmez d’abord auprès du service que votre compte est éligible.

Le tableau d’accès développeur de la documentation BetterToken indique https://www.bettertoken.ai/v1. En ajoutant le suffixe de Lumi, on obtient https://www.bettertoken.ai/v1/chat/completions, qui correspond à la documentation Chat Completions. Il s’agit d’une déduction du format de requête, pas de la preuve d’un test de bout en bout sur votre compte ni d’une garantie de prise en charge de toutes les fonctions. Enregistrer une connexion Lumi ne réécrit pas le fournisseur déjà configuré dans votre CLI.

Vérifier une réponse complète et sa consommation

Ouvrez une conversation vide, sélectionnez la bonne connexion et demandez : « Convertis 2.5 pouces en centimètres. Réponds en une phrase, sans recherche sur le Web. » Envoyez avec Cmd+Entrée sur macOS ou Ctrl+Entrée sur Windows pour éviter qu’Entrée ouvre un fichier sélectionné. Ask in ChatGPT, Cmd+Shift+Entrée et Ctrl+Shift+Entrée utilisent le navigateur, pas le chemin API testé ici. Actions du clavier

Attendez la fin de la réponse. Le résultat attendu est 6,35 centimètres. Avec le champ de saisie vide et aucun texte sélectionné, Cmd+C ou Ctrl+C copie la réponse complète. Conservez-la à titre privé avec l’heure de la requête et le nom de connexion, sans clé. Une conversion correcte ne vérifie que le contenu : contrôlez séparément un résultat local visible, une réponse complète, le fournisseur/modèle réel et une consommation attribuée au bon compte.

Pour une API, comparez les enregistrements de requête et de consommation du compte. Le Dashboard BetterToken affiche les requêtes, la consommation de tokens et le solde. Pour une CLI, consultez le quota du compte authentifié ou sa facturation API. Pour une inférence locale, vérifiez le traitement côté serveur local et le modèle chargé, plutôt qu’une facture cloud. Si le service fournit seulement des totaux sans preuve du modèle par requête, notez « modèle non confirmé ». Demander au modèle de se présenter ne remplace pas cette vérification. Suivi de consommation BetterToken

Identifier la panne avant de réessayer

Appuyez sur Échap pour arrêter une réponse en cours, puis de nouveau sur Échap pour quitter la vue de réponse ou d’erreur. Dans cette révision, changer de modèle après un échec — ou appuyer sur Entrée avec une saisie vide — peut renvoyer la question précédente. Sortez de l’état d’erreur avant de changer de connexion pour éviter d’envoyer involontairement cette question à un autre service. Arrêter le client ne prouve pas que le serveur n’a enregistré aucune consommation. Nouvel envoi et touche Échap

Symptôme	Prochaine vérification
Les applications apparaissent, mais pas un fichier	Vérifiez l’index et le périmètre du système ; ne changez pas de clé API
CLI absente ou connexion échouée	Rendez cette CLI utilisable via son parcours officiel dans le terminal ; vérifiez l’exécutable trouvé par Lumi sans tout réinstaller
`401` ou `403`	Lisez le message ; distinguez les identifiants des règles de réseau, de région ou d’organisation
`404` ou modèle inconnu	Supprimez un éventuel doublon `/chat/completions`, puis vérifiez l’identifiant exact et la préparation du modèle local
`429` ou erreur de quota	Vérifiez quota, solde et limites de débit ; suivez les consignes du serveur au lieu de répéter en boucle
HTTP `200`, mais sortie vide, partielle ou en erreur	Inspectez le flux complet et l’erreur finale ; acceptation et réponse réussie sont différentes

Le traitement API prévoit explicitement les erreurs à l’intérieur d’un flux et les réponses vides. Quelques mots affichés ne prouvent donc pas que la réponse est terminée. Corrigez un problème identifié, posez une nouvelle question courte, puis refaites les quatre contrôles. Gestion des erreurs

Avant d’adopter une connexion au quotidien, faites fonctionner une recherche ordinaire et une question sans données sensibles, en identifiant clairement le traitement et le compte facturé.