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
48

# Installer Sidekicks

Ce guide montre comment installer Sidekicks à partir des paquets d'une release, sous macOS, Linux ou Windows. 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 et Intel)

Sidekicks demande macOS 13 (Ventura) ou plus récent.

1. Téléchargez `Sidekicks-<version>-macos-universal.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.

## Linux (x86-64)

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).

- **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`.
- **Le programme seul** : `sidekicks_<version>_linux_amd64.tar.gz` contient `sidekicks` ; les bibliothèques GTK 4 et WebKitGTK 6 doivent être installées.

Le `.deb` et le `.rpm` ajoutent Sidekicks au menu des applications.

## Windows (x86-64)

1. Téléchargez `Sidekicks-<version>-windows-amd64-installer.exe` et lancez-le.
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` contient `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.

## Variantes

- **Vérifier un téléchargement** : `shasum -a 256 <fichier>` (macOS) ou `sha256sum <fichier>` (Linux), à 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`, `make package-linux` 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)