Scaricare un modello da Hugging Face può sembrare semplice. Quando però entrano in gioco repository di grandi dimensioni, trasferimenti interrotti, modelli privati, revisioni differenti, file duplicati e più ambienti ComfyUI, il processo diventa rapidamente più complesso.
Per rispondere a queste esigenze abbiamo sviluppato BC ModelVault, un downloader grafico per Hugging Face e un gestore locale di modelli di intelligenza artificiale destinato agli utenti Windows.
La versione stabile 1.0.1 permette di scaricare modelli, dataset e Spaces partendo da un URL Hugging Face o dall’identificativo del repository, mantenendo sotto controllo avanzamento, integrità, revisioni e organizzazione dei file. È disponibile come applicazione portabile per Windows e non richiede l’installazione di Python.
Scarica BC ModelVault per Windows ↗ Consulta release e funzionalità.
Perché abbiamo sviluppato BC ModelVault.
Hugging Face mette a disposizione strumenti ufficiali potenti. Il client da riga di comando è efficace per sviluppatori, script, pipeline CI e utenti abituati al terminale. Nella gestione quotidiana di una raccolta locale, però, il solo download non basta.
Occorre sapere quali modelli sono già presenti, dove sono stati salvati, quale revisione è installata, se il trasferimento è integro, quali attività sono state interrotte e dove collocare checkpoint, LoRA, VAE, ControlNet o LLM.
BC ModelVault non sostituisce Hugging Face CLI nelle automazioni: offre un flusso visuale per organizzare e controllare una libreria locale.
Download di modelli, dataset e Spaces.
L’applicazione accetta un URL Hugging Face oppure un identificativo nel formato autore/repository. Prima di avviare il trasferimento controlla il contenuto del repository, lo spazio disponibile e la compatibilità dei nomi con Windows.
Per repository privati o con accesso limitato si possono configurare token Hugging Face con permessi di lettura. I token sono gestiti attraverso huggingface_hub e non vengono inseriti nei file del progetto, nei log o nei report diagnostici esportati.
Una coda che sopravvive ai riavvii
La coda persistente basata su SQLite conserva e ripristina le attività dopo la chiusura dell’applicazione o il riavvio del computer. È possibile mettere in pausa, riprendere, annullare e recuperare i download, oltre a consultare velocità, avanzamento, tempo stimato e storico.
I dati parziali riutilizzabili restano nella cache quando un trasferimento viene annullato, evitando di eliminare contenuti che potrebbero servire alla ripresa.
Concorrenza e controllo della velocità
Si possono utilizzare uno, due, quattro oppure otto worker concorrenti e impostare un limite aggregato alla velocità. In caso di errori temporanei, il sistema può riprovare con un’attesa progressiva e limitata.
Revisioni precise e verifica dell’integrità.
Un repository può cambiare nel tempo. BC ModelVault associa ogni download alla revisione verificata, mostra la differenza tra il commit installato e quello disponibile e non sovrascrive implicitamente una versione già presente.
Quando Hugging Face pubblica un digest affidabile per un file Git LFS, il software verifica l’hash SHA-256 e assegna uno stato esplicito:
- verified, quando il file coincide con l’hash atteso;
- unverified, quando non è disponibile un hash attendibile;
- mismatch, quando il contenuto non coincide con il valore pubblicato.
Un file non verificato non viene indicato automaticamente come corrotto: significa che mancano informazioni sufficienti per una verifica crittografica affidabile.
Una libreria locale per modelli e risorse AI.
Dopo il trasferimento, i contenuti entrano in un catalogo ricercabile che organizza modelli linguistici, checkpoint, LoRA, VAE, ControlNet e altre risorse. Per ogni elemento possono essere mostrati autore, repository, licenza, revisione, data, dimensione, formato, tag, tipologia e stato di integrità.
Classificazione automatica e controllo umano
Il sistema analizza i contenuti e propone una tipologia con un livello di confidenza visibile. Se il rilevamento non è corretto, l’utente può modificare manualmente la classificazione. L’obiettivo non è nascondere l’incertezza, ma offrire un primo livello di organizzazione verificabile.
Rilevamento dei duplicati
BC ModelVault confronta gli hash degli asset e riconosce file identici anche quando nomi, cartelle o repository di provenienza sono differenti. Questo aiuta a ridurre lo spazio occupato e a comprendere quali modelli sono già disponibili.
Installazione guidata nei profili ComfyUI.
Per checkpoint, LoRA, VAE e ControlNet è possibile configurare più profili ComfyUI. Il software prepara un piano che mostra file, categoria, directory, conflitti e metodo di installazione prima di applicare modifiche.
Sono disponibili copia, hard link e link simbolico. Quando il metodo scelto non può essere usato in sicurezza, l’applicazione può ricorrere alla copia. L’operazione non viene eseguita in modo invisibile: il piano resta verificabile dall’utente.
BC ModelVault e Hugging Face CLI.
La CLI rimane la scelta naturale per script, server, pipeline automatiche, ambienti CI e integrazioni software. ModelVault è pensato per utenti desktop che vogliono un’interfaccia grafica e strumenti aggiuntivi per governare una raccolta locale.
Diagnostica progettata per proteggere i dati.
Log ruotati e redatti evitano di registrare i token Hugging Face. Il report diagnostico per l’assistenza esclude le credenziali, riducendo il rischio di condividere accidentalmente informazioni sensibili.
Come scaricare e installare un modello.
- Incollare un URL Hugging Face o un identificativo
autore/repository. - Selezionare la cartella di destinazione.
- Aggiungere un token di lettura quando necessario.
- Usare Check package per controllare file, spazio e compatibilità.
- Selezionare Download package.
- Mettere eventualmente in pausa e riprendere il trasferimento.
I contenuti vengono archiviati nel formato autore--repository, associati al commit verificato e aggiunti alla libreria dopo i controlli disponibili.
Download dell’applicazione
L’eseguibile portabile non richiede Python. Ogni release include SHA256SUMS.txt per verificarne l’integrità. In assenza di firma digitale Windows SmartScreen potrebbe mostrare un avviso: è consigliabile confrontare il checksum con quello pubblicato.
Scarica l’ultima versione ↗ Consulta codice e documentazione.
Per eseguire il progetto dal codice sorgente sono necessari Windows e Python 3.10 o successivo.
python -m pip install -r requirements.txt
python -m bc_modelvault.appLicenza e utilizzo commerciale.
BC ModelVault è distribuito con PolyForm Noncommercial License 1.0.0. Utilizzo, modifica e redistribuzione sono consentiti per finalità non commerciali mantenendo licenza e attribuzioni; l’impiego commerciale richiede un’autorizzazione separata. Prima dell’uso è necessario consultare i file LICENSE e NOTICE del repository.
Un software nato da un problema concreto.
BC ModelVault rappresenta l’approccio di Balzano Consulting allo sviluppo software: non aggiungere tecnologia per rendere artificiosamente complesso un processo, ma costruire uno strumento mirato intorno a un’esigenza reale.
Il problema non era soltanto scaricare un file, ma gestire trasferimenti di grandi dimensioni, recuperarli, verificarli, organizzarli, riconoscere duplicati e installarli correttamente. Lo stesso metodo può essere applicato ai processi aziendali: individuare le operazioni ripetitive, comprenderne le criticità e sviluppare software o automazioni proporzionati.
Hai un processo tecnico o aziendale che richiede troppi passaggi manuali?