Aller au contenu
PaneflowPaneflow

Installer Paneflow sur Linux

Installez Paneflow sur Linux avec AppImage, .deb, .rpm ou .tar.gz. Choisissez un paquet x86_64 ou ARM64, vérifiez les prérequis Vulkan et résolvez les erreurs FUSE ou PATH.

Paneflow propose des paquets Linux pour x86_64 et ARM64 (aarch64). Choisissez ci-dessous le format adapté à votre distribution. Vous n'avez pas besoin de Rust ni d'outils de compilation pour installer ces paquets.

Choisissez un format d'installation

Distribution ou type d'installationFormatMises à jour
Ubuntu, Debian.debAvec apt après la première installation
Fedora, openSUSE.rpmAvec dnf ou zypper après la première installation
Lancer un fichier téléchargé sans paquet systèmeAppImageDepuis l'application
Arch ou installation dans votre dossier personnel.tar.gzDepuis l'application ou avec une archive plus récente

Paneflow nécessite une session graphique et un pilote GPU compatible avec Vulkan. Les paquets .deb et .rpm déclarent les bibliothèques système nécessaires, mais un pilote GPU fonctionnel reste indispensable. Pour AppImage et .tar.gz, vérifiez que le chargeur Vulkan est installé : libvulkan1 sur Debian et Ubuntu, vulkan-loader sur Fedora ou vulkan-icd-loader sur Arch. En cas d'erreur graphique, consultez le guide de dépannage Vulkan.

Exécutez les commandes de téléchargement et d'installation dans Bash, avec curl installé, depuis le dossier où vous souhaitez télécharger le paquet. Chaque bloc de téléchargement détecte l'architecture de votre processeur et récupère la dernière version publiée. Choisissez un seul format.

Comment installer Paneflow en AppImage ?

Utilisez l'AppImage pour lancer Paneflow sans installer de paquet système ni utiliser sudo. Téléchargez le fichier, rendez-le exécutable et lancez-le :

bash
ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.AppImage"
chmod +x "paneflow-${VERSION}-${ARCH}.AppImage"
./"paneflow-${VERSION}-${ARCH}.AppImage"

Si le lancement échoue avec dlopen(): error loading libfuse.so.2, lancez l'AppImage sans FUSE :

bash
./"paneflow-${VERSION}-${ARCH}.AppImage" --appimage-extract-and-run

Sur Ubuntu 24.04, vous pouvez installer la bibliothèque FUSE 2 avec sudo apt install libfuse2t64, puis lancer l'AppImage normalement. Pour les autres distributions, consultez les instructions FUSE d'AppImage.

Pour utiliser la commande paneflow, déplacez l'AppImage dans ~/.local/bin et renommez-la paneflow :

bash
mkdir -p ~/.local/bin
mv "paneflow-${VERSION}-${ARCH}.AppImage" ~/.local/bin/paneflow
chmod +x ~/.local/bin/paneflow

Si votre shell ne trouve pas la commande, suivez les instructions sur le PATH ci-dessous. Si vous devez encore lancer le fichier sans FUSE après l'avoir déplacé, utilisez ~/.local/bin/paneflow --appimage-extract-and-run. Paneflow stocke ses paramètres et l'état de l'espace de travail dans ~/.paneflow par défaut, séparément de l'AppImage. Consultez le guide de configuration.

Comment installer Paneflow sur Ubuntu ou Debian ?

Téléchargez le .deb adapté à votre processeur et installez-le avec apt :

bash
DEB_ARCH="$(dpkg --print-architecture)"
case "$DEB_ARCH" in
  amd64) ARCH="x86_64" ;;
  arm64) ARCH="aarch64" ;;
  *) echo "Unsupported architecture: $DEB_ARCH" >&2; exit 1 ;;
esac
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.deb"
sudo apt install "./paneflow-${VERSION}-${ARCH}.deb"

Le paquet installe paneflow dans /usr/bin/paneflow et enregistre le dépôt de paquets Paneflow. Pour les mises à jour suivantes, exécutez sudo apt update, puis sudo apt upgrade paneflow.

Pour désinstaller Paneflow, exécutez sudo apt remove paneflow. Utilisez sudo apt purge paneflow pour retirer aussi le dépôt Paneflow et sa clé de signature.

Comment installer Paneflow sur Fedora ou openSUSE ?

Téléchargez le .rpm adapté à votre processeur. Sur Fedora, installez-le avec dnf. Sur openSUSE, remplacez la dernière ligne d'installation comme indiqué plus bas avant d'exécuter le bloc :

bash
ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.rpm"
sudo dnf install "./paneflow-${VERSION}-${ARCH}.rpm"

Sur openSUSE, remplacez la dernière ligne sudo dnf install par :

bash
sudo zypper install "./paneflow-${VERSION}-${ARCH}.rpm"

Le paquet enregistre le dépôt RPM Paneflow. Pour les mises à jour suivantes, utilisez sudo dnf upgrade paneflow sur Fedora ou sudo zypper update paneflow sur openSUSE.

Comment installer Paneflow depuis une archive tar ?

Utilisez l'archive .tar.gz pour une installation dans votre dossier personnel, notamment sur Arch. Téléchargez-la, extrayez-la, puis lancez le script d'installation inclus :

bash
ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.tar.gz"
tar -xzf "paneflow-${VERSION}-${ARCH}.tar.gz"
cd paneflow.app
./install.sh

Le script copie l'application dans ~/.local/paneflow.app, crée le lien symbolique ~/.local/bin/paneflow et ajoute le lanceur d'application et les icônes dans ~/.local/share. Exécutez-le sans sudo.

Comment vérifier l'installation ?

Ouvrez un terminal et exécutez :

bash
paneflow --version
paneflow

La première commande doit afficher la version installée. La seconde doit ouvrir la fenêtre de Paneflow. Si la commande est introuvable, suivez les instructions sur le PATH ci-dessous. Si la fenêtre ne s'ouvre pas, consultez le guide de dépannage du lancement et de l'affichage.

Une fois Paneflow ouvert, suivez le guide des premiers pas pour lancer votre premier agent. Installez les agents CLI séparément et suivez leurs instructions de connexion.

Que faire si paneflow est introuvable dans mon PATH ?

Les étapes ci-dessous concernent AppImage et .tar.gz. Pour une installation .deb ou .rpm, ouvrez un nouveau terminal et exécutez /usr/bin/paneflow --version. Si ce fichier est absent, réinstallez le paquet.

Si votre shell affiche command not found, vérifiez d'abord que le fichier ou le lien symbolique existe avec ls -l ~/.local/bin/paneflow. S'il est absent, reprenez l'étape de déplacement de l'AppImage ou l'installation .tar.gz ci-dessus.

Si le fichier existe mais que la commande reste introuvable, ajoutez ~/.local/bin au PATH de votre shell. Exécutez uniquement le bloc correspondant à votre shell, une seule fois :

Bash (~/.bashrc) :

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Zsh (~/.zshrc) :

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Fish (~/.config/fish/config.fish) :

fish
fish_add_path ~/.local/bin

Ouvrez un nouveau terminal et relancez paneflow --version. Si la commande échoue encore, consultez le guide de dépannage du PATH.