Installation

Cette page installe la commande native anyy sur macOS ou Linux. À la fin, anyy --version doit fonctionner. Configuration du fournisseur, données de profil et Gateway résident sont des étapes distinctes.

Plateformes de l’installateur

L’installateur natif accepte macOS et Linux sur amd64/x86_64 et arm64/aarch64. Windows natif n’est pas une cible.

Installation rapide

Prérequis

Il vous faut :

• une machine macOS ou Linux compatible ;
• une connexion Internet à anyy.ai ;
• POSIX sh, curl, tar, gzip, awk, sed, mktemp, readlink et sha256sum ou shasum.

L’installateur vérifie les commandes avant téléchargement. Une installation personnelle normale n’exige pas root.

Installer la dernière version

Lancez l’installateur canonique :

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

Il choisit la version selon système et architecture. Une réussite se termine par des lignes semblables à :

Installed Anyy <version>.
Command: anyy
Gateway: <current status>

La ligne Gateway rapporte l’état observable, sans signifier que l’installateur l’a démarré ou configuré.

Inspecter d’abord l’installateur

Si vous préférez éviter de transmettre un script distant directement à sh, ouvrez anyy.ai/install.sh ou téléchargez-le et examinez-le avant exécution. Le script publié est le même point d’entrée.

Vérifier l’installation

Lancez :

anyy --version

La sortie doit commencer par :

Anyy (anyy) version

Si l’installateur affiche Binary: au lieu de Command: anyy, lancez ce chemin avec --version. Ajoutez ensuite le répertoire exact indiqué pour PATH et ouvrez un nouveau shell.

Sans root, Anyy tente de créer cette entrée :

$HOME/.local/bin/anyy

L’installateur ne modifie jamais les fichiers de démarrage du shell et ne remplace pas une commande anyy existante sans rapport.

Actions de l’installateur

Étapes dans l’ordre :

1. Détecte darwin ou linux et associe le processeur à amd64 ou arm64.
2. Résout répertoire Anyy et version.
3. Prend un verrou d’installation/mise à jour par répertoire pour empêcher deux changements simultanés.
4. Vérifie commandes et espace temporaire/personnel.
5. Télécharge archive et CHECKSUMS.sha256, avec tentatives bornées sans conserver de fichiers partiels.
6. Vérifie SHA-256 et rejette chemins/liens dangereux avant installation.
7. Place le binaire dans un répertoire versionné et bascule current atomiquement.
8. Écrit la source d’installation et crée une entrée de commande sans écraser un autre fichier.
9. Indique commande installée et état Gateway.

L’installation s’arrête au binaire

Elle ne choisit pas de fournisseur, n’écrit pas config.yaml, ne crée pas state.db et n’installe/démarre pas de service d’arrière-plan. Lancez anyy setup après disponibilité de la commande.

Disposition de l’installation

Le répertoire par défaut dépend de l’utilisateur exécutant l’installateur :

Utilisateur	Répertoire Anyy	Entrée de commande
Utilisateur normal	$HOME/.anyy	$HOME/.local/bin/anyy
root	/root/.anyy	Premier répertoire accessible en écriture parmi /usr/local/bin, /opt/homebrew/bin, /usr/bin
ANYY_HOME personnalisé	Chemin fourni	Entrée normale ou root ci-dessus pointant vers ce répertoire

L’installateur prépare :

<ANYY_HOME>/
├── releases/
│   └── <version>/anyy
├── current -> releases/<version>
├── bin/
│   └── anyy -> ../current/anyy
├── .install/
│   ├── source.json
│   └── previous        # present after a release change when rollback exists
├── backups/
├── cache/
├── logs/
├── memory/
├── scripts/
├── secrets/
├── skills/
├── system/
└── workspace/

Le répertoire Home et les répertoires gérés par l’installateur sont créés en 0700 ; .install/source.json est écrit en 0600. Les commandes suivantes ajoutent les fichiers d’exécution/profil seulement au besoin.

Au premier accès durable de l’environnement, il crée aussi state.db et objects/ adressé par contenu. Ce sont des données d’exécution, pas des fichiers fournis par l’installateur.

L’activation utilise current : un changement achevé bascule le binaire en une opération. Si une ancienne version active existe, Anyy l’enregistre comme cible de retour arrière.

Options de l’installateur

Définissez les options sur le processus sh après le tube :

Variable	Défaut	Usage
ANYY_HOME	$HOME/.anyy, ou /root/.anyy pour root	Installer dans un autre répertoire
VERSION	Version de https://anyy.ai/releases/latest	Épingler une version disponible vMAJOR.MINOR.PATCH
ANYY_INSTALL_COMPACT	0	Espace limité avec perte acceptée d’ancien historique
ANYY_RELEASE_BASE_URL	https://anyy.ai/releases	Exploiter un miroir compatible fiable

Utiliser un répertoire personnalisé

curl -fsSL https://anyy.ai/install.sh | ANYY_HOME="$HOME/.local/share/anyy" sh

Les commandes via l’entrée installée peuvent déduire ce répertoire résident. Vous pouvez encore passer --home PATH si compatible.

Installer une version précise

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh

Remplacez par un tag disponible. VERSION=latest est refusé ; omettez VERSION pour suivre la dernière publication.

Mode compact sur un hôte limité

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

Le mode compact peut réduire le retour arrière

Il conserve toujours la version active. Il peut retirer les inactives et, seulement pour réussir le contrôle d’espace, la cible précédente. Libérer de l’espace est plus sûr si vous voulez conserver ce retour.

Faire confiance à la source de version

ANYY_RELEASE_BASE_URL personnalisé fournit binaire et somme de contrôle. Utilisez une source contrôlée ou vérifiée indépendamment.

Réinstallation et mise à jour

Relancer l’installateur avec la même version active répare les entrées internes et de commande sans téléchargement/remplacement de cette version.

Pour vérifier une nouvelle version résidente :

anyy update --check

Utilisez normalement anyy update. Consultez Mise à jour pour sélection, mode compact et retour arrière.

Après installation

Poursuivez la configuration interactive :

anyy setup

Puis ouvrez Dashboard :

anyy dashboard

Pour le parcours complet, consultez Démarrage rapide. Configuration initiale détaille fournisseur et modèle.

Dépannage

Symptôme	Signification	Action
unsupported operating system ou unsupported architecture	Aucune version native sélectionnée	Utilisez macOS/Linux amd64/arm64 ; cet installateur ne prend pas Windows natif en charge
<command> is required for release install	Utilitaire local absent	Installez-le puis relancez
Preflight failed: not enough ... space	Archive/binaire trop grands avec la réserve	Libérez espace temporaire/personnel ; mode compact seulement si moins d’historique acceptable
another Anyy install or update is already running	Répertoire verrouillé par une opération	Attendez sa fin puis réessayez
checksum mismatch	Archive différente de la somme publiée	Relancez sans contourner la vérification ni activer manuellement
Command entrypoint already exists and was not replaced	Fichier ou lien actif occupant le chemin	Lancez Binary: puis inspectez/résolvez le conflit
anyy: command not found après réussite	Répertoire absent du PATH	Suivez l’indication exacte, ouvrez un shell et lancez anyy --version
Gateway: status unavailable	Binaire incapable de rapporter l’état	Vérifiez séparément le binaire ; lancez anyy setup puis anyy gateway status au besoin
No release was activated.	Arrêt avant bascule	Corrigez l’erreur précédente puis réessayez ; l’ancienne active n’a pas été remplacée