AUTOMATIC1111: installare Stable Diffusion WebUI (2026)

#AUTOMATIC1111, cos'è?

Stability AI ha annunciato il rilascio pubblico di Stable Diffusion il 22 agosto 2022. Il repository di uno sviluppatore noto con lo pseudonimo AUTOMATIC1111 è stato creato su GitHub lo stesso giorno: un'interfaccia per browser, costruita con la libreria Gradio e distribuita sotto licenza AGPL-3.0, che evitava di digitare comandi Python. Il repository conta oggi più di 160.000 stelle. L'interfaccia offre schede per la generazione da testo a immagine, la trasformazione da immagine a immagine, il ritocco tramite maschera e l'ingrandimento, oltre a un'immensa raccolta di estensioni.

Come tutti gli strumenti locali, funziona sulla tua macchina e si apre nel browser all'indirizzo http://127.0.0.1:7860, senza mai uscire dalla tua rete locale per impostazione predefinita. I prompt, le impostazioni e le immagini rimangono sul tuo disco, consultabili e riutilizzabili offline.

• Stable Diffusion: le versioni e quale scegliere

#Ciò che ti serve

Le schede AMD funzionano in modo nativo su Linux con ROCm. Su Windows, il wiki ufficiale è chiaro: « Windows+AMD support has not officially been made for webui », e la soluzione pratica passa attraverso il fork comunitario DirectML di lshqqytiger, nel quale l'addestramento non funzionava ancora secondo la pagina del wiki, aggiornata nel gennaio 2024. Su Mac Apple Silicon, il wiki ufficiale documenta un'installazione tramite Homebrew e lo script webui.sh: la maggior parte delle funzioni è operativa, l'addestramento è molto lento e consuma molta memoria. NVIDIA rimane la soluzione meglio supportata dal progetto.

#Installazione su Windows e Linux

1. 01
   Installare Python 3.10.6

   Da python.org, selezionando « Add Python to PATH ». Il README specifica che le versioni più recenti non supportano torch: rimani sulla 3.10.6, anche se lo stesso README ammette la 3.11 per alcune distribuzioni Linux molto recenti.
2. 02
   Installare Git

   Git for Windows su Windows; il pacchetto git della tua distribuzione su Linux.
3. 03
   Clonare il repository e avviare lo script

   In una cartella con percorso breve, senza spazi né accenti. Su Windows, lo script è webui-user.bat; su Linux, webui.sh.
4. 04
   Attendere al primo avvio

   Lo script scarica PyTorch e le dipendenze, per un totale di diversi gigabyte: calcola da dieci minuti a mezz'ora. Quando appare un indirizzo locale, aprilo nel browser.

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui

# Windows
webui-user.bat

# Linux (après : sudo apt install git python3.10-venv libgl1 libglib2.0-0)
./webui.sh

#Dove posizionare i modelli

models/Stable-diffusion

I checkpoint, ovvero i file principali del modello, nel formato .safetensors.

models/Lora

I LoRA, che aggiungono uno stile o un argomento a un modello di base.

models/VAE

VAE opzionali; molti checkpoint SDXL includono già il loro.

extensions

Le estensioni, gestite dalla scheda omonima.

outputs

Le tue immagini, ordinate per modalità e per data.

Una installazione nuova non contiene necessariamente un modello: le vecchie versioni scaricavano automaticamente SD 1.5 al primo avvio, ora non è più garantito. Scarica un checkpoint SDXL su Hugging Face, posizionalo nella cartella models/Stable-diffusion, poi clicca sull'icona di aggiornamento accanto al selettore del modello. Usa soltanto file con estensione .safetensors: il vecchio formato .ckpt può eseguire codice all'apertura, come dettagliato più avanti.

• Hugging Face: trovare e verificare un file del modello

#Le opzioni di avvio in base alla tua VRAM

Le opzioni vanno inserite nella riga COMMANDLINE_ARGS del file webui-user.bat su Windows, o webui-user.sh su Linux.

set COMMANDLINE_ARGS=--xformers --medvram-sdxl --autolaunch

#I parametri per la prima immagine

Descrivi invece di dare ordini, scrivendo in inglese e indicando prima il soggetto: « portrait of an elderly fisherman, window light, 85mm, shallow depth of field » funziona meglio di un elenco di parole chiave isolate. Il prompt negativo elenca ciò che va evitato, ad esempio « blurry, deformed hands, extra fingers, low quality » per escludere i difetti più frequenti. Una funzione da conoscere fin dall'inizio: la scheda PNG Info legge il prompt e tutte le impostazioni di qualsiasi immagine prodotta dall'interfaccia, permettendo di riprodurre o regolare una generazione riuscita senza dover ridigitare tutto.

