Paneflow unter Linux installieren

Paneflow bietet Linux-Pakete für x86_64 und ARM64 (aarch64). Wähle unten das Format für deine Distribution. Du brauchst weder Rust noch Build-Werkzeuge, um diese Pakete zu installieren.

Wähle ein Installationsformat

Führe die Download- und Installationsbefehle in Bash mit installiertem curl aus, im Ordner, in den du das Paket herunterladen möchtest. Jeder Download-Block erkennt deine Prozessorarchitektur und lädt die aktuelle Version herunter. Wähle ein Format; du musst nicht alle vier installieren.

Wie installiere ich Paneflow als AppImage?

Mit dem AppImage kannst du Paneflow ohne Systempaket und ohne sudo starten. Lade die Datei herunter, mache sie ausführbar und starte sie:

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"

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

Um den Befehl paneflow zu verwenden, verschiebe das AppImage nach ~/.local/bin und benenne es in paneflow um:

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

Wenn deine Shell den Befehl nicht findet, folge den PATH-Anweisungen unten. Falls du nach dem Verschieben weiterhin ohne FUSE starten musst, nutze ~/.local/bin/paneflow --appimage-extract-and-run. Paneflow speichert Einstellungen und Workspace-Zustand standardmäßig unter ~/.paneflow, getrennt vom AppImage. Lies die Konfigurationsanleitung.

Wie installiere ich Paneflow unter Ubuntu oder Debian?

Lade das .deb für deinen Prozessor herunter und installiere es mit apt:

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"

Das Paket installiert paneflow unter /usr/bin/paneflow und registriert das Paneflow-Paketrepository. Führe für spätere Updates sudo apt update und dann sudo apt upgrade paneflow aus.

Zum Deinstallieren nutze sudo apt remove paneflow. Mit sudo apt purge paneflow entfernst du auch den Repository-Eintrag und den Signaturschlüssel von Paneflow.

Wie installiere ich Paneflow unter Fedora oder openSUSE?

Lade das .rpm für deinen Prozessor herunter. Installiere es auf Fedora mit dnf. Ersetze auf openSUSE vor dem Ausführen des Blocks die letzte Installationszeile wie unten beschrieben:

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"

Ersetze auf openSUSE die letzte Zeile sudo dnf install durch:

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

Das Paket registriert das Paneflow-RPM-Repository. Nutze für spätere Updates sudo dnf upgrade paneflow auf Fedora oder sudo zypper update paneflow auf openSUSE.

Wie installiere ich Paneflow aus einem Tarball?

Nutze das .tar.gz-Archiv für eine Installation im Home-Verzeichnis, auch auf Arch. Lade es herunter, entpacke es und führe den enthaltenen Installer aus:

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

Der Installer kopiert die App nach ~/.local/paneflow.app, erstellt den Symlink ~/.local/bin/paneflow und legt den App-Starter und die Icons unter ~/.local/share ab. Führe ihn ohne sudo aus.

Wie überprüfe ich die Installation?

Öffne ein Terminal und führe aus:

paneflow --version
paneflow

Der erste Befehl sollte die installierte Version ausgeben. Der zweite sollte das Paneflow-Fenster öffnen. Wird der Befehl nicht gefunden, folge den PATH-Anweisungen unten. Öffnet sich das Fenster nicht, lies die Anleitung zur Fehlerbehebung bei Start und Grafik.

Sobald Paneflow geöffnet ist, nutze die Anleitung für den Einstieg, um deinen ersten Agenten zu starten. Installiere CLI-Agenten separat und folge ihren Anmeldeanweisungen.

Was, wenn paneflow nicht in meinem PATH gefunden wird?

Die Schritte unten gelten für AppImage und .tar.gz. Öffne bei einer .deb- oder .rpm-Installation ein neues Terminal und führe /usr/bin/paneflow --version aus. Fehlt diese Datei, installiere das Paket erneut.

Wenn deine Shell command not found meldet, prüfe zuerst mit ls -l ~/.local/bin/paneflow, ob die Datei oder der Symlink existiert. Falls nicht, wiederhole das Verschieben des AppImage oder die .tar.gz-Installation oben.

Wenn die Datei existiert, aber der Befehl nicht gefunden wird, füge ~/.local/bin zum PATH deiner Shell hinzu. Führe nur den Block für deine Shell aus, einmal:

Bash (~/.bashrc):

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

Zsh (~/.zshrc):

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

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

fish_add_path ~/.local/bin

Öffne ein neues Terminal und führe paneflow --version erneut aus. Falls es weiterhin fehlschlägt, lies die PATH-Fehlerbehebung.