1. Come accade solitamente
Tutto parte da un modello open source: scaricato da un repository, provato in locale, magari fine-tunato “solo per test”. Poi il progetto cresce. Si aggiungono dataset interni, prompt, regole di post-processing, filtri, ranking, valutazioni. Il modello migliora e improvvisamente diventa parte del prodotto.
A quel punto nasce una zona grigia: il modello base è pubblico, ma la versione che gira in azienda non lo è più davvero. È stata addestrata, adattata, filtrata, ottimizzata. È come comprare una bici standard e trasformarla pezzo per pezzo in una bici da gara: alla fine il telaio è lo stesso, ma il risultato è tutt’altra cosa.
Nei progetti AI questa trasformazione è spesso poco tracciata. Si lavora su notebook, script, branch di repository, ambienti cloud. Si prova un dataset, poi un altro. Si cambia learning rate, si aggiungono prompt, si modificano pipeline. Dopo qualche settimana, nessuno ricorda esattamente quale combinazione ha prodotto “la versione che funziona davvero”.
Un aneddoto tipico: un team fa fine-tuning di un modello open source con dati interni. Il risultato è ottimo. Dopo qualche mese, un cliente segnala comportamenti strani. Il team cerca di ricostruire come era stato addestrato il modello originale… e scopre che metà dei file sono stati sovrascritti e i notebook hanno celle eseguite in ordine casuale. A quel punto il problema non è tecnico, è archeologico.
C’è anche un aspetto meno evidente: il valore non è solo nel modello finale (i pesi), ma nel processo. Dataset, filtri, prompt, metriche, errori corretti, versioni scartate. In molti casi, è proprio questa combinazione che rende il sistema competitivo. Proteggerla significa documentare non solo “cosa è uscito”, ma anche “come ci sei arrivato”.
Infine, l’open source introduce un altro livello: licenze, condizioni d’uso, obblighi di attribuzione. Sapere quale modello base hai usato, in quale versione, e come lo hai modificato è parte della protezione, perché chiarisce cosa deriva da terzi e cosa è frutto del tuo lavoro interno.
2. Cosa devi dimostrare
Il punto non è dimostrare che il modello open source è tuo, ma documentare in modo credibile la tua versione addestrata e il percorso che l’ha generata.
Può essere utile dimostrare:
- l’esistenza di una specifica versione del modello addestrato;
- i file dei pesi (checkpoint) nella versione usata o rilasciata;
- il modello open source di partenza e la sua versione;
- i dataset utilizzati per l’addestramento o fine-tuning;
- le configurazioni di training (parametri, epoche, batch, ecc.);
- i prompt, filtri o pipeline aggiuntive;
- i risultati di benchmark e valutazione;
- la documentazione tecnica associata al modello;
- le comunicazioni interne o esterne su quella versione;
- la sequenza tra versioni sperimentali e versione “stabile”;
- eventuali limitazioni o comportamenti noti dichiarati.
In pratica, devi poter dire: “questa è la versione del modello che abbiamo costruito sopra una base open source, con queste modifiche e questi dati, in questo momento”.
3. Cosa raccogliere
Raccogli sia il modello sia tutto ciò che serve a capirlo e ricostruirlo.
Raccogli:
- file dei pesi del modello (checkpoint);
- configurazioni di training e file di setup;
- nome e versione del modello open source di partenza;
- script di fine-tuning o training;
- notebook utilizzati (anche se disordinati, meglio salvarli);
- dataset o riferimenti ai dataset usati;
- prompt, regole e pipeline di inferenza;
- log di training e output delle esecuzioni;
- metriche, benchmark e report di valutazione;
- documentazione tecnica (README, note di rilascio);
- screenshot di dashboard o strumenti di training;
- video brevi che mostrano il comportamento del modello;
- e-mail e chat con decisioni tecniche rilevanti;
- contratti o accordi se il modello è condiviso con terzi;
- file di licenza del modello open source di base;
- changelog delle modifiche effettuate.
Un dettaglio utile: conserva anche versioni intermedie significative. Non tutto, ma almeno i passaggi chiave. Spesso è proprio lì che si capisce cosa ha fatto la differenza.
4. Come procedere
Tratta il modello come un prodotto versionato, non come un esperimento continuo. Ogni versione rilevante deve avere una sua identità chiara.
Crea una cartella per la versione del modello, con un nome esplicito, ad esempio Modello_AI_Custom_v1.3_2026-05-01. Inserisci i pesi, le configurazioni e la documentazione minima necessaria per capire cosa contiene.
Scrivi un README che spiega:
- modello base utilizzato;
- tipo di addestramento effettuato;
- dataset principali;
- configurazioni chiave;
- metriche ottenute;
- limiti noti.
Procedura pratica:
- identifica la versione del modello da proteggere;
- raccogli pesi, configurazioni e script;
- documenta modello base e modifiche;
- aggiungi dataset o riferimenti documentati;
- crea un README chiaro;
- organizza tutto in una struttura ordinata;
- crea un archivio ZIP della versione;
- attesta il pacchetto principale;
- conserva una copia interna immutata;
- collega la versione del modello a eventuali rilasci o clienti.
Se il modello viene aggiornato, crea una nuova versione. Evita di sovrascrivere file esistenti. In ambito AI, cambiare un parametro può cambiare completamente il comportamento del sistema.
5. Errori da evitare
Molti problemi nascono da una gestione troppo “artigianale” del modello.
Errori frequenti:
- salvare solo il modello finale senza contesto;
- dimenticare quale modello open source è stato usato;
- non conservare configurazioni e parametri di training;
- perdere traccia dei dataset utilizzati;
- sovrascrivere checkpoint importanti;
- non documentare prompt o pipeline aggiuntive;
- usare nomi poco chiari come model_final2.pt;
- ignorare le licenze del modello base;
- non separare esperimenti e versioni ufficiali;
- non conservare log e metriche.
Oltre all’attestazione tecnica, servono buone pratiche: versionamento dei modelli, gestione dei repository, controllo accessi, documentazione minima standard e revisione delle dipendenze open source. L’attestazione gratuita è utile perché consente di fissare rapidamente una versione importante senza rallentare il lavoro del team.
6. Dopo la documentazione
Dopo aver documentato il modello, integra questa pratica nel ciclo di sviluppo. Ogni versione rilevante dovrebbe avere il suo pacchetto e la sua documentazione.
Condividi le informazioni con team tecnico, prodotto e management, così tutti sanno quale versione è in uso. Se il modello viene distribuito a clienti o partner, prepara versioni dedicate e documentate.
In caso di problemi o contestazioni, avere versioni ben archiviate permette di ricostruire rapidamente cosa è stato fatto e quando. E nel mondo AI, dove tutto evolve velocemente, avere memoria tecnica ordinata è uno dei vantaggi più concreti che puoi costruire.