Pinokio: installer per app AI in locale su Windows

👁 113 letture

Pinokio è un programma gratuito distribuito sotto licenza MIT che permette di scaricare e avviare applicazioni AI da GitHub con un solo clic, configurando in autonomia Python, Git, Conda e librerie in ambienti isolati. Se vuoi esplorare l’ecosistema dell’AI locale per modelli di testo, immagini e video, questo strumento automatizza processi che richiederebbero lunghi passaggi da riga di comando. Il 17 ottobre 2026 ho installato Pinokio AI su Windows 11 e ho configurato Florence-2: funziona, ma solo dopo una correzione manuale e dopo aver occupato circa 13 GB su disco.

Cos’è Pinokio e come gestisce l’ambiente locale

Pinokio (disponibile sul dominio ufficiale pinokio.co) opera come un browser di script per l’automazione. Quando selezioni un’applicazione nella sezione Explore e premi Install, il sistema scarica il relativo script, clona il repository da GitHub o Hugging Face, prepara un ambiente virtuale isolato, compila o scarica i binari PyTorch adatti alla scheda video e fornisce un’interfaccia di avvio. Il servizio gira in locale e si apre direttamente nella finestra dell’applicazione o nel normale browser web.

Il software non include un proprio modello AI, ma replica ciò che faresti leggendo le istruzioni manuali di un repository. Tutto viene salvato all’interno di una cartella principale scelta dall’utente (nel mio caso configurata come D:\pinokio):

• bin: contiene gli strumenti di base condivisi, tra cui Miniforge (conda), Git, Node.js, uv e FFmpeg.
• api: ospita le cartelle delle applicazioni, ciascuna con il proprio ambiente virtuale env e i modelli scaricati.
• cache: archivia i pacchetti Python scaricati per velocizzare successive configurazioni.

Il server interno opera sulla porta 42000. Se abiliti l’esecuzione in background, puoi accedere al pannello di controllo da un comune browser digitando http://localhost:42000.

La sicurezza di Pinokio: cosa verificare prima di installare

Il livello di sicurezza di Pinokio dipende interamente dallo script che decidi di lanciare. Lo sviluppatore lo segnala chiaramente: gli script hanno la facoltà di eseguire istruzioni di sistema arbitrarie, oltre a scaricare ed eseguire file esterni. Prima di procedere con l’installazione di qualsiasi software, l’interfaccia mostra un avviso indicando il percorso del repository originale.

Durante le mie verifiche sul sistema ho rilevato diversi elementi strutturali:

• Verifica dell’eseguibile: il file Pinokio.exe ottenuto dai rilasci ufficiali di GitHub dispone di una firma valida e l’impronta hash SHA-256 corrisponde a quella dichiarata.
• Significato dell’etichetta Verified: diciture come “Verified GitHub organization” (ad esempio pinokiofactory) o “Verified GitHub account” attestano l’identità dell’account che gestisce lo script, non una revisione del codice ad ogni commit.
• Download di dipendenze aggiornate: durante l’installazione di Florence-2, lo script scarica l’ultima versione disponibile del repository ed esegue l’installazione di pacchetti da fork remoti.
• Funzione Protection: il software include un’opzione per bloccare pacchetti npm, uv e bun rilasciati da meno di 72 ore, ma questa protezione non agisce sulle installazioni gestite tramite pip o conda.
• Isolamento parziale: i file risiedono nella cartella dell’app, ma il processo viene eseguito con i privilegi del tuo utente Windows e ha pieno accesso al file system.
• Regole di rete: la porta 42000 rimane in ascolto su tutte le interfacce di rete (0.0.0.0). Nel firewall di Windows vengono create regole automatiche per reti private e pubbliche; consiglio di disattivare l’accesso su reti pubbliche.
• Richieste elevate: alcuni strumenti (come il pacchetto AI) provano a impostare percorsi lunghi nel registro e scaricano Visual Studio Build Tools 2019 da un repository dell’autore (con binario originale Microsoft Corporation). Ho evitato script che richiedevano questa procedura.

Come usare Pinokio e installare i software su Windows

Per preparare l’ambiente senza errori sul sistema operativo Windows, puoi seguire questi passaggi ordinati:

1. Download del programma: ottieni Pinokio.exe dalla sezione releases di GitHub o dal sito ufficiale desktop.pinokio.co. Puoi verificare l’integrità aprendo PowerShell ed eseguendo il comando Get-FileHash .\Pinokio.exe.
2. Installazione di base: l’installer non richiede privilegi amministrativi. Nel mio test ho utilizzato l’installazione silenziosa definendo un percorso dedicato tramite comando: Pinokio.exe /S /D=D:\AI\pinokio-app (completata in 14 secondi per 0,5 GB).
3. Scelta della cartella dati: di default il percorso suggerito è C:\pinokio. Scegli un’unità capiente su file system NTFS (il programma segnala possibili problemi con exFAT), priva di spazi nel percorso, quindi salva e riavvia.
4. Installazione dei tool primari: al primo avvio di un’applicazione ti verrà chiesto di scaricare 11 strumenti di sistema indispensabili (conda, git, node, uv, ffmpeg e altri).
5. Selezione da Explore: cerca l’applicazione desiderata, premi Install, seleziona la cartella di download e conferma al secondo avviso di sicurezza.
6. Avvio finale: premi il pulsante Start; durante la prima esecuzione l’ambiente completerà lo scaricamento dei pesi del modello.

Il mio test: Florence-2 tramite Pinokio su RTX 4090

Inizialmente ho tentato l’installazione di Whisper-WebUI, ma la procedura richiedeva il pacchetto “AI” e l’esecuzione con privilegi di amministratore per gestire Visual Studio Build Tools 2019 (con disinstallazione e ripristino dei componenti). Ho scelto di non concedere tali permessi sulla mia macchina di lavoro. Ho quindi virato su Florence-2 dall’organizzazione pinokiofactory, basato sul modello open source di Microsoft rilasciato con licenza MIT.

La configurazione hardware del test comprende una scheda Nvidia RTX 4090 da 24 GB, processore Intel Core i9-14900KF, 64 GB di RAM e Windows 11. I dati raccolti durante la sessione del 17 ottobre 2026 mostrano tempi e requisiti di archiviazione ben definiti:

Gran parte dei 16 minuti impiegati per lo script è stata assorbita dal download di PyTorch 2.7.0 con CUDA 12.8 (un singolo archivio da 3,11 GiB). Terminata l’installazione, il primo avvio ha scaricato quattro varianti del modello (large, large-ft, base, base-ft), bloccandosi poi con l’eccezione TypeError: unhashable type: 'dict'. Lo script bloccava Gradio alla versione 4.44.1 lasciando libera l’installazione di FastAPI, che ha inserito FastAPI 0.143.3 con Starlette 1.7.0. Ho ripristinato il funzionamento retrocedendo la libreria tramite riga di comando:

cd /d D:\pinokio\api\florence2.git\app
D:\pinokio\bin\miniforge\Library\bin\uv.exe pip install --python env\Scripts\python.exe fastapi==0.115.6

Dopo il comando correttivo (che ha reimpostato Starlette alla versione 0.41.3), il sistema si è avviato regolarmente in 61,6 secondi, completando l’analisi di un’immagine di prova in lingua inglese. L’allocazione di memoria rilevata dal monitor di sistema di Windows ha evidenziato consumi rilevanti:

Poiché lo script carica contemporaneamente tutti e quattro i modelli a piena precisione, l’esecuzione in parallelo con un flusso video su ComfyUI ha saturato i 24 GB di memoria della RTX 4090, portando il processo al blocco. È fondamentale arrestare le istanze non utilizzate dall’interfaccia di Pinokio prima di avviare altri carichi di lavoro intensivi.

Quali applicazioni installare tramite Pinokio

Nel catalogo interno sono presenti numerosi software noti della scena open source. Prima dell’uso occorre distinguere tra la licenza del codice dell’interfaccia e i termini di utilizzo dei singoli pesi neurali:

• ComfyUI: ambiente nodale per elaborazione immagini e video, licenza GPL-3.0, utilizzabile a scopo commerciale.
• Forge: interfaccia ottimizzata per Stable Diffusion, licenza AGPL-3.0, uso commerciale ammesso.
• Wan2GP: implementazione per generare clip con modelli Wan su GPU a risorse contenute; la licenza WanGP Community License 2.0 consente la vendita degli output generati ma vieta la rivendita del software. Se ti interessano questi flussi di lavoro, puoi consultare anche i test sui video di influencer AI in locale.
• InvokeAI: suite completa per la generazione grafica, licenza Apache-2.0, uso commerciale libero. Se crei avatar digitali, abbiamo analizzato la resa visiva nell’articolo sui modelli per influencer AI in locale.
• Whisper-WebUI: trascrizione audio basata su modelli Whisper (MIT) e codice Apache-2.0; richiede però i componenti di build Visual Studio.
• Applio: software per conversione vocale con licenza MIT (i modelli addestrati mantengono licenze separate).
• Kokoro-TTS: generatore vocale compatto sotto licenza Apache-2.0, senza supporto alla lingua polacca nel benchmark di riferimento ma ottimo per compiti rapidi in inglese.
• F5-TTS: sistema di clonazione vocale con codice MIT ma pesi rilasciati con licenza restrittiva CC-BY-NC (solo per uso personale o di ricerca).
• ai-toolkit: toolkit per l’addestramento e il fine-tuning di LoRA, licenza MIT.
• Open WebUI: interfaccia per modelli linguistici con licenza personalizzata che impone il mantenimento del marchio originale sopra i 50 utenti. Per approfondire l’integrazione, vedi la guida a Open WebUI con Ollama.
• Florence-2: pipeline Microsoft per la comprensione delle immagini, modello con licenza permissiva MIT.

