Instalar Paneflow en Linux

Paneflow ofrece paquetes de Linux para x86_64 y ARM64 (aarch64). Elige abajo el formato para tu distribución. No necesitas Rust ni herramientas de compilación para instalar estos paquetes.

Elige un formato de instalación

Ejecuta los comandos de descarga e instalación en Bash, con curl instalado, desde la carpeta donde quieras descargar el paquete. Cada bloque de descarga detecta la arquitectura del procesador y obtiene la última versión. Elige un formato; no necesitas instalar los cuatro.

¿Cómo instalo Paneflow como AppImage?

Usa el AppImage para ejecutar Paneflow sin instalar un paquete de sistema ni usar sudo. Descarga el archivo, dale permiso de ejecución e inícialo:

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

Para usar el comando paneflow, mueve el AppImage a ~/.local/bin y cámbiale el nombre a paneflow:

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

Si tu shell no encuentra el comando, sigue las instrucciones de PATH más abajo. Si necesitas seguir ejecutándolo sin FUSE después de moverlo, usa ~/.local/bin/paneflow --appimage-extract-and-run. Paneflow guarda los ajustes y el estado del espacio de trabajo en ~/.paneflow por defecto, separado del AppImage. Consulta la guía de configuración.

¿Cómo instalo Paneflow en Ubuntu o Debian?

Descarga el .deb para tu procesador e instálalo con 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"

El paquete instala paneflow en /usr/bin/paneflow y registra el repositorio de paquetes de Paneflow. Para las siguientes actualizaciones, ejecuta sudo apt update y después sudo apt upgrade paneflow.

Para desinstalar, ejecuta sudo apt remove paneflow. Usa sudo apt purge paneflow para eliminar también la entrada del repositorio de Paneflow y su clave de firma.

¿Cómo instalo Paneflow en Fedora u openSUSE?

Descarga el .rpm para tu procesador. En Fedora, instálalo con dnf. En openSUSE, sustituye la última línea de instalación como se indica abajo antes de ejecutar el bloque:

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"

En openSUSE, sustituye la última línea sudo dnf install por:

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

El paquete registra el repositorio RPM de Paneflow. Para las siguientes actualizaciones, usa sudo dnf upgrade paneflow en Fedora o sudo zypper update paneflow en openSUSE.

¿Cómo instalo Paneflow desde un tarball?

Usa el archivo .tar.gz para instalar en tu directorio personal, también en Arch. Descárgalo, extráelo y ejecuta el instalador incluido:

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

El instalador copia la aplicación en ~/.local/paneflow.app, crea el enlace simbólico ~/.local/bin/paneflow y añade el lanzador de la aplicación y los iconos en ~/.local/share. Ejecútalo sin sudo.

¿Cómo verifico la instalación?

Abre un terminal y ejecuta:

paneflow --version
paneflow

El primer comando debe mostrar la versión instalada. El segundo debe abrir la ventana de Paneflow. Si no se encuentra el comando, sigue las instrucciones de PATH más abajo. Si no se abre la ventana, consulta la guía de solución de errores de inicio y gráficos.

Cuando Paneflow se abra, sigue la guía de primeros pasos para iniciar tu primer agente. Instala los agentes CLI por separado y sigue sus instrucciones de inicio de sesión.

¿Qué pasa si paneflow no está en mi PATH?

Los pasos siguientes se aplican a AppImage y .tar.gz. Para una instalación .deb o .rpm, abre un terminal nuevo y ejecuta /usr/bin/paneflow --version. Si falta ese archivo, reinstala el paquete.

Si tu shell muestra command not found, comprueba primero que el archivo o enlace simbólico exista con ls -l ~/.local/bin/paneflow. Si falta, repite el paso para mover el AppImage o la instalación .tar.gz de arriba.

Si el archivo existe pero no se encuentra el comando, añade ~/.local/bin al PATH de tu shell. Ejecuta solo el bloque para la shell que uses, una vez:

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

Abre un terminal nuevo y vuelve a ejecutar paneflow --version. Si sigue fallando, consulta la guía de solución de problemas de PATH.