Installation
Installer l'application desktop (Linux, macOS, Windows) et l'extension navigateur WXT (Chrome, Brave, Edge, Firefox).
Akooti est un binaire unique (Rust + WebView système). Aucun service n'est installé, aucun compte n'est créé, rien n'est envoyé sans votre geste.
Application desktop
Depuis une release
Téléchargez le bundle de votre plateforme depuis
github.com/STIFLEUR390/akooti/releases,
puis vérifiez l'empreinte publiée à côté de l'archive (SHA256SUMS).
Deux formats sont produits : .deb et .AppImage.
# Debian / Ubuntu
sudo apt install ./Akooti_<version>_amd64.deb
# Fedora / toute distribution : AppImage
chmod +x Akooti_<version>_amd64.AppImage
./Akooti_<version>_amd64.AppImageLe paquet .deb déclare ses dépendances. Sur Fedora, l'AppImage suffit ; les
bibliothèques nécessaires sont :
sudo dnf install webkit2gtk4.1 libayatana-appindicator-gtk3Depuis les sources
Prérequis : Rust 1.90+, Bun 1.4+ et les bibliothèques système de votre distribution.
git clone https://github.com/STIFLEUR390/akooti
cd akooti
bun install
bun run tauri dev # développement (Vite + application)
bun run tauri build # bundles dans target/release/bundle/Dépendances Linux (Fedora) :
sudo dnf install webkit2gtk4.1-devel libappindicator-gtk3-devel \
librsvg2-devel openssl-devel gcc pkg-configFedora : appindicator sans en-têtes de développement
Le CLI Tauri cherche ayatana-appindicator3-0.1.pc, absent quand seul le
runtime est installé. Contournement local avant bun run tauri build :
mkdir -p /tmp/appindicator-lib /tmp/pkgconfig
ln -sf /lib64/libayatana-appindicator3.so.1 /tmp/appindicator-lib/libayatana-appindicator3.so
ln -sf /lib64/libayatana-appindicator3.so.1 /tmp/appindicator-lib/libayatana-appindicator3.so.1
# /tmp/pkgconfig/ayatana-appindicator3-0.1.pc : libdir=/tmp/appindicator-lib, Libs: -layatana-appindicator3
PKG_CONFIG_PATH=/tmp/pkgconfig bun run tauri buildSur Ubuntu, libayatana-appindicator3-dev fournit tout.
Premier lancement
Créer le coffre. Écran d'accueil → Nouveau coffre (si aucun coffre n'existe).
Choisir un mot de passe maître de 12 caractères minimum. Une phrase de passe générée par Akooti est idéale. Notez-la hors de cette machine : il n'existe aucune récupération.
Suivre le guide de démarrage : cinq étapes vers les écrans réels (importer, créer un jeton IA, configurer une sauvegarde, lancer un audit).
Restaurer un coffre existant (facultatif) : écran de déverrouillage →
Restaurer un instantané → choisir un fichier .akooti. La restauration
remplace le coffre local et exige le mot de passe maître de l'instantané.
Le message « aucun lecteur d'empreintes branché » est normal : la biométrie n'est pas livrée (ADR 0005).
Mises à jour
Akooti → Vérifier les mises à jour dans la barre latérale. L'application vérifie un manifeste signé (Ed25519) et refuse toute mise à jour dont la signature ne correspond pas à la clé publique embarquée dans le binaire.
Désinstaller
Désinstaller le paquet retire le binaire, pas vos données. Le coffre vit dans le dossier de données de l'application :
| Système | Dossier |
|---|---|
| Linux | ~/.local/share/com.akooti.desktop/ |
| macOS | ~/Library/Application Support/com.akooti.desktop/ |
| Windows (cible) | %APPDATA%\com.akooti.desktop\ |
Sauvegardez d'abord un .akooti (voir Sync et sauvegardes),
puis supprimez ce dossier : il n'y a aucune récupération possible ensuite.
Extension navigateur (WXT)
Un seul source, compilé vers Chrome, Edge, Brave (MV3, Chrome ≥ 116) et Firefox
(MV2, ≥ 115). L'extension ne fait aucun appel réseau : son unique route vers
le coffre est le pont Native Messaging org.akooti.host.
Compiler
bun install
bun run --filter @akooti/extension build # Chrome / Brave / Edge
bun run --filter @akooti/extension build:firefox # FirefoxSorties : .output/chrome-mv3 et .output/firefox-mv2. Pour produire des
archives destinées à un store : bun run --filter @akooti/extension zip et
zip:firefox.
Charger dans le navigateur
- Ouvrir
chrome://extensions(oubrave://extensions,edge://extensions). - Activer le mode développeur.
- Charger l'extension non empaquetée → choisir
.output/chrome-mv3. - Relever l'ID affiché sur la carte de l'extension : il est dérivé du chemin du dossier et sert à autoriser le pont natif.
Enregistrer le pont natif
Le navigateur refuse de lancer un hôte natif qui n'est pas déclaré. La commande
akooti native-register écrit ce manifeste, par navigateur et par OS.
# Chromium : l'ID de l'extension est obligatoire
akooti native-register --extension-id <id-chrome-extension>
# Un seul navigateur
akooti native-register --browser brave --extension-id <id>
# Firefox : id épinglé par défaut (extension@akooti.local)
akooti native-register --browser firefox
# Vérifier sans écrire, réparer, ou supprimer
akooti native-register --check
akooti native-register --uninstallOptions utiles : --browser <nom> (répétable ou séparé par des virgules :
chrome, chromium, edge, brave, firefox ; défaut : tous), --host <chemin absolu>
(par défaut, le binaire courant), --home <chemin> (installation scriptée ou
bac à sable), --firefox-id <id>.
Emplacements écrits sous Linux :
| Navigateur | Manifeste |
|---|---|
| Chrome | ~/.config/google-chrome/NativeMessagingHosts/org.akooti.host.json |
| Chromium | ~/.config/chromium/NativeMessagingHosts/org.akooti.host.json |
| Edge | ~/.config/microsoft-edge/NativeMessagingHosts/org.akooti.host.json |
| Brave | ~/.config/BraveSoftware/Brave-Browser/NativeMessagingHosts/org.akooti.host.json |
| Firefox | ~/.mozilla/native-messaging-hosts/org.akooti.host.json |
Sous macOS, la racine est ~/Library/Application Support/ (Google/Chrome,
Chromium, Microsoft Edge, BraveSoftware/Brave-Browser, Mozilla), suivie
de NativeMessagingHosts/.
Appairer l'extension
- Dans l'application déverrouillée → Accès IA → créer un jeton avec les
portées Lire les métadonnées (
read_metadata) et Remplir aveuglément (blind_fill), limité aux dossiers utiles. - Copier le secret (
ak_mcp_…, affiché une seule fois). - Ouvrir la popup de l'extension, coller le jeton, valider.
La pastille d'en-tête indique l'état réel : non appairé, application fermée,
coffre verrouillé, coffre déverrouillé. Le jeton vit dans storage.local
(jamais storage.sync), n'est jamais journalisé, et Dissocier l'efface.
Ordre des opérations
Le daemon doit tourner (application ouverte et déverrouillée). Sans lui, la
popup affiche « application fermée » et les appels MCP répondent
daemon_unavailable.