#A1111, Forge o ComfyUI nel 2026

Il verdetto è semplice. Scegli A1111 se segui un corso, un tutorial o un'estensione scritti per questo software, oppure se la tua installazione attuale fa ciò che ti serve con SD 1.5 e SDXL. Per una nuova installazione con questo tipo di interfaccia, considera Forge: è un derivato realizzato da lllyasviel, l'autore di ControlNet e Fooocus, che punta a una migliore gestione delle risorse e supporta Flux, e ti permette di mantenere esattamente le tue abitudini. Il repository di Forge lo dice esplicitamente: poiché il progetto originale è «almost static now», Forge si risincronizza con esso «every 90 days, or when important fixes». Ma lo stesso repository di Forge non ha più ricevuto commit sul ramo principale da giugno 2025: il progetto prosegue grazie a un fork della community, Forge Neo di Haoming02, il cui README annuncia il supporto per modelli recenti (Qwen-Image, Wan 2.2, Z-Image) e che veniva ancora aggiornato a fine settembre 2026. Prima di impegnarti in un progetto della community, verificane l'attività. Scegli ComfyUI per i modelli attuali, i video o le pipeline riproducibili.

• ComfyUI: installazione e primi passi
• Fooocus: l'opzione più semplice per iniziare
• Il kit Immagini IA: impostazioni per scheda grafica

#Estensioni utili e sicurezza dei modelli

#ADetailer: correggere automaticamente volti e mani

In un'immagine generata con un'inquadratura ampia, i volti e le mani restano il punto debole di Stable Diffusion. L'estensione ADetailer, che il repository ufficiale presenta come un'estensione che « does automatic masking and inpainting », rileva automaticamente queste zone con un modello di riconoscimento, poi esegue nuovamente un inpainting mirato su di esse, con un proprio prompt. Si installa direttamente dalla scheda Extensions, incollando il suo indirizzo GitHub in « Install from URL ».

L'inpainting, appunto, è una delle quattro modalità di base dell'interfaccia, insieme alla generazione da testo a immagine, alla trasformazione da immagine a immagine e all'ingrandimento: consiste nel rigenerare soltanto una zona dell'immagine selezionata tramite una maschera, mantenendo invariato il resto. ADetailer automatizza questa operazione, evitando che tu debba dipingere manualmente la maschera su ogni volto.

#File .ckpt e .safetensors: cosa cambia con il formato

Un file .ckpt è una serializzazione Python nel formato pickle, un formato che può eseguire codice arbitrario all'apertura. Checkpoint contenenti codice malevolo sono già circolati su piattaforme della comunità. Il formato .safetensors risolve il problema alla radice: secondo il repository ufficiale del formato, «implements a new simple format for storing tensors safely (as opposed to pickle) and that is still fast (zero-copy)». AUTOMATIC1111 integra un controllo che blocca il caricamento di un pickle ritenuto sospetto prima di deserializzarlo, ma la regola più semplice resta scaricare solo file .safetensors, soprattutto da fonti diverse da Hugging Face o Civitai.

• ControlNet: padroneggiare la composizione delle proprie immagini
• Fonte: repository ufficiale di ADetailer
• Fonte: il formato .safetensors spiegato da Hugging Face

#Errori comuni

CUDA out of memory

La dimensione dell'immagine o il modello supera la capacità della VRAM. Aggiungi --medvram o --medvram-sdxl, riduci la risoluzione, chiudi le altre applicazioni che utilizzano la GPU.

Torch is not able to use GPU

Driver troppo vecchio oppure GPU non NVIDIA. Aggiorna il driver; il CUDA Toolkit non è necessario.

L'installazione fallisce nella fase di installazione delle dipendenze

Versione errata di Python. Installa la 3.10.x, poi elimina la cartella venv prima di riavviare.

Una RTX 50 recente non è utilizzata

La version stabile include un PyTorch antecedente all'architettura Blackwell. Un collaboratore del progetto documenta la soluzione in una discussione su GitHub, aggiornata il 1 maggio 2025: passare sulla ramo dev (git switch dev), che utilizza PyTorch 2.7.0 con supporto per le RTX 50, poi avviare una volta con --reinstall-torch nei COMMANDLINE_ARGS e rimuovere l'opzione successivamente. Altrimenti, ComfyUI.

• CUDA : driver, Toolkit, versioni, ciò che davvero bisogna installare
• Il repository ufficiale su GitHub

#FAQ