Installation

Application web pour iPhone, iPad et Android

L’application web AirCode Ø reste disponible sans boutique d’applications. Elle est servie par votre propre instance en cours d’exécution et ne fait pas partie du canal des téléchargements signés. Elle reste donc accessible indépendamment de Google Play, de l’App Store et de TestFlight.

1. Démarrez une instance AirCode Ø et donnez-lui une adresse HTTPS stable. Consultez Démarrage rapide et Accès distant.
2. Ouvrez la page d’installation de l’application web, saisissez l’origine HTTPS de votre instance, puis choisissez Ouvrir la page d’installation. Cette option se trouve aussi sur la page Télécharger. Le site vérifie l’adresse localement : il ne la reçoit et ne l’enregistre jamais.
3. Connectez-vous sur l’instance. Chromium propose sa propre installation ; sur iPhone et iPad, suivez le guide Partager → Ajouter à l’écran d’accueil.
4. Ouvrez l’icône installée. Activez les notifications Push uniquement si vous souhaitez recevoir des alertes quand l’application est fermée. Sur iOS et iPadOS, ce réglage n’est proposé que dans l’application web ouverte depuis l’écran d’accueil.

L’installation est liée à une origine précise. Une adresse HTTP sur le réseau local ne suffit pas pour installer complètement une PWA mobile. Si l’adresse HTTPS de l’instance change, il faut faire une nouvelle installation et parfois se reconnecter. L’application web se met à jour depuis votre instance grâce à son service worker ; ce n’est ni un APK, ni un IPA, ni un paquet distribué par une boutique.

L’application web donne accès au cœur de l’espace de travail sur les petits écrans. L’application mobile native reste préférable si vous avez besoin de basculer entre serveurs dans l’application, de fichiers hors connexion chiffrés, de tâches de fond limitées mais plus fiables, du partage et de la numérisation natifs, de retours haptiques, de la priorité des canaux de notification ou de liens profonds gérés par le système.

Serveur Linux (bêta)

L’installateur n’est publié qu’après la validation du manifeste bêta, des sommes de contrôle et des signatures. Avant de lancer la commande, vérifiez que la version serveur est indiquée comme disponible sur la page des téléchargements.

curl -fsSL https://dl.aircodezero.com/install.sh | bash -s -- --channel beta

L’option --channel beta est nécessaire pendant la bêta privée : l’installateur utilise par défaut le canal stable, qui n’a pas encore de manifeste publié.

L’installateur :

1. détecte votre plateforme (linux-x64 ou linux-arm64) ;
2. télécharge l’archive de la version et vérifie sa somme de contrôle SHA-256 et sa signature Ed25519 ;
3. installe les fichiers dans ~/.aircode/versions/<version> avec un lien symbolique ~/.aircode/current ;
4. crée le lien vers aircode dans ~/.local/bin ;
5. vérifie les dépendances système (git, tmux) et indique précisément celles qui manquent.

Les droits administrateur ne sont pas nécessaires. Tous les fichiers se trouvent dans votre dossier personnel. Relancer l’installateur répare ou met à jour l’installation. Si ~/.local/bin ne figure pas dans le PATH du shell actuel, les instructions finales utilisent le chemin immédiatement exécutable ~/.aircode/current/bin/aircode et montrent aussi comment ajouter le dossier au PATH si vous le souhaitez.

Démarrez ensuite l’instance depuis le dossier qui contiendra les projets à sélectionner :

cd /srv/workspaces
aircode start

Sur Linux, aircode start crée une configuration liée à ce dossier, choisit un port libre, génère et affiche un mot de passe, démarre un service systemd pour l’utilisateur et active le redémarrage après une panne ou un redémarrage de la machine. La commande essaie aussi d’activer systemd linger et affiche une commande de correction précise si l’hôte exige des droits administrateur. Vous n’avez pas à écrire de fichier de service.

Si cette installation possède encore l’ancien service aircode.service, le premier aircode start le retire sans danger avant de créer le nouveau service lié au dossier, afin d’éviter que deux serveurs utilisent le même port. Les services appartenant à une autre installation ne sont pas modifiés.

Options de l’installateur : --channel beta (ou stable par défaut, après la première version stable), --version x.y.z et --no-modify-path. L’ancienne option --service reste compatible avec le service à instance unique ; pour une nouvelle installation, utilisez aircode start.

Configuration requise

L’environnement Node.js est intégré : aucune installation système de Node n’est requise.

macOS

Application de bureau (recommandée) : téléchargez le .dmg depuis la page des téléchargements. L’application contient le serveur complet pour les sessions locales et se connecte aussi aux serveurs distants.

Sans interface graphique / CLI : la même commande d’installation que sur Linux fonctionne à partir de macOS 13 (darwin-arm64 ou darwin-x64). Installez d’abord tmux avec Homebrew, puis utilisez aircode serve ; le démarrage persistant avec aircode start exige actuellement systemd sur Linux.

Windows

Installez l’application de bureau depuis la page des téléchargements. Les sessions locales s’exécutent nativement sur Windows avec ConPTY. L’installateur contient le serveur et son environnement Node.js : ni WSL, ni distribution Linux, ni installation de Node sur le système ne sont nécessaires. Il ajoute aussi aircode au PATH de l’utilisateur, ce qui permet de lancer le serveur intégré depuis PowerShell ou Command Prompt. Ouvrez un nouveau terminal après l’installation et consultez le guide de la ligne de commande Windows. L’application peut également se connecter à des serveurs AirCode Ø distants.

Modes de fonctionnement sur ordinateur

Ne démarrez pas l’application de bureau avec --serve : cela ouvre Electron et ne crée pas de mode serveur seul. Pour un serveur sans fenêtre, utilisez la commande aircode installée dans le PATH.

Une fois le mode Local configuré, le démarrage normal de l’application de bureau veille à ce que le serveur intégré fonctionne, même si la fenêtre est connectée à un serveur distant. Ce serveur n’écoute que sur 127.0.0.1. Pour vous connecter depuis un autre appareil, utilisez l’accès distant ou démarrez un serveur CLI qui écoute explicitement sur une adresse du réseau privé.

Sur Windows, fermer toutes les fenêtres laisse AirCode Ø et son serveur intégré actifs dans la zone de notification. Choisissez Quitter depuis cette icône pour arrêter le serveur. Un serveur CLI est un processus distinct qui peut coexister sur un autre port. Voir la section coexistence avec l’application de bureau.

Composants facultatifs volumineux

Rien de volumineux n’est téléchargé sans action explicite :

aircode browser install   # pinned Chromium for the agent browser
aircode doctor browser    # verify it

Knowledge utilise une recherche lexicale tant que vous n’avez pas installé explicitement un modèle local d’embeddings dans ses paramètres. Ce modèle est alors vérifié et utilisé hors connexion ; l’indexation ne déclenche jamais de téléchargement implicite.

L’image Docker pour les sessions est aussi facultative. Pendant l’aperçu depuis le code source, créez-la et vérifiez-la dans le dépôt :

npm run docker:runtime:build
npm run docker:session:smoke

Consultez le guide de l’environnement Docker isolé pour le choix sur web, bureau et mobile, les dossiers montés, les limites de ressources et la disponibilité de l’image publique.