Per interagire unicamente con modelli linguistici di testo, installare Pinokio non è indispensabile: soluzioni come Ollama o LM Studio forniscono pacchetti dedicati più leggeri e immediati da gestire.

Pinokio, installazione manuale e ComfyUI a confronto

Ogni modalità di distribuzione locale presenta specifici compromessi operativi legati alle competenze richieste e allo spazio su disco:

Risoluzione dei problemi frequenti

• Errori di rete o download fallito: avvisi come “Could not resolve host: github.com” indicano spesso problemi temporanei di risoluzione DNS; riavviare il download risolve il blocco.
• Spazio esaurito sull’unità primaria: sposta subito la cartella home nelle impostazioni (campo home) su un hard disk secondario. La funzione Disk Saver aiuta inoltre a collegare file duplicati tra cartelle diverse.
• Percorsi con caratteri speciali o partizioni exFAT: configura sempre una cartella breve su partizione NTFS, priva di spazi e caratteri accentati (es. D:\pinokio).
• Richieste continue di permessi amministratore: dipendono dal pacchetto AI per Visual Studio Build Tools 2019. Se l’installazione va in loop, gli sviluppatori consigliano di rimuovere i Build Tools tramite il Visual Studio Installer ufficiale prima di ritentare.
• Segnalazioni dell’antivirus: l’applicazione scarica eseguibili esterni come Miniforge. Se il firewall o l’antivirus intervengono, verifica l’origine dell’URL nello script prima di concedere deroghe.
• Blocco all’avvio dell’applicazione: se la console mostra errori su dizionari non validi o incompatibilità, utilizza la funzione Update o Reset. In presenza di versioni incompatibili di pacchetti pip, forza l’installazione della versione precedente dall’ambiente virtuale dedicato.

Come disinstallare completamente Pinokio da Windows

Se decidi di rimuovere la piattaforma, la procedura richiede la cancellazione manuale di alcuni residui per liberare spazio:

1. Arresta tutte le istanze attive premendo il pulsante Stop all’interno di ogni scheda, quindi chiudi l’eseguibile.
2. Disinstalla “Pinokio 8.2.0” dalle impostazioni di Windows (sezione App installate) oppure esegui il file Uninstall Pinokio.exe situato nella cartella del programma.
3. Elimina manualmente la cartella dati principale (ad esempio D:\pinokio), poiché il disinstallatore automatico non tocca i modelli e gli ambienti virtuali scaricati.
4. Cancella i file di configurazione rimasti nei percorsi utente: %USERPROFILE%\.pinokio e %APPDATA%\Pinokio, rimuovendo anche le regole residue dal firewall di Windows.
5. Se hai installato in precedenza Visual Studio Build Tools 2019, procedi alla rimozione tramite il relativo pannello di gestione Microsoft.

Domande frequenti

Fonti e data di verifica

• Repository GitHub di Pinokio: documentazione, script policy e licenza MIT
• Release Pinokio 8.2.0 su GitHub con verifiche SHA-256
• Codice sorgente pinokiod: gestione script AI e Build Tools
• Elenco e specifiche delle applicazioni su pinokio.co
• Script d’installazione di Florence-2 su pinokiofactory
• Scheda tecnica del modello Microsoft Florence-2 su Hugging Face
• Repository Wan2GP e termini WanGP Community License 2.0
• Specifiche e termini di licenza del modello F5-TTS
• Test sul campo su Windows 11 con Nvidia RTX 4090 effettuato il 17 ottobre 2026.

Verificato il 17 ottobre 2026.

// continua a leggereQwen3.6-27B in locale su RTX 4090: quale versioneGuideVideo di influencer AI in locale: 15 clip con Kandinsky 6 e Wan 2.2GuideACE-Step 1.5: generatore musica AI locale con voce su RTX 4090Guide

Kinetyra