Arregla A1111 tras git pull roto: reinicio de venv

TL;DR

• Elimina venv primero — los documentos oficiales de A1111 indican la eliminación de venv como vía de reparación canónica; es más rápido que fijar versiones de paquetes a mano.
• Los modelos y ajustes sobreviven — viven en models/, config.json, ui-config.json, styles.csv, fuera del entorno virtual (ver dónde viven los modelos).
• Forge requiere update.bat — si lo omites, ejecutas una compilación desactualizada con errores sin corregir (ver Forge vs A1111).

Por qué git pull rompe Automatic1111

Un git pull actualiza el código Python y las extensiones, pero no reconstruye el entorno virtual. Si la versión de una dependencia cambió en origen — PyTorch, xformers, Gradio, cualquier cosa en requirements_versions.txt — las versiones antiguas dentro de venv ya no coinciden con las nuevas instrucciones import. El lanzador imprime un muro de RequirementError o ImportError y termina.

La wiki de solución de problemas de A1111 lo dice sin rodeos: "Si encuentras este problema tras algunas actualizaciones de componentes, intenta deshacer las acciones más recientes. … debes eliminar la carpeta venv."¹ Ese es todo el procedimiento de reversión que ofrece el origen oficial.

Lo que los artículos de Civitai hacen mal

Afirmación de la fuente | Lo que es cierto en realidad

|-----------------------|--------------------------

Añadir git pull al inicio de webui-user.bat para actualizaciones automáticas | La documentación oficial nunca lo menciona. La wiki trata webui-user.bat como configuración del lanzador, no como script de actualización.² El comando pip es pip Install -U packagename==version | El pip estándar va en minúsculas: pip install -U. La forma con mayúsculas es un error tipográfico del artículo comunitario.³ xformers sigue necesitando compilación manual en Windows | Desde el 23 de enero de 2023, Windows usa una rueda oficial de PyPI — no se requiere compilación con Visual Studio.⁴ "Editar webui.bat para instalar xformers" | El indicador va en COMMANDLINE_ARGS (p. ej. set COMMANDLINE_ARGS=--xformers --skip-torch-cuda-test).⁵

Reparación más rápida: eliminar venv y volver a lanzar

1. Cierra la ventana de la consola de WebUI.
2. En la raíz del repositorio (stable-diffusion-webui/), elimina la carpeta venv.
3. Haz doble clic en webui-user.bat (Windows) o ejecuta ./webui.sh (Linux/macOS).
4. El lanzador recrea el entorno virtual e instala las versiones exactas fijadas en requirements_versions.txt.

Por qué funciona: A1111 aísla todos los paquetes Python dentro de venv. El repositorio solo contiene código, extensiones y unos pocos scripts. Tus checkpoints, LoRA, embeddings y ajustes de interfaz viven en models/, embeddings/, config.json, ui-config.json, styles.csv — fuera de venv. Eliminar venv nunca los toca.⁶

Confirmación de la comunidad: Varias guías (Civitai 1024: https://www.civitai.com/articles/1024, YouTube, Stack Overflow) recomiendan la eliminación de venv como primer paso tras un git pull roto.⁷

Si la reparación sigue dándote problemas, cambiar de opción es una respuesta válida — ver dejar A1111 en 2026.

Cuándo debes reinstalar PyTorch manualmente

En conexiones lentas o sin acceso a internet, el paso automático de pip del lanzador puede agotar el tiempo de espera. A1111 expone dos variables de entorno para esto: Variable | Propósito | Valor de ejemplo

|----------|---------------|------------------

TORCH_COMMAND | Comando pip completo para torch/torchvision/torchaudio | pip install -U torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121 REQS_FILE | Archivo de requisitos alternativo | requirements.txt (versiones menos restrictivas) Edita webui-user.bat / webui-user.sh y añade:

set TORCH_COMMAND=pip install -U torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121

El índice cu121 aloja ruedas oficiales para torch, torchvision, torchaudio y xformers⁸ — no se necesitan espejos de terceros.

Una vez que vuelve a funcionar, la matriz de versiones de la pila de aceleración explica qué compilación de xformers corresponde a tu PyTorch.

xformers en Windows: estado actual (2024+)

Dato | Detalle

|------|--------

Indicador | --xformers en COMMANDLINE_ARGS Instalación | Automática vía rueda oficial (desde enero de 2023)⁴ Versión de Python necesaria | 3.10.x — la rueda está compilada para CPython 3.10; una versión anterior o posterior de Python falla⁹ Aceleración medida | ~70 % más de rendimiento en lote 1 en RTX 3060 (6,5 → 7,5 it/s frente al valor por defecto 4,1 → 6,6 it/s)¹⁰ Forzar reinstalación | Añade --reinstall-xformers --xformers a COMMANDLINE_ARGS, lanza una vez, luego elimina el indicador de reinstalación¹¹

Forge: flujo de actualización distinto, misma lógica de reparación

Forge empaqueta Git, Python y un PyTorch fijo en un paquete 7z de un clic. La diferencia crítica: Paso | A1111 | Forge

|------|-------|-------

Actualizar código | git pull | update.bat (obligatorio) Lanzar | webui-user.bat | run.bat Reparar | Eliminar venv | Eliminar venv o extraer de nuevo el paquete

Los documentos de Forge advierten: "Ejecutar update.bat es importante; de lo contrario, puede que estés usando una versión anterior con posibles errores sin corregir."¹² (https://github.com/lllyasviel/stable-diffusion-webui-forge#installing-forge)

Si se omitió update.bat, vuelve a extraer el 7z o elimina venv y ejecuta update.bat → run.bat.

Errores comunes y soluciones

Síntoma | Causa (documentada) | Solución

|---------|----------------------|---------

fatal: not a git repository tras descargar un ZIP | El ZIP no incluye los metadatos .git¹³ | Ejecuta git init; git remote add origin https://github.com/AUTOMATIC1111/stable-diffusion-webui.git; git fetch origin; git switch master --force Pantallas negras/verdes o NaN tras actualización | Desajuste de media precisión o VAE tras un cambio de dependencias¹⁴ | Añade --upcast-sampling o --no-half-vae a COMMANDLINE_ARGS Torch is not able to use GPU tras actualizaciones | Desajuste de versiones de CUDA/torch/xformers¹⁵ | Deshaz los cambios recientes de componentes, elimina venv, vuelve a lanzar Tormenta de RequirementError al iniciar | Entorno desincronizado con requirements_versions.txt¹⁶ | Elimina las carpetas venv y repositories, vuelve a lanzar La rueda de xformers no coincide tras cambiar el entorno | Combinación de GPU/Python incompatible con la rueda en caché¹¹ | Lanza con --reinstall-xformers --xformers, luego elimina el indicador de reinstalación Forge arranca pero los errores persisten | Se omitió update.bat tras la extracción¹² | Ejecuta update.bat antes del primer run.bat

Tabla de decisiones: reparar frente a reinstalar

Escenario | Vía recomendada | Fuente

|----------|------------------|--------

git pull → errores de dependencias | Eliminar venv, volver a lanzar | 1 Descarga ZIP → fallan los comandos git | Convertir a repositorio git (comandos anteriores) | 13 Máquina sin conexión / aislada | Configurar TORCH_COMMAND + REQS_FILE con rutas locales .whl | 5 Extracción nueva de Forge | Ejecutar update.bat → run.bat | 12 NameError de xformers en Windows | Python ≠ 3.10; instalar 3.10.6 y añadirlo al PATH | 9 Corrupción de modelo (MetadataIncompleteBuffer) | Volver a descargar el checkpoint/safetensors | 17

Preguntas frecuentes (FAQ)

¿Cómo revierto Automatic1111 tras un git pull problemático? El origen no publica un procedimiento numerado de git reset --hard. La recuperación documentada es: deshacer las acciones recientes y luego eliminar venv.¹ Si conoces el hash del commit correcto, git reset --hard <hash> funciona, pero después debes eliminar venv igualmente.

¿Eliminar venv borrará mis modelos y ajustes? No. Los modelos viven en models/Stable-diffusion/, los LoRA en models/Lora/, los ajustes en config.json, ui-config.json, styles.csv — todo en la raíz del repositorio, fuera de venv.⁶ Ver también: Modelos y carpetas de modelos de stable diffusion — ¿qué sobrevive a una reinstalación?

¿Por qué la guía de Civitai dice que añada git pull a webui-user.bat? Es una solución comunitaria, no una función oficial. La wiki nunca la menciona.²

¿Necesito Visual Studio Build Tools para xformers en Windows en 2024? No. Desde enero de 2023, una rueda oficial se instala automáticamente con pip al lanzar con --xformers.⁴

¿Qué versión de Python requiere Automatic1111 en Windows? Exactamente 3.10.6. El instalador la comprueba; otras versiones hacen que fallen las ruedas de xformers y torch.¹

Forge frente a Automatic1111 — ¿cuál es más fácil de reparar? Ambos se restablecen eliminando venv. Forge añade un paso obligatorio de update.bat; A1111 depende de git pull. Ninguna fuente primaria afirma que Forge sea más rápido de reparar.¹²

¿Dónde pongo --xformers en Windows? Edita webui-user.bat, busca set COMMANDLINE_ARGS=, añade --xformers (separado por espacios). Ejemplo: set COMMANDLINE_ARGS=--xformers --skip-torch-cuda-test --autolaunch.⁵

Mis imágenes generadas salen negras/verdes tras una actualización — ¿qué indicador lo arregla? Prueba --no-half-vae primero; si falla, --upcast-sampling o --no-half.¹⁴