Configuration macOS

Apercu

YeePilot fonctionne nativement sous macOS avec le support des Mac Intel et Apple Silicon. Ce guide couvre l'installation, l'integration du Trousseau, les permissions Gatekeeper et les considerations specifiques a macOS.

Configuration requise

Installation

Installation rapide (recommandee)

Le script d'installation detecte automatiquement l'architecture de votre Mac et installe le binaire correct :

curl -fsSL https://yee.to/install.sh | bash

Cela va :

1. Detecter si vous etes sur Intel ou Apple Silicon.
2. Telecharger le binaire natif approprie.
3. Verifier la somme de controle du telechargement.
4. Installer le binaire dans /usr/local/bin/yeepilot.

Apres l'installation, verifiez que cela fonctionne :

yeepilot version

Installation manuelle

1. Telechargez l'archive correcte depuis la page des versions (opens in new tab) :

   • yeepilot-darwin-amd64.tar.gz pour les Mac Intel
   • yeepilot-darwin-arm64.tar.gz pour les Mac Apple Silicon (M1, M2, M3, M4)

2. Extrayez et installez :

tar xzf yeepilot-darwin-arm64.tar.gz
sudo mv yeepilot /usr/local/bin/
sudo chmod +x /usr/local/bin/yeepilot

3. Verifiez l'installation :

yeepilot version

Permissions Gatekeeper

Gatekeeper de macOS peut bloquer YeePilot la premiere fois que vous le lancez car le binaire n'est pas signe avec un certificat Apple Developer. Vous verrez un message du type : "yeepilot" ne peut pas etre ouvert car le developpeur ne peut pas etre verifie.

Autoriser via les Reglages Systeme

1. Ouvrez Reglages Systeme (ou Preferences Systeme sur les versions anterieures de macOS).
2. Allez dans Confidentialite et securite.
3. Faites defiler jusqu'a la section Securite.
4. Vous devriez voir un message indiquant que yeepilot a ete bloque. Cliquez sur Autoriser quand meme.
5. Relancez yeepilot version et cliquez sur Ouvrir dans la boite de dialogue de confirmation.

Autoriser via le Terminal

Alternativement, supprimez directement l'attribut de quarantaine :

xattr -d com.apple.quarantine /usr/local/bin/yeepilot

Cela ne doit etre fait qu'une seule fois. Les mises a jour ulterieures peuvent necessiter de repeter cette etape.

Configuration initiale

Executez la configuration interactive pour configurer votre fournisseur IA :

yeepilot setup

Cela cree votre fichier de configuration dans ~/.yeepilot/config.yaml.

Stockage des identifiants

YeePilot utilise automatiquement le Trousseau macOS pour stocker les cles API et les tokens d'authentification. Cela fournit un stockage securise et chiffre qui s'integre a votre connexion systeme.

• Les identifiants sont stockes dans le trousseau de connexion par defaut.
• Vous pourriez voir une invite d'Acces au trousseau la premiere fois que YeePilot stocke ou recupere un identifiant. Cliquez sur Toujours autoriser pour eviter les invites repetees.
• Les identifiants sont etiquetes avec yeepilot dans Acces au trousseau pour une identification facile.

Consulter les identifiants stockes

Ouvrez Acces au trousseau (dans Applications > Utilitaires) et recherchez yeepilot pour voir les identifiants stockes.

Aucune configuration supplementaire requise

Contrairement a Linux, aucun paquet supplementaire n'est necessaire pour le stockage des identifiants sous macOS. Le Trousseau est disponible sur toutes les installations macOS.

Limitations du sandbox

macOS ne supporte pas les espaces de noms du noyau Linux. YeePilot utilise a la place des limites de ressources au niveau du processus, qui fournissent une isolation de base :

• Limites de temps CPU -- Les commandes sont terminees si elles depassent le temps CPU configure.
• Limites de memoire -- La memoire du processus est plafonnee au maximum configure.
• Limites de taille de fichier -- La creation de fichiers individuels est limitee.

Pour configurer les parametres du sandbox :

# ~/.yeepilot/config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # Non disponible sous macOS, automatiquement desactive
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64

Notez que use_namespaces est automatiquement defini a false sous macOS quelle que soit la valeur de configuration. Aucune action de votre part n'est requise.

Pour une isolation complete par espaces de noms, envisagez d'executer YeePilot dans une machine virtuelle Linux ou un conteneur Docker sur votre Mac.

Notes Apple Silicon

YeePilot fournit un binaire arm64 natif pour les Mac Apple Silicon (series M1, M2, M3, M4). Il fonctionne sans traduction Rosetta 2, assurant des performances optimales.

Pour confirmer que vous executez le binaire natif :

file $(which yeepilot)

Vous devriez voir une sortie contenant arm64 pour Apple Silicon ou x86_64 pour Intel.

Si vous avez accidentellement installe la version Intel sur un Mac Apple Silicon, elle fonctionnera toujours via Rosetta 2, mais reinstaller avec la bonne architecture est recommande :

curl -fsSL https://yee.to/install.sh | bash

Le script d'installation detecte et installe toujours l'architecture correcte.

Recommandations de terminal

Le TUI de YeePilot fonctionne mieux avec les terminaux qui supportent :

• 256 couleurs ou couleurs vraies -- Pour un rendu correct des themes.
• Unicode -- Pour les caracteres de dessin de boites et les indicateurs d'etat.
• Redimensionnement -- Le TUI s'adapte aux changements de taille du terminal.

Tous les terminaux macOS populaires fonctionnent bien :

Mise a jour

Mettre a jour vers la derniere version :

yeepilot update

Vous devrez peut-etre re-autoriser le binaire dans Gatekeeper apres une mise a jour (voir la section Permissions Gatekeeper ci-dessus).

Desinstallation

Supprimer YeePilot et toutes ses donnees :

yeepilot uninstall --all

Ou supprimer uniquement le binaire en conservant votre configuration :

yeepilot uninstall --binary-only

Pour une suppression manuelle :

sudo rm /usr/local/bin/yeepilot
rm -rf ~/.yeepilot

Les entrees du Trousseau stockees peuvent etre supprimees manuellement via Acces au trousseau en recherchant yeepilot et en supprimant les entrees correspondantes.