Démarrage rapide

Ce guide part d’une machine macOS ou Linux vierge pour obtenir Anyy fonctionnel, une première conversation dans Dashboard et la preuve qu’elle survit au redémarrage du processus Dashboard.

À qui s’adresse ce guide

Utilisez-le si vous :

• voulez Anyy pour vous sur macOS ou Linux ;
• préférez Dashboard au quotidien mais voulez connaître les commandes ;
• disposez d’une clé API, d’un abonnement compatible ou d’un serveur Ollama/LM Studio ;
• voulez une conversation fiable avant messageries, automatisation, Skills ou outils externes.

Le chemin le plus rapide

Objectif	Première action	Action suivante
Interface visuelle complète	Installer Anyy	anyy setup, puis anyy dashboard
Conversation au terminal	Installer/configurer	anyy
Demande depuis un script	Démarrer Gateway résident	anyy chat "..."
Telegram ou autre plateforme	Vérifier d’abord la conversation locale	anyy setup channel

Commencer par une conversation fonctionnelle

Configurez un fournisseur et terminez une conversation simple avant secours, messagerie, Cron ou MCP. Les problèmes initiaux restent petits et diagnostiquables.

1. Installer Anyy

macOS ou Linux

Lancez l’installateur natif canonique :

curl -fsSL https://anyy.ai/install.sh | sh

Vérifiez que le shell trouve la commande :

anyy --version

L’installateur télécharge la version native, la vérifie contre CHECKSUMS.sha256, l’active dans le répertoire Anyy et crée une entrée de commande si possible sans risque.

Cibles de l’installateur

Il accepte macOS/Linux sur amd64/x86_64 et arm64/aarch64. Il ne démarre pas Gateway et ne crée pas les données de profil ; la configuration le fait seulement au besoin.

Si anyy manque de PATH, utilisez Binary: affiché pour vérifier, puis ajoutez le répertoire exact de l’indication PATH. Sans root, l’entrée va si possible dans $HOME/.local/bin.

2. Choisir un fournisseur

Lancez l’assistant interactif :

anyy setup

Pour la voie la plus courte :

1. Choisissez Quick setup.
2. Choisissez fournisseur et authentification.
3. Choisissez un modèle découvert ou saisissez-le si nécessaire.
4. Répondez No à Set up model fallback routing? pour commencer.
5. Choisissez Skip pour la messagerie.
6. Vérifiez fournisseur, modèle, point et nombre de secrets puis confirmez Write these changes?.

Plusieurs types de connexion sont proposés :

Ressource disponible	Choix dans setup
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
Ollama ou LM Studio local	Ollama ou LM Studio ; démarrez le serveur d’abord
Autre service compatible	OpenAI-compatible ou Anthropic-compatible, puis son point

L’assistant liste aussi les autres fournisseurs utilisables. Son catalogue fait autorité pour la version installée.

Après setup complete, vérifiez :

anyy config

Cela montre profil, répertoire, configuration, base, fournisseur, modèle, point et résolution de chaque référence sans afficher de secret.

Stockage des paramètres

Chaque profil est autonome :

• fournisseur/modèle dans <PROFILE_HOME>/config.yaml ;
• identifiants gérés séparément sous <PROFILE_HOME>/secrets/ en 0600 ;
• sessions et état dans <PROFILE_HOME>/state.db.

Sans root, <PROFILE_HOME> est normalement $HOME/.anyy ; avec root, /root/.anyy. Utilisez anyy config plutôt que de deviner avec ANYY_HOME ou profils nommés.

La configuration commence par une revue

L’assistant prépare ses changements et les présente. Annuler avant Write these changes? les laisse non écrits.

3. Première conversation

Dashboard est recommandé au départ : conversation, sessions, fournisseurs, outils, mémoire, rôles, profils, canaux, Skills, MCP et Cron sont réunis.

Depuis un terminal interactif :

anyy dashboard

Si Gateway résident est absent, Gateway required apparaît avec :

Start Anyy Gateway now? [Y/n]:

Appuyez sur Entrée pour accepter. Anyy installe/démarre le service au besoin, attend puis ouvre Dashboard. Gateway reste disponible à la fermeture du processus Dashboard.

Par défaut, Anyy affiche This machine et les URL Local network utilisables sur 8767. En interactif, il ouvre automatiquement This machine. Utilisez --no-open pour seulement afficher les URL :

anyy dashboard --no-open

Pour écouter uniquement sur une adresse de boucle locale explicite :

anyy dashboard --listen 127.0.0.1:8767

Garder les URL privées

Elles contiennent des jetons temporaires. Ne les collez pas dans conversations, journaux, incidents ou captures. Ctrl+C dans le terminal arrête l’écoute Dashboard.

Envoyer le premier message

Dans Dashboard :

1. Ouvrez Chat.
2. Sélectionnez New session.
3. Envoyez cette demande :

Introduce yourself as Anyy in one sentence, then list three things you can help me do.

La configuration fonctionne si la réponse apparaît et la session figure dans le panneau.

Une vraie requête modèle est envoyée

Elle peut consommer du quota ou entraîner des frais. N’incluez ni clé API, jeton ni autre secret dans la demande.

4. Vérifier les sessions

Vérifiez la persistance au-delà d’une réponse :

1. Envoyez un suivi dans la même session.
2. Ctrl+C dans le terminal Dashboard.
3. Exécutez anyy dashboard de nouveau.
4. Ouvrez Chat puis la session précédente.
5. Confirmez les deux tours puis envoyez un autre suivi.

