Installer Sidekicks

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# Installer Sidekicks

Ce guide montre comment installer Sidekicks à partir des paquets d'une release, sous macOS ou Windows (Linux : construit depuis le dépôt). Les paquets sont sur la page des releases du projet, `https://rickub.com/bots-garden/sidekicks/releases` ; `SHA256SUMS` donne leurs sommes de contrôle.

Sidekicks discute avec des agents, il n'en contient pas. Installez aussi le programme de votre agent (par exemple `mm`).

## macOS (Apple Silicon)

Sidekicks demande un Mac Apple Silicon (M1 ou plus récent) et macOS 13 (Ventura) ou plus récent ; il n'y a pas de version pour les Mac Intel.

1. Téléchargez `Sidekicks-<version>-macos-arm64.dmg` et ouvrez-le.
2. Glissez **sidekicks** dans **Applications**.
3. Ouvrez-le une fois depuis **Applications**. L'application n'est pas signée par un compte développeur Apple : macOS la refuse la première fois (« Apple n'a pas pu vérifier… »).
4. Ouvrez **Réglages Système → Confidentialité et sécurité**, descendez jusqu'au message sur Sidekicks, cliquez sur **Ouvrir quand même**, puis confirmez.

Ensuite, Sidekicks s'ouvre normalement.

## Windows (x86-64 et Arm)

1. Téléchargez l'installateur de votre processeur et lancez-le : `Sidekicks-<version>-windows-amd64-installer.exe` (Intel et AMD) ou `Sidekicks-<version>-windows-arm64-installer.exe` (Windows sur Arm, par exemple Snapdragon). **Paramètres → Système → Informations système → Type du système** indique lequel vous avez.
2. L'installateur n'est pas signé : Windows SmartScreen peut afficher « Windows a protégé votre ordinateur ». Cliquez sur **Informations complémentaires**, puis **Exécuter quand même**.
3. L'installateur ajoute Microsoft Edge WebView2 s'il manque, puis un raccourci Sidekicks.

`sidekicks_<version>_windows_amd64.zip` et `sidekicks_<version>_windows_arm64.zip` contiennent `sidekicks.exe` seul, pour une machine où WebView2 est déjà présent.

Sous Windows, l'onglet **Terminal** d'un agent n'est pas encore disponible ; les fichiers, les conversations et les agents dans Docker fonctionnent.

## Linux

Les releases ne contiennent pas de paquets Linux pour le moment. Construisez-les depuis le dépôt, sous Linux (`make package-linux`) ou sur un Mac avec Docker (`LINUX_ARCHES=amd64 make release-build`), puis :

- **Debian, Ubuntu** : `sudo apt install ./sidekicks_<version>_linux_amd64.deb`
- **Fedora** : `sudo dnf install ./sidekicks_<version>_linux_amd64.rpm`
- **Toute distribution, sans installer** : `chmod +x Sidekicks-<version>-x86_64.AppImage`, puis lancez-le. S'il se plaint de FUSE, lancez-le avec `--appimage-extract-and-run`.

Sidekicks a besoin de GTK 4 et de WebKitGTK 6 (Ubuntu 24.04 ou plus récent, Debian 13, Fedora 40 ou plus récent).

## Variantes

- **Vérifier un téléchargement** : `shasum -a 256 <fichier>` (macOS) ou `Get-FileHash <fichier>` dans PowerShell (Windows), à comparer avec `SHA256SUMS`.
- **macOS, depuis un terminal** : `xattr -dr com.apple.quarantine /Applications/sidekicks.app` lève la quarantaine, à la place de l'étape 4.
- **Le construire soi-même** : `make package-macos` ou `make package-windows` (voir [Publier une release](publier-une-release.md)).

## Voir aussi

- [Tutoriel : votre premier agent, sans écrire de configuration](../tutorials/premier-agent.md)
- [Repartir de zéro](repartir-de-zero.md)