Configuration initiale

anyy setup transforme la commande installée en assistant personnel fonctionnel. Il configure modèle, messageries, médias/web facultatifs et serveurs MCP.

Commencer par Quick setup

Choisissez Quick setup à la première installation. Faites fonctionner une conversation locale avant secours, messagerie ou outils externes.

Avant de commencer

Il faut un terminal interactif et une connexion de modèle utilisable :

• clé API fournisseur ;
• connexion d’abonnement compatible ;
• serveur Ollama ou LM Studio actif ;
• point compatible OpenAI ou Anthropic.

Lancez depuis le profil voulu :

anyy setup

Utilisez --profile NAME avant ou --home PATH après la commande pour un profil différent du défaut :

anyy --profile work setup
anyy setup --home /path/to/anyy-home

Choisir un mode

Le premier écran propose :

Mode	Configuration
Quick setup	Fournisseur, authentification, modèle principal, secours facultatif et messagerie
Full setup	Identique, puis image, vidéo, voix, recherche web et MCP facultatifs

Les deux finissent par une revue unique. La configuration collectée est validée après Write these changes?. Une connexion explicitement démarrée peut contacter le service d’authentification avant confirmation.

Configurer le modèle principal

Provider & Model demande :

1. fournisseur ;
2. authentification proposée pour celui-ci ;
3. point ou identifiant requis ;
4. modèle principal.

Si le fournisseur expose un catalogue, Anyy le récupère pour la sélection. Un fournisseur compatible/local peut aussi exiger un ID manuel.

Parcours courants :

Connexion	Choix
Clé API OpenAI	OpenAI → OpenAI API key
Abonnement ChatGPT	OpenAI → ChatGPT subscription (Codex)
Clé API Anthropic	Anthropic → Anthropic API
Abonnement Claude Code	Anthropic → Claude Code subscription
Modèle local	Ollama ou LM Studio
Service compatible	OpenAI-compatible ou Anthropic-compatible

L’assistant installé est la référence du catalogue et ne montre que les authentifications implémentées par cette version.

Les points personnalisés sont une infrastructure de confiance

Un point compatible reçoit demandes, pièces et métadonnées. Utilisez un service contrôlé ou fiable.

Configurer seulement le modèle

Pour changer authentification ou modèle sans messagerie/outils :

anyy setup model

Si Gateway est joignable, Anyy recharge les fournisseurs après écriture confirmée. Sinon, la sauvegarde prend effet au prochain démarrage.

Ajouter des secours

En mode rapide ou complet, Anyy propose le secours. Ignorez-le au début sauf si une seconde paire fournisseur/modèle est déjà testée.

Gérez ensuite la chaîne ordonnée :

anyy setup model fallback

Le principal doit être configuré. Les secours sont essayés dans l’ordre si le routage peut dépasser la cible indisponible ; ils ne remplacent pas des identifiants valides ou un fournisseur sain.

Connecter une messagerie

Messaging connecte une plateforme ou permet de passer. Pour cibler seulement cela :

anyy setup channel

La configuration peut demander ID de compte, règles, webhook et identifiants. Après confirmation d’un changement de canal, Anyy installe/démarre le service Gateway pour garder la connexion après fermeture du terminal.

La livraison webhook exige aussi son écoute Gateway, désactivée par défaut. Activez channel_webhooks.enabled, choisissez une adresse channel_webhooks.listen joignable et redémarrez avant le rappel plateforme. Enregistrer/recharger un compte seul ne l’active pas. Consultez la page de plateforme pour authentification et HTTPS public.

Consultez Plateformes de messagerie pour liste, association, santé et rechargement.

Capacités facultatives

Full setup peut aussi configurer :

• compréhension d’images ;
• compréhension vidéo ;
• génération d’images ;
• synthèse et transcription ;
• recherche web ;
• un ou plusieurs serveurs MCP.

Tout est facultatif. Choisissez les capacités voulues ; chaque service externe peut avoir identifiants, traitement et facturation propres.

Testez avec une entrée compatible : Dashboard classe PNG/JPEG comme images, le reste comme fichiers. Importer audio/vidéo seul ne déclenche pas leur traitement. Consultez Compréhension des médias.

Vérifier et écrire

Review Changes affiche fournisseur, modèle, point, nombre d’identifiants, secours, canaux, capacités et MCP. Vérifiez-les.

Confirmez :

Write these changes? [Y/n]

En cas de réussite, Anyy affiche setup complete et suggère :

anyy status
anyy config
anyy

Annuler avant confirmation laisse les réglages collectés non écrits et ne soumet pas les actions de canal. Après confirmation, elles s’exécutent directement via Gateway ; l’assistant vérifie les reçus locaux et rapporte séparément les diagnostics de connexion.

Emplacement des données

Pour le profil sélectionné :

Donnée	Emplacement
Fournisseur, modèle, routage et capacités	<PROFILE_HOME>/config.yaml
Fichiers d’identifiants fournisseur/MCP	<PROFILE_HOME>/secrets/
Comptes de canal et identifiants chiffrés protégés	<PROFILE_HOME>/state.db
Sessions et état d’exécution	<PROFILE_HOME>/state.db

Fichiers d’identifiants et liaisons chiffrées de canal sont distincts de config.yaml et écrits avec mode 0600. anyy config montre chemins et état sans secrets.

Commandes ciblées

anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
  [--set INPUT=VALUE] \
  [--sensitive-fd INPUT=FD] \
  [--external-locator-fd INPUT=FD]

La dernière forme est non interactive. Les secrets sont lus par descripteurs sans apparaître dans historique ou arguments de processus.

Dépannage

Problème	Solution
requires an interactive terminal	Lancez anyy setup, anyy setup model ou l’assistant interactif anyy setup channel directement dans un terminal
Clé vide annulant setup	Relancez anyy setup model avec clé valide ou autre authentification
Aucun modèle local	Démarrez Ollama/LM Studio, vérifiez le point et recommencez
Connexion d’abonnement inachevée	Terminez navigateur/appareil puis relancez si le terminal a expiré
Paramètres absents	Comparez profil/répertoire avec anyy config
Canal non connecté	Lancez anyy channel doctor CHANNEL, corrigez puis anyy channel reload

Continuez avec Dashboard ou Configurer les modèles.