Advertencia en InvokeAI: ¿Es un error o solo una advertencia?

Estás instalando InvokeAI y de repente, te aparece un mensaje en la consola que suena a error. Alguien te muestra el warning: ‘Failed to hardlink files; falling back to full copy.’ Es natural pensar que algo salió mal con tu entorno virtual o con los archivos del sistema. ¿Tu software está roto? ¿Tu instalación es inestable?

Ilustración dividida mostrando que una advertencia de consola no es grave.
Visualización del concepto de advertencia inofensiva durante la instalación.

La realidad, sin embargo, es totalmente diferente. Ese mensaje no es un error crítico; es simplemente una advertencia técnica del instalador llamado uv. El sistema intenta optimizar la instalación usando enlaces duros (hardlinks) para ahorrar espacio y tiempo, pero si los directorios de caché y el entorno final están en sistemas de archivos distintos—algo muy común en Windows cuando usas unidades separadas como C: y D:—el proceso falla automáticamente.

En lugar de detenerse o romper la instalación, uv simplemente cambia a un método de copia estándar. El resultado final es exactamente el mismo: tu entorno está correctamente configurado y listo para usar. No afecta ni la ejecución del programa, ni la estabilidad de los modelos, ni el rendimiento durante la inferencia.

Si prefieres no tener que ver este mensaje en tus registros, tienes tres opciones válidas. La más sencilla es simplemente ignorarlo; la instalación funciona perfectamente sin ella. Si quieres ser prolijo y eliminarlo por completo, puedes ejecutar un comando en PowerShell antes de instalar para forzar el modo de copia explícita con setx UV_LINK_MODE copy.

Esquema de tres opciones para resolver una advertencia técnica.
Diagrama técnico mostrando las soluciones para el warning.

Aunque también podrías intentar mantener todo en el mismo disco NTFS para evitar la advertencia desde el origen, es honestamente innecesario. No vale la pena el esfuerzo técnico.

En resumen: es normal, no es un error, y puedes ignorarlo con total tranquilidad mientras sigues disfrutando de tu entorno de IA.