El Infierno de la Instalación: PyTorch, CUDA y el Conflicto de las Versiones

Escrito el por griquelme
Facebook Twitter WhatsApp LinkedIn

El Viaje Técnico: Instalando Pytorch-Correlation-extension

Intentar instalar una extensión experimental como Pytorch-Correlation-extension para ComfyUI puede convertirse rápidamente en un viaje técnico extenuante. Empecé en Windows, con Visual Studio Build Tools y CUDA 13.1, pero el proceso de compilación fallaba una y otra vez. Los errores iniciales incluían ModuleNotFoundError: No module named 'torch', lo que reveló que el instalador del repositorio estaba mal diseñado para entornos aislados de build.

Ilustración dividida mostrando la transición entre Visual Studio Build Tools en Windows y una terminal Ubuntu en WSL2.
El viaje desde las pesadas herramientas de compilación de Windows hacia el entorno más ligero de WSL2.

El Caos en Windows

Luego decidí migrar a WSL2 para aprovechar un entorno más limpio. Sin embargo, el problema persistió porque la variable de entorno CUDA_HOME no estaba configurada inicialmente. Aunque ComfyUI y PyTorch funcionaban perfectamente con CUDA en tiempo de ejecución, el sistema de build de Python era completamente ciego al hardware real.

El Conflicto Final: GCC vs CUDA

Después de instalar el toolkit de CUDA 12.0, apareció la incompatibilidad final. El error RuntimeError: The current installed version of x86_64-linux-gnu-g++ (13.3.0) is greater than the maximum required version by CUDA 12.0 confirmó que GCC 13 excede el límite de versión permitido por la versión legacy del toolkit.

Representación visual mostrando una versión moderna del compilador GCC excediendo el límite de versión máximo permitido para un toolkit de CUDA más antiguo.
La incompatibilidad final: el compilador GCC moderno excede el límite de versión permitido por la versión legacy del toolkit de CUDA.
Diagrama técnico detallado mostrando la distinción entre el Runtime de CUDA utilizado por PyTorch y el Toolkit separado requerido para la compilación.
La arquitectura de CUDA: comprendiendo la diferencia entre el Runtime y el Toolkit necesarios para compilar extensiones.

Este proceso ha sido una lección sobre cómo los entornos de build modernos chocan con las restricciones heredadas de las herramientas de IA, y cómo la distinción entre un runtime funcional y un toolkit compilable es crucial para cualquier desarrollador en este ecosistema.