Skip to main content
Explore documentation

Download and choose a version

Choose the right package for your system and understand the difference between a stable release, a prerelease, and 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

Where to download

Open the project’s GitHub Releases. Each release has a name, description, and Assets list containing its downloadable files. Read the complete release before choosing one.

A version number in a guide is not a permanent download link. The releases list shows the platforms, changes, known issues, and files actually available.

Stable releases, prereleases, and source

TypeHow to identify itWhat it means
StableNot marked Pre-releasePublished as stable; check its date and features, because it may predate the RC builds.
PrereleaseMarked Pre-release, often with rc in its nameA test version with new features and limitations still awaiting validation.
Current sourceRepository files run with PythonMay contain changes newer than published packages. It does not mean an installer is available.

Windows and Linux releases can have different versions. Modern tags use win-v and linux-v; check the system in the name and release notes.

Which file to choose

System or setupTypical fileChoose it when…
Installed Windows appYagua_Setup_<version>.exeYou want installation, shortcuts, and Windows uninstallation.
Windows without an installerYagua_Portable_<version>.zipYou prefer extracting a complete folder and running the app there.
Linux x86-64Yagua-<version>-x86_64.AppImageYou want the Linux package without setting up Python.

These names are examples: use the attachments on your chosen release. Source code (zip) and Source code (tar.gz) are GitHub’s source archives, not the Windows portable ZIP. Prebuilt packages do not require a separate Python installation.

Current packages target x86-64. No validated native ARM package is declared. macOS remains experimental; do not assume a stable installer exists for it.

Check before opening

  1. Confirm the project repository and the release you intended to use.
  2. Check the platform, version, prerelease status, and known issues.
  3. Download the complete package. If the release supplies a checksum file, follow its verification instructions.
  4. Keep a copy if you may need to reinstall that exact version.

Continue