Questa pagina affronta il percorso più breve da zero al primo ambiente EvoX funzionante : completa installazione e configurazione di base con il minor numero possibile di comandi, poi verifica con un'importazione e un esempio minimo per assicurarti che EvoX sia davvero richiamabile dai tuoi task. Ricorda una cosa—installarlo non significa farlo funzionare, e solo quando tutti e quattro i passaggi producono output reali puoi considerare completato l'avvio.
Fase 1: prima isola, poi installa
Prima di installare qualsiasi pacchetto, crea un ambiente Python isolato con venv o conda. I pacchetti nell'ambiente globale sono condivisi da tutti i progetti e, se le versioni entrano in conflitto, la diagnosi diventa estremamente onerosa; un ambiente isolato è come un banco di prova dedicato a EvoX: se qualcosa va storto, lo elimini e lo ricrei senza intaccare gli altri progetti.
- Isolamento dell'ambiente come priorità: crea prima l'ambiente con python -m venv .venv, poi attivalo (su Windows corrisponde allo script activate nella cartella Scripts).
- Aggiorna prima il gestore dei pacchetti: dopo l'attivazione esegui pip install -U pip per evitare errori di risoluzione delle dipendenze dovuti a una versione obsoleta di pip.
Fase 2: installa EvoX
L'installazione in genere richiede un solo comando: pip install evox; puoi anche usare conda o l'installazione dal sorgente.Nome del pacchetto, versione e origine di download devono sempre fare riferimento al rilascio ufficiale— i nomi dei pacchetti di origini diverse possono differire per una o due lettere, e un errore di scrittura ti farà installare un altro pacchetto o una versione precedente incompatibile. L'assenza di errori in rosso durante l'installazione indica solo che "è stato installato", non che "funzioni": non fermarti a questo passaggio.
Fase 3: riduci la configurazione di base al minimo
Al primo avvio non serve regolare tutti i parametri: basta verificare quattro punti di partenza: se la versione di Python soddisfa i requisiti ufficiali, se le versioni delle dipendenze sono compatibili tra loro, se questo esperimento usa CPU o GPU e se il seed casuale è fisso. I primi due determinano se il programma può essere eseguito correttamente, gli altri due se i risultati possono essere riprodotti.
Fase 4: concludi con la verifica
Il modo più affidabile per verificare non è controllare se il terminale mostra errori in rosso, ma far girare EvoX davvero: prima import evox e stampa il numero di versione per confermare che il pacchetto sia effettivamente caricato da questo ambiente; poi esegui un esempio minimo o completa un ciclo di iterazione evolutiva per confermare che sia richiamabile normalmente dai task. Solo con output reali da entrambi i controlli la configurazione dell'ambiente è completa.
Fatti aiutare dall'AI, ma mantieni tu il controllo
Puoi comunicare all'AI il sistema operativo, la versione di Python e l'hardware della tua macchina, lasciandole generare i comandi di installazione, configurazione e risoluzione dei problemi: risparmierai molto tempo nella consultazione della documentazione. Attenzione però: i nomi dei pacchetti, le combinazioni di versioni e le operazioni a livello di sistema proposte dall'AI vanno sempre verificate sulla documentazione ufficiale e sulla matrice delle versioni prima di essere eseguite, in particolare i comandi che modificano la configurazione di sistema o disinstallano dipendenze.
Limiti di riproducibilità: annota i comandi di installazione, i file delle dipendenze dell'ambiente e i numeri di versione. La conseguenza più comune dell'uso promiscuo di più ambienti è "funziona sulla mia macchina, ma fallisce su un'altra", e la documentazione è l'unica assicurazione a basso costo.
Esempio di installazione e configurazione di EvoXL'immagine mostra il percorso di avvio più breve sotto forma di comandi da terminale: crea e attiva un ambiente virtuale isolato, aggiorna pip, installa con pip install evox, poi verifica la configurazione minima (versione di Python, compatibilità delle dipendenze, CPU o GPU e seed casuale) e infine concludi importando e stampando il numero di versione e eseguendo un esempio minimo. La conclusione chiave è che installarlo non significa farlo funzionare: l'avvio è completo solo quando tutti e quattro i passaggi producono output reali.