Cela vérifie stockage, reconnexion Dashboard et continuité via Gateway résident.

Au terminal, lancez anyy, /sessions et choisissez une conversation. Si l’ID est connu :

anyy --resume SESSION_ID

5. Essayer les fonctions essentielles

Contrôles Dashboard

Inspectez la configuration :

• Overview montre santé et profil.
• Models montre connexions, authentification, catalogue et modèle actif.
• Chat sépare conversations normales et arrière-plan.
• Roles et Memory gèrent identité et contexte durable.
• Tools, Skills, MCP, Channel, Cron ajoutent les capacités une fois la conversation stable.

Chat garde un bouton Send. Pendant l’exécution, les nouveaux messages vont au-dessus de l’éditeur ; Steer guide le travail actif. Shift+Enter insère une ligne, Escape interrompt et / ouvre les commandes. Consultez Contrôles Chat.

Interface terminal

Ouvrez la TUI :

anyy

Commandes utiles :

/help       Show commands and keyboard shortcuts
/new        Start a new session
/sessions   Open recent sessions
/status     Show the current conversation state
/model      Inspect or change the active model
/provider   Inspect providers and provider authentication
/usage      Show provider usage and context
/skills     Insert an available Skill command

Dans la TUI, Enter envoie à l’état inactif et oriente pendant le travail ; Alt+Enter ajoute un suivi. Shift+Enter ou Ctrl+J insère une ligne. /quit quitte ; interruption et retour du texte sont décrits dans Contrôles TUI.

CLI ponctuelle

Avec Gateway résident actif, envoyez une demande sans interface complète :

anyy chat "Give me a five-line summary of what Anyy can do."

Ajoutez --json pour une sortie structurée. Les outils activés s’exécutent directement : vérifiez tâche, chemins et compte de destination avant soumission.

6. Ajouter la couche suivante

Ajoutez seulement la capacité nécessaire ensuite :

Capacité	Départ	Apport
Messagerie	anyy setup channel	Plateforme et règles d’accès
Modèle de secours	anyy setup model fallback	Chaîne ordonnée de cibles de repli
Services web/image/vidéo/voix	anyy tools	Capacités facultatives
Skills	anyy skills list	Inspection avant ajout
MCP	anyy mcp --help	Ajout, authentification, sondes, activation et appels
Travail planifié	anyy cron --help	Travaux récurrents, horaires et livraison

Dashboard et Gateway ont des durées de vie différentes

Dashboard est un auxiliaire web à la demande. Gateway est résident. Ctrl+C ferme l’écoute web sans arrêter Gateway installé comme service.

Échecs courants

Symptôme	Cause probable	Solution
anyy: command not found	Répertoire de commande hors PATH	Suivez l’instruction exacte, rouvrez le shell puis anyy --version
Setup quitte après clé vide	Une entrée vide annule la première configuration par clé	Relancez anyy setup model avec clé valide ou fournisseur par abonnement/local
Modèles Ollama/LM Studio indisponibles	Serveur arrêté ou point erroné	Démarrez-le puis relancez anyy setup model
Gateway required	Aucun résident joignable	Acceptez ou lancez anyy gateway start, puis anyy dashboard
127.0.0.1:8767 occupé	Autre processus/Dashboard	Inspectez anyy dashboard --status, arrêtez l’ancien avec anyy dashboard --stop ou utilisez --listen 127.0.0.1:8768
Dashboard ouvert mais envoi impossible	Fournisseur, modèle, authentification ou Gateway dégradé	anyy config, anyy status, anyy doctor, puis anyy setup model au besoin
anyy chat ne se connecte pas	Il ne démarre pas le résident	Lancez anyy gateway start d’abord
Session enregistrée absente	Autre profil/répertoire	Comparez Profile et Home avec anyy config

Outils de récupération

Suivez l’ordre pour préciser la cause avant modification :

1. Vérifiez environnement et profil :

   anyy status
   anyy config

2. Lancez les diagnostics :

   anyy doctor

3. Si Gateway est dégradé sans tour actif, redémarrez :

   anyy gateway restart

4. Si authentification ou modèle erronés, réparez seulement cette couche :

   anyy setup model

5. Si l’écoute Dashboard est en cause, inspectez/arrêtez les anciens processus puis démarrez :

   anyy dashboard --status
   anyy dashboard --stop
   anyy dashboard

6. Avec plusieurs profils, confirmez l’actif :

   anyy profile list

Référence rapide

Commande	Usage
anyy	Ouvre le terminal interactif
anyy dashboard	Démarre Dashboard et ouvre This machine
anyy dashboard --no-open	Démarre sans navigateur
anyy chat "PROMPT"	Envoie via Gateway résident
anyy --resume SESSION_ID	Ouvre une session TUI existante
anyy status	État de l’environnement et Gateway
anyy doctor	Diagnostics de configuration/exécution
anyy config	Chemins, fournisseur, modèle et identifiants
anyy gateway start	Installe/démarre le service résident
anyy gateway restart	Redémarre le service
anyy setup model	Fournisseur, authentification, modèle et secours facultatif
anyy setup channel	Plateformes de messagerie
anyy update --check	Vérifie une nouvelle version native

Étapes suivantes

• Découvrez l’interface visuelle dans Dashboard.
• Ajoutez/changez un fournisseur dans Configurer les modèles.
• Apprenez commandes et touches dans TUI.
• Connectez une plateforme dans Messagerie.
• Parcourez le produit dans Fonctionnalités.
• Cherchez les options exactes dans la Référence CLI.