Introduzione a Pi 1.0.0

Pi è un toolkit open‑source estendibile per la creazione di agenti di intelligenza artificiale, progettato soprattutto per gli sviluppatori che desiderano integrare modelli e strumenti nei propri workflow. La versione 1.0.0 segna il primo rilascio stabile, con una serie di cambiamenti focalizzati sulla riduzione del contesto di prompt, sull’estensione delle capacità di generazione di contenuti e su una migliore esperienza d’uso del terminale.

Codemode richiede meno contesto

Nel Codemode Pi consente al modello di generare codice JavaScript che chiama gli strumenti integrati. Con la 1.0.0 le descrizioni degli strumenti e le istruzioni associate sono state accorciate, riducendo il numero di token inviati al modello. Secondo le Release Notes di Pi 1.0.0, una richiesta a GPT‑5.6 con gli strumenti standard e Codemode attivo vede il prompt scendere da circa 5.300 token a 3.300 token. Questa riduzione riguarda esclusivamente la quantità di contesto inviato, non la qualità della risposta.

Inoltre, le messaggi di errore ora forniscono indicazioni più precise su come correggere gli script difettosi, facilitando il debugging da parte del modello.

Generazione di immagini direttamente dal Codemode

Una novità importante è la funzione models.generateImages(), disponibile per gli script Codemode. Questa funzione utilizza le credenziali della sessione corrente e restituisce dati immagine che possono essere allegati al risultato di uno script mediante image(). L’uso di questa funzionalità è conteggiato tra i costi della sessione. Inoltre, è possibile invocare modelli di generazione di immagini tramite ctx.modelRegistry.generateImages(), permettendo una flessibilità ancora maggiore.

Schermo intero e nuove opzioni per il terminale

La interfaccia terminale avvia ora, di default, il modalità a schermo intero. Per gli utenti che preferiscono conservare lo storico di scorrimento tradizionale, è possibile tornare al comportamento precedente usando:

    • tuiMode: "regular" nel file di configurazione, oppure
    • --tui-mode regular come argomento da riga di comando.

Un’altra opzione è quietStartup: "header", che limita l’output iniziale alla sola intestazione contenente versione e tasti di scelta rapida essenziali.

Nuove modalità di login e miglioramenti OAuth

Il comando /login ora propone direttamente Radius, il servizio offerto dagli sviluppatori di Pi, Earendil Works, e consente di configurare immediatamente il server per il Model Context Protocol (MCP). Per gli utenti di Anthropic è disponibile una modalità di login che copia un codice di autorizzazione, utile quando Pi gira su macchine prive di browser.

Con le modifiche a MCP‑OAuth, Pi salva le credenziali separatamente per ciascun nome server e URL. Se un server richiede permessi aggiuntivi, le autorizzazioni già concesse non vengono più perse, evitando richieste di login ripetute. Inoltre, Pi verifica il parametro iss nella risposta di autorizzazione e rifiuta risposte che indicano un server di autorizzazione diverso. È stato introdotto un nuovo valore di configurazione che permette di specificare l’URL del documento dei metadati OAuth, utile quando il server MCP fornisce informazioni errate o assenti.

Correzioni e ottimizzazioni

Tra le correzioni più rilevanti troviamo:

    • Errore con --provider senza --model: ora Pi segnala esplicitamente il problema anziché utilizzare silenziosamente il modello predefinito di un altro fornitore.
    • Dopo il ripristino di una sessione o l’esecuzione di /reload, gli strumenti MCP caricati tramite ricerca rimangono disponibili finché il server si riconnette in tempo.
    • Il consumo di memoria per una lunga risposta dell’assistente è stato ridotto a circa un quinto del valore precedente.

Le versioni precedenti che hanno preparato il terreno

Le release immediate precedenti hanno introdotto le funzionalità di base su cui Pi 1.0.0 si è costruito:

Pi 0.99.0

    • Introduzione del Codemode, ricerca strumenti e supporto MCP come estensioni integrate.
    • Login tramite abbonamento ChatGPT.
    • Theme standard adattato ai colori del terminale.
    • Interfacce per modelli di generazione immagini e classificazione.

Pi 0.99.2

    • Miglior separazione degli strumenti MCP dalla descrizione del Codemode: gli script li cercano solo quando necessario.
    • I server MCP privi di strumenti espliciti non bloccano più la prima richiesta durante la connessione.
    • Nuove opzioni di autenticazione per server MCP.
    • Possibilità di attivare strumenti standard riconfigurati mediante /reload.

Conclusioni

Pi 1.0.0 rappresenta un passo decisivo verso un ambiente di sviluppo più efficiente per gli agenti IA. La riduzione del numero di token inviati al modello, la capacità di generare immagini direttamente dagli script e le opzioni di terminale più flessibili migliorano sia le performance che l’esperienza dell’utente. Le modifiche alla gestione delle credenziali e a OAuth aumentano la sicurezza e la stabilità delle connessioni MCP, mentre le correzioni di bug e le ottimizzazioni di memoria rendono il toolkit più affidabile. Gli sviluppatori che hanno seguito le versioni 0.99.x troveranno in Pi 1.0.0 un prodotto maturo e pronto per essere integrato in workflow complessi, aprendo la strada a nuove possibilità di automazione e collaborazione nell’era dell’intelligenza artificiale.