Installer sous macOS
Un seul script fait toute l'installation : il provisionne Homebrew, .NET et Python, copie
l'agent dans votre répertoire personnel et l'enregistre pour qu'il démarre à l'ouverture de
session. Il s'exécute sous votre utilisateur normal — pas de sudo.
Apple Silicon ou Intel ?
Il y a une archive par famille de puces, et la mauvaise vous donne un binaire qui ne peut pas s'exécuter du tout :
filemote-<version>-osx-arm64.tar.gz— Apple Silicon (M1 et suivants)filemote-<version>-osx-x64.tar.gz— Intel
Dans le doute, ouvrez → À propos de ce Mac. « Puce : Apple M… » signifie Apple Silicon ; « Processeur : Intel » signifie Intel.
Installation
tar xzf filemote-<version>-osx-arm64.tar.gz
cd filemote-<version>-osx-arm64
xattr -dr com.apple.quarantine .
chmod +x install-macos.sh
./install-macos.sh
La ligne xattr efface l'indicateur de quarantaine que macOS attache aux fichiers
téléchargés. Elle compte si vous avez extrait avec le Finder et est sans effet sinon — voir
pourquoi macOS bloque le téléchargement.
N'exécutez pas le script avec sudo. Il est prévu pour installer dans votre propre compte,
et il n'a besoin d'élévation que si vous pointez --prefix vers un endroit où votre
utilisateur ne peut pas écrire.
Ce que le script provisionne
- Homebrew, installé depuis le script officiel s'il est absent. Sur Apple Silicon, il
ajoute aussi Homebrew à votre
~/.zprofile. - L'environnement d'exécution .NET 8, via Homebrew, avec repli sur le script
d'installation de Microsoft dans
~/.dotnetsi les paquets Homebrew sont indisponibles. - Python 3.12, via Homebrew, s'il n'y a rien de plus récent que 3.10.
- L'agent lui-même, dans
~/Applications/Filemote, avec l'indicateur de quarantaine effacé sur la copie installée.
Comme tout s'exécute sous votre utilisateur, l'agent n'atteint que les fichiers que votre compte peut lire — et seulement tant que vous êtes connecté.
L'agent launchd
Sauf si vous avez passé --no-autostart, le script écrit
~/Library/LaunchAgents/com.filemote.agent.plist et le charge, de sorte que l'agent démarre
à chaque ouverture de session et se relance s'il plante.
launchctl start com.filemote.agent # le démarrer maintenant
launchctl stop com.filemote.agent # l'arrêter
tail -f ~/Library/Logs/Filemote/filemote-agent.log
Avec --no-autostart, il n'y a ni entrée launchd ni fichier journal : aucune de ces
commandes ne s'applique — vous lancez ~/Applications/Filemote/FilemoteAgent vous-même.
Options du script
| Option | Effet |
|---|---|
--no-ai | Ignorer le service d'IA — ni Python, ni dépendances |
--no-autostart | Installer les fichiers sans rien enregistrer auprès de launchd |
--prefix /path | Installer ailleurs que dans ~/Applications/Filemote |
--model <id> | Présélectionner le modèle d'IA principal |
--device cpu|gpu|auto | Périphérique de calcul pour l'IA |
--hf-token <token> | Jeton Hugging Face, pour les modèles à accès restreint |
--gpu est accepté et ignoré sous macOS. Apple Silicon bénéficie de toute façon de
l'accélération Metal, car le moteur d'IA l'active de lui-même ; les Mac Intel exécutent le
moteur sur le CPU dans les deux cas.
L'IA sur un Mac
Installer les dépendances d'IA compile le moteur llama.cpp, ce qui nécessite les outils en ligne de commande de Xcode ; le script déclenche leur installation s'ils sont absents. Sur Apple Silicon, le moteur est compilé avec l'accélération Metal, sur Intel il s'exécute sur le CPU.
Mise à niveau depuis une installation d'avant le changement de nom
Si l'ancienne entrée launchd com.rfm.agent est encore là, le script la décharge et la
supprime — sans quoi deux agents se disputeraient le même compte — et déplace vos paramètres
et vos modèles téléchargés depuis ~/Applications/RFM, en vous laissant supprimer l'ancien
dossier.
Étape suivante
L'agent est installé mais pas encore connecté à votre compte : relier un appareil à votre compte.
Mis à jour le 2026-07-31