Corrigir git pull quebrado A1111: reset do venv e rollback

TL;DR

• Delete venv primeiro — a documentação oficial do A1111 lista a deleção do venv como o caminho canônico de reparo; é mais rápido que fixar pacotes manualmente.
• Modelos e configurações sobrevivem — eles ficam em models/, config.json, ui-config.json, styles.csv fora do ambiente virtual (veja onde os modelos ficam).
• Forge exige update.bat — pule e você roda um build desatualizado com bugs não corrigidos (veja Forge vs A1111).

Por que git pull Quebra o Automatic1111

Um git pull atualiza o código Python e as extensões, mas não reconstrói o ambiente virtual. Se o upstream mudou uma versão de dependência — PyTorch, xformers, Gradio, qualquer coisa em requirements_versions.txt — as wheels antigas dentro do venv agora divergem dos novos statements de import. O launcher imprime uma parede de RequirementError ou ImportError e sai.

O wiki de Troubleshooting do A1111 diz claramente: "If you encounter this issue after some component updates, try undoing the most recent actions. … you should delete the venv folder."¹ Esse é o playbook inteiro de rollback do upstream.

O que os Artigos da Civitai Erram

Afirmação da fonte | O que é realmente verdade

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

Adicionar git pull no topo do webui-user.bat para auto-atualização | A documentação oficial nunca menciona isso. O wiki trata webui-user.bat como config do launcher, não script de atualização.² Comando pip é pip Install -U packagename==version | O pip padrão é minúsculo: pip install -U. A forma capitalizada é um typo no artigo da comunidade.³ xformers ainda precisa build manual no Windows | Desde 23 de janeiro de 2023, Windows usa uma wheel oficial do PyPI — sem build do Visual Studio necessário.⁴ "Edite webui.bat para instalar xformers" | A flag pertence ao COMMANDLINE_ARGS (ex.: set COMMANDLINE_ARGS=--xformers --skip-torch-cuda-test).⁵

Reparo Mais Rápido: Delete venv e Relance

1. Feche a janela do console do WebUI.
2. Na raiz do repositório (stable-diffusion-webui/), delete a pasta venv.
3. Clique duas vezes em webui-user.bat (Windows) ou rode ./webui.sh (Linux/macOS).
4. O launcher recria o ambiente virtual e instala as versões exatas fixadas em requirements_versions.txt.

Por que funciona: O A1111 isola cada pacote Python dentro do venv. O repositório só guarda código, extensões e alguns scripts. Seus checkpoints, LoRAs, embeddings e configurações de UI ficam em models/, embeddings/, config.json, ui-config.json, styles.csv — fora do venv. Deletar o venv nunca toca neles.⁶

Confirmação da comunidade: Muitos guias (Civitai 1024, YouTube, Stack Overflow) recomendam deleção do venv como primeiro passo após pull quebrado.⁷

Se o reparo continuar te dando trabalho, partir para outra é resposta válida — veja saindo do A1111 em 2026.

Quando Você Precisa Reinstalar PyTorch Manualmente

Em conexões lentas ou air-gapped, o passo automático de pip do launcher pode dar timeout. O A1111 expõe duas variáveis de ambiente para isso: Variável | Propósito | Valor de exemplo

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

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 | Arquivo de requirements alternativo | requirements.txt (pins mais soltos) Edite webui-user.bat / webui-user.sh e adicione:

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

O índice cu121 hospeda wheels oficiais para torch, torchvision, torchaudio e xformers⁸ — sem mirrors terceiros necessários.

Uma vez rodando de novo, a matriz de versões da stack de aceleração explica qual build do xformers casa com seu PyTorch.

xformers no Windows: Estado Atual (2024+)

Fato | Detalhe

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

Flag | --xformers no COMMANDLINE_ARGS Install | Automático via wheel oficial (desde jan 2023)⁴ Requisito Python | 3.10.x — a wheel é compilada para CPython 3.10; Python mais antigo/mais novo falha⁹ Speedup medido | ~70 % mais throughput no batch 1 em RTX 3060 (6.5 → 7.5 it/s vs default 4.1 → 6.6 it/s)¹⁰ Reinstall forçado | Adicione --reinstall-xformers --xformers ao COMMANDLINE_ARGS, lance uma vez, depois remova a flag de reinstall¹¹

Forge: Workflow de Atualização Diferente, Mesma Lógica de Reparo

O Forge empacota Git, Python e PyTorch fixado num pacote one-click 7z. A diferença crítica: Passo | A1111 | Forge

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

Atualizar código | git pull | update.bat (obrigatório) Lançar | webui-user.bat | run.bat Reparar | Delete venv | Delete venv ou re-extrair pacote

Docs do Forge avisam: "Running update.bat is important, otherwise you may be using a previous version with potential bugs unfixed."¹²

Se update.bat foi pulado, re-extraia o 7z ou delete venv e rode update.bat → run.bat.

Erros comuns e correções

Sintoma | Causa (com fonte) | Correção

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

fatal: not a git repository após download ZIP | ZIP não tem metadados .git¹³ | Rode git init; git remote add origin https://github.com/AUTOMATIC1111/stable-diffusion-webui.git; git fetch origin; git switch master --force Telas pretas/verdes ou NaN após atualização | Mismatch de half-precision/VAE pós mudança de dependência¹⁴ | Adicione --upcast-sampling ou --no-half-vae ao COMMANDLINE_ARGS Torch is not able to use GPU após updates | Skew de versão CUDA/torch/xformers¹⁵ | Desfaça mudanças recentes de componentes, delete venv, relance Tempestade de RequirementError no startup | Env fora de sync com requirements_versions.txt¹⁶ | Delete pastas venv e repositories, relance Mismatch de wheel xformers após mudança de env | Combo GPU/Python incompatível com wheel em cache¹¹ | Lance com --reinstall-xformers --xformers, depois remova a flag de reinstall Forge abre mas bugs persistem | Pulou update.bat após extrair¹² | Rode update.bat antes do primeiro run.bat

Tabela de Decisão: Reparo vs Reinstalação

Cenário | Caminho recomendado | Source

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

git pull → erros de dependência | Delete venv, relance | 1 Download ZIP → comandos git falham | Converta para repo git (comandos acima) | 13 Máquina offline / air-gapped | Defina TORCH_COMMAND + REQS_FILE para caminhos .whl locais | 5 Forge fresh extract | Rode update.bat → run.bat | 12 xformers NameError no Windows | Python ≠ 3.10; instale 3.10.6 + adicione ao PATH | 9 Corrupção de modelo (MetadataIncompleteBuffer) | Baixe novamente checkpoint/safetensors | 17

FAQ

Como faço rollback do Automatic1111 após git pull ruim? Upstream não publica playbook numerado de git reset --hard. A recuperação documentada é: desfaça ações recentes, depois delete venv.¹ Se você sabe o hash do commit bom, git reset --hard <hash> funciona, mas ainda deve deletar venv depois.

Deletar venv apaga meus modelos e configurações? Não. Modelos ficam em models/Stable-diffusion/, LoRAs em models/Lora/, configurações em config.json, ui-config.json, styles.csv — todos na raiz do repo, fora do venv.⁶ Veja também: Pastas de modelos do stable diffusion — o que sobrevive a uma reinstalação?

Por que o guia da Civitai diz para adicionar git pull ao webui-user.bat? Isso é workaround da comunidade, não feature oficial. O wiki nunca menciona.²

Preciso do Visual Studio Build Tools para xformers no Windows em 2024? Não. Desde janeiro de 2023, uma wheel oficial instala via pip automaticamente quando você lança com --xformers.⁴

Qual versão do Python o Automatic1111 exige no Windows? 3.10.6 exatamente. O instalador checa por ela; outras versões fazem wheels do xformers e torch falharem.¹

Forge vs Automatic1111 — qual é mais fácil de reparar? Ambos resetam via deleção de venv. Forge adiciona passo obrigatório de update.bat; A1111 confia em git pull. Nenhuma fonte primária afirma que Forge é mais rápido de reparar.¹²

Onde coloco --xformers no Windows? Edite webui-user.bat, ache set COMMANDLINE_ARGS=, adicione --xformers (separado por espaço). Exemplo: set COMMANDLINE_ARGS=--xformers --skip-torch-cuda-test --autolaunch.⁵

Minhas imagens geradas ficaram pretas/verdes após update — qual flag corrige? Tente --no-half-vae primeiro; se falhar, --upcast-sampling ou --no-half.¹⁴