Saltar al contenido principal
Yagua
EN Descargar
Explorar documentación

Instalar en Linux

Usa el AppImage para x86-64 o prepara un entorno Python si prefieres ejecutar el código fuente.

Guía basada en el código 2.0.1-rc.7. Las capturas muestran la interfaz en inglés de una edición de prelanzamiento; sus valores ilustran ejemplos, no necesariamente los ajustes iniciales. Los paquetes de Descargas pueden ser diferentes: revisa sus notas y las opciones de guardado antes de procesar.

En esta página

Usar el AppImage

  1. Descarga el archivo .AppImage de Releases correspondiente a Linux.
  2. Guárdalo en una carpeta permanente y con permiso de escritura para tus resultados.
  3. Dale permiso de ejecución y ábrelo. Sustituye el nombre de ejemplo por el descargado:
chmod +x "Yagua-<version>-x86_64.AppImage"
./"Yagua-<version>-x86_64.AppImage"

La referencia de CI es Ubuntu 22.04 x86-64. Eso no asegura que el AppImage final funcione en todas las distribuciones, sesiones gráficas o escritorios. El paquete incorpora sus bibliotecas Python; no requiere instalar Python por separado.

Si aparece un error de FUSE

La ejecución por montaje del AppImage necesita FUSE 2. En distribuciones compatibles, la biblioteca puede llamarse libfuse2; verifica el nombre apropiado para tu distribución. FUSE 3 no reemplaza automáticamente ese requisito. Consulta las instrucciones oficiales de AppImage.

Si no puedes usar FUSE, prueba el modo de extracción y ejecución:

./"Yagua-<version>-x86_64.AppImage" --appimage-extract-and-run

La extracción necesita espacio temporal adicional y puede demorar más en arrancar. Si el runtime de tu AppImage no admite ese modo, la documentación oficial también explica la extracción manual. No borres los archivos extraídos mientras la aplicación esté ejecutándose.

Preferencias y actualizaciones

Yagua guarda preferencias y registro en ~/.config/Yagua/. Los modelos de IA tienen sus propias ubicaciones. No es necesario escribir las fotografías dentro del AppImage: elige una carpeta de salida normal de tu usuario.

Para actualizar, descarga el nuevo AppImage, cierra la versión anterior y ejecuta el nuevo archivo con permisos de ejecución. La aplicación abre enlaces de descarga, pero no reemplaza el paquete por sí sola.

Ejecución desde código, opcional

Necesitas Git, Python 3.13 con soporte Tk y bibliotecas de sistema. Como referencia, CI instala en Ubuntu 22.04:

sudo apt-get install python3-tk libgl1 libglib2.0-0 libsm6 libxext6 libxrender1 libgtk-3-0 libgomp1

El Tk de la distribución debe corresponder al intérprete utilizado; instalar python3-tk no garantiza cubrir un Python 3.13 instalado por otro medio.

git clone https://github.com/GuilleBouix/Yagua-Image-Processor.git
cd Yagua-Image-Processor
python3.13 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements-linux-cpu.txt
python main.py

El archivo de dependencias Linux CPU es el utilizado por CI para esa plataforma. No ejecutes la interfaz como administrador para compensar problemas de permisos; usa carpetas de tu usuario y una sesión gráfica disponible.