Skip to main content
Yagua
ES Download
Explore documentation

Install on Linux

Use the x86-64 AppImage, or prepare a Python environment if you prefer running the source code.

Guide based on source version 2.0.1-rc.7. Screenshots show the English interface of a prerelease edition; their values illustrate examples, not necessarily defaults. Packages on Downloads may differ: review their release notes and saving options before processing.

On this page

Use the AppImage

  1. Download the Linux .AppImage from Releases.
  2. Save it in a permanent folder and choose a writable location for your results.
  3. Make it executable and open it. Replace the example filename with your download:
chmod +x "Yagua-<version>-x86_64.AppImage"
./"Yagua-<version>-x86_64.AppImage"

CI uses Ubuntu 22.04 x86-64. That does not guarantee the final AppImage works on every distribution, graphical session, or desktop. The package includes its Python libraries; no separate Python installation is required.

If you get a FUSE error

Mounted AppImage execution requires FUSE 2. On compatible distributions its library may be called libfuse2; check the appropriate package for your distribution. FUSE 3 does not automatically replace that requirement. Read the official AppImage instructions.

If FUSE is unavailable, try extraction and execution:

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

Extraction uses extra temporary space and can take longer to start. If your AppImage runtime does not support this mode, the official documentation also covers manual extraction. Do not delete extracted files while the app is running.

Preferences and updates

Preferences and logs are stored in ~/.config/Yagua/. AI models have separate locations. Your photographs do not need to live inside the AppImage: choose a normal user folder for output.

To update, download the new AppImage, close the old version, and run the new executable file. Yagua opens download links but does not replace the package itself.

Run from source, optional

You need Git, Python 3.13 with Tk support, and system libraries. As a reference, CI installs these on Ubuntu 22.04:

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

The distribution’s Tk must match your interpreter. Installing python3-tk does not guarantee coverage for Python 3.13 installed another way.

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

CI uses the Linux CPU requirements file for that platform. Do not run the interface as administrator to work around permissions: use writable user folders and an available graphical session.