Saltar al contenido principal
Yagua
EN Descargar
Explorar documentación

Instalar en Windows

Instala Yagua con el ejecutable de instalación o usa el ZIP portable, sin mezclar los archivos de ambos paquetes.

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

Preparación

Usa Windows 10 u 11 de 64 bits en un equipo x86-64; se prefiere Windows 11. Consulta los requisitos y su estado de validación. Descarga los archivos desde Releases.

Instalador

  1. Cierra las instancias de Yagua y espera a que terminen sus operaciones.
  2. Ejecuta Yagua_Setup_<version>.exe.
  3. Elige el idioma del asistente y sigue los pasos de instalación.
  4. Si quieres, activa la creación del acceso directo en el escritorio.
  5. Finaliza el asistente y abre Yagua desde Inicio o el acceso directo creado.

El idioma del asistente no debe confundirse con el idioma de la aplicación: configura este último dentro de Ajustes. El instalador actual propone una carpeta Yagua en Archivos de programa y puede requerir permisos de instalación de Windows.

Si Windows muestra una advertencia, comprueba el origen y la integridad del archivo. No hace falta desactivar globalmente las protecciones del sistema para usar esta guía.

ZIP portable

  1. Descarga Yagua_Portable_<version>.zip, si está disponible para esa publicación.
  2. Extrae todo el ZIP en una carpeta donde tengas permiso de escritura, por ejemplo Documentos\Aplicaciones\Yagua.
  3. Abre la carpeta extraída y ejecuta Yagua.exe.
  4. Conserva juntos el ejecutable y todos los archivos y subdirectorios acompañantes.

No ejecutes el programa desde la vista del ZIP ni muevas solamente Yagua.exe. Las bibliotecas, recursos y fuentes del paquete son necesarios.

Portable no significa que todo quede dentro de esa carpeta. Las preferencias y el registro usan el perfil del usuario de Windows; los modelos de IA también pueden almacenarse fuera del directorio del programa. Mover el ejecutable a otra PC no garantiza que los modelos o preferencias viajen con él.

Primera apertura y actualización

La pantalla inicial ofrece las herramientas disponibles. Puede aparecer un aviso de nueva versión. La instalación de actualizaciones es manual: cierra la aplicación antes de sustituir un portable o ejecutar un nuevo instalador.

Para actualizar un portable, extrae la nueva versión completa en una carpeta separada en lugar de mezclar bibliotecas de dos versiones. Conserva originales y resultados fuera de la carpeta de la aplicación.

Ejecución desde código, opcional

Si elegiste el código fuente en lugar del paquete, necesitas Git y Python 3.13. En PowerShell:

git clone https://github.com/GuilleBouix/Yagua-Image-Processor.git
cd Yagua-Image-Processor
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe main.py

Las dependencias incluyen OCR e IA y pueden ocupar bastante espacio. Esta modalidad no es necesaria para usar el instalador o el portable.

Si no abre

Confirma que extrajiste el paquete completo, que es para Windows y que usas la arquitectura correcta. Revisa el registro de errores; no intentes reparar un paquete precompilado instalando librerías en un Python ajeno al programa.