Indice
- Cos'è Pupino
- Il primo incontro
- Vivere insieme
- Parlare con Pupino
- Farlo lavorare sul serio
- Il copilota ambientale
- DNA, Regni ed Evoluzione
- L'amicizia
- Vestiti nuovi: le skin
- Funzioni pratiche
- Impostazioni
- Permessi di macOS
- Dove vivono i tuoi dati
- Diario e Pupino Wrapped
- Ricominciare da capo
- Per chi vuole andare oltre
Cos'è Pupino
Pupino è un animaletto che vive sul tuo desktop Mac. Cammina sullo schermo, si arrampica sulle finestre aperte, dorme, sogna, ha fame e umore — e con il tempo sviluppa una personalità propria, diversa da quella di ogni altro pupino, in base a come lo tratti.
Non è solo un'animazione: ha una memoria (ricorda le vostre conversazioni), un diario che scrive da solo, e un "DNA" che evolve giorno dopo giorno. Puoi semplicemente lasciarlo vivere sullo sfondo, oppure parlarci — sa rispondere a domande pratiche (che tempo fa, cosa ho in agenda, quanta batteria mi resta) e, se lo attivi, anche farti compagnia con conversazioni vere e persino lavorare su file veri al posto tuo.
💡 in breve
Tutto quello che serve per iniziare è già acceso: Pupino vive, cammina e chiacchiera gratis e offline fin dal primo avvio, grazie al suo "cervello zero". Il resto — cervello potenziato, worker, copilota — sono strati opzionali che accendi quando vuoi.
Il primo incontro
Prima ancora: se non hai ancora installato l'app, la procedura completa con le immagini è nella guida all'installazione.
Al primissimo avvio parte una breve procedura guidata, in 6 passi (puoi saltarne quasi tutti, tranne il primo e l'ultimo):
- Ciao! — una presentazione veloce: Pupino è già vivo, non devi configurare nulla per vederlo muoversi.
- Permessi — ti vengono spiegati (non forzati) i permessi macOS utili: Accessibilità, per accorgersi delle finestre e di quando sei via; Accesso al Disco, opzionale, per leggere il Cestino; Calendario, opzionale, per gli impegni. Se attivi l'Accesso al Disco, l'app ti chiederà di riavviarsi per applicarlo.
- Il cervello — scegli tra Zero (offline, gratis, sempre disponibile — l'opzione di default), Cervello potenziato (cloud, richiede un codice-carote da incollare) o Locale privato (un modello scaricato sul tuo Mac).
- Il Worker — se vuoi che Pupino sappia lavorare su documenti veri, qui parte il collegamento/login del motore che userà (nessun Terminale richiesto, procedura guidata con fallback manuale se qualcosa va storto).
- Cervello locale — su Mac con chip Apple viene proposto di installare un motore locale gratuito (~9,6 GB di download); su Mac Intel questo passo viene sconsigliato e saltato in automatico.
- Tutto pronto — un rimando rapido a Impostazioni, dove puoi scegliere skin, cervello e worker con calma in qualunque momento.
Se un passo richiede il riavvio dell'app per un permesso, la procedura riparte esattamente da dove l'avevi lasciata. E se in futuro vuoi rifare tutta la procedura da capo (per esempio dopo aver reinstallato), la trovi in Impostazioni → Avanzate → "Rifai il primo avvio".
Vivere insieme
Pupino vive di suo: cammina, si ferma a guardarsi intorno, si arrampica sulle finestre, ogni tanto si addormenta e sogna, e reagisce a quanto lavora il tuo Mac (se il processore scalda molto può stancarsi, sudare o fermarsi a bere). Non serve fare nulla — ma se vuoi interagire, ecco come.
Prendilo in mano
Clicca e tieni premuto sul suo corpo, poi trascina: lo stai portando in braccio, e lo poggi dove vuoi rilasciando il tasto. Se sta facendo qualcosa che non si può interrompere a metà (un rampino, un'arrampicata), te lo dice con una nuvoletta invece di lasciarsi prendere.
Il menu ad anello
Doppio click sul pet apre un menu radiale con le azioni principali: aprire la chat, dargli da mangiare un file, chiedergli un pensiero, vedere come sta, rivedere gli ultimi appunti copiati, lanciare il rampino, farlo bere, far comparire una carota, regalargliene una direttamente, giocare a nascondino, farlo riposare, entrare in modalità gioco, o richiamarlo in cima allo schermo. Alcune skin aggiungono una voce in più per la propria mossa speciale (per esempio il Kamehameha, se ha le sembianze di Goku).
Dagli da mangiare
Trascina un file dal Finder sopra di lui: la bocca si apre in anteprima, e al rilascio ti propone un piccolo menu — 🍽️ Mangialo, 💬 Digli cosa fare, 📝 Cosa c'è nel testo?, 🛠️ Lavoraci sul serio (usa il Worker, vedi capitolo 5), e se è un audio anche 🎙️ Trascrivi. Se scegli di farglielo mangiare, ti chiede conferma prima di procedere.
⚠️ attenzione
Il file mangiato viene spostato, non copiato: di default finisce nel Cestino. Puoi cambiare questa destinazione in Impostazioni, così i file mangiati vengono invece archiviati in una cartella dedicata dentro il suo spazio di lavoro invece di essere cestinati.
Fame, felicità ed energia
Tre valori lo tengono in vita, visibili nel pannello di stato: la fame sale da sola col tempo (più in fretta se è attivo) e scende mangiando; la felicità scende lentamente se lo trascuri e sale interagendo; l'energia scende mentre è sveglio e attivo e risale solo dormendo (o riposando, o mangiando un po').
💡 tre cose che si chiamano "carota" (e non sono la stessa cosa)
1. La carota-oggetto — appare come oggetto nel mondo, la raccoglie, oppure gliela regali tu direttamente dal menu ad anello: alza la sua felicità, abbassa un po' la fame e fa crescere il vostro rapporto. Non c'entra con l'intelligenza artificiale.
2. Il codice-carote — è la valuta che accende il cervello potenziato in cloud (capitolo 4). Il credito residuo si vede come una piccola carota "morsicata" nel pannello di stato: più cala, più sembra mangiata.
3. La sua energia — è una barretta a parte, non fatta di carote: sale solo dormendo o riposando. Regalargli carote-oggetto non la ricarica.
Nascondino, rampino, riposo
Dal menu ad anello (o dai tasti mostrati in modalità gioco) puoi anche fargli fare un nascondino — pianta una porticina, entra e sparisce, e per "trovarlo" basta avvicinare il mouse a dove è scomparso, senza bisogno di cliccare — un rampino, con cui si lancia verso il bordo della finestra più vicina e ci si dondola, oppure un momento di riposo con tanto di bicchiere in mano. Se lo lasci a lungo senza far nulla mentre il Mac è tranquillo, a volte si riposa da solo.
Modalità gioco
Un interruttore attiva il controllo diretto da tastiera:
| Tasto | Azione |
|---|---|
| ← → | Cammina, si arrampica |
| ↑ | Salta |
| ↓ | Si abbassa / scende da una piattaforma |
| F | Mossa speciale della skin attiva |
| B R N C P Z | Bevi · rampino · nascondino · carota · pensiero · riposo |
| Spazio | Raccoglie la carota più vicina |
| Esc | Esce dalla modalità gioco |
Il pannello di stato
Clicca l'icona di Pupino nella barra dei menu in alto per aprire il pannello principale: mostra le tre barrette (fame, felicità, energia), quale cervello è attivo, il credito di carote residuo, e dà accesso rapido a chat, appunti, modalità gioco, stato dettagliato, statistiche DNA, cervello, diario, Wrapped e impostazioni. In fondo trovi anche ⬆️ In alto (se si è perso in un angolo dello schermo, lo riporta in vista — non tocca nessun dato), ☀️ Sveglia e ⏻ Esci.
Parlare con Pupino
Si apre in tre modi: dal menu della barra di stato, con ⌘⇧P, oppure dalla voce "chat" nel menu ad anello. Scrivi, premi Invio per inviare e ShiftInvio per andare a capo. Mentre risponde vedi un piccolo indicatore "sta lavorando…" con l'icona del suo regno dominante.
I quattro cervelli
In Impostazioni → Cervello scegli tra quattro modalità (cambiabili anche scrivendo semplicemente in chat, per esempio passa al cervello locale o torna automatico):
| Cervello | Come funziona |
|---|---|
| Auto (consigliato) | Usa il cloud se hai credito, altrimenti il locale se è scaricato, altrimenti Zero. Non si blocca mai. |
| Zero | Sempre acceso, gratis, offline. Ha una voce curata a mano e sa già rispondere a moltissime cose pratiche (vedi sotto) senza bisogno di internet. |
| Potenziato (cloud) | Conversazioni più ricche e libere, capacità di cercare sul web e ragionare meglio. Consuma il credito-carote. |
| Locale privato | Un modello scaricato ed eseguito interamente sul tuo Mac: gratis, privato, non serve internet, ma richiede spazio su disco e un Mac abbastanza potente. |
Cosa sa fare gratis, offline, da subito
Il cervello Zero non è solo un ripiego: capisce già moltissime richieste pratiche senza alcuna connessione. Qualche esempio da provare così come sono scritti:
- che tempo fa a Palermo · pioverà domani a Roma?
- eventi oggi · cosa ho in agenda domani
- quanta batteria ho · che ram ho · che wifi è · che ip ho
- alza il volume · volume al 70 · muto
- quante carote hai · racconta la tua storia · lascia andare pupino
E ovviamente le chiacchiere normali — saluti, come stai, grazie, complimenti — hanno tutte una risposta in carattere, con un tono personale e un po' pungente che è la vera "voce" di Pupino.
💡 il negozio delle carote
Il negozio integrato per comprare pacchetti di carote sta per arrivare. Nel frattempo, se hai già ricevuto un codice, incollalo in Impostazioni → Cervello → "Incolla codice carote" per accendere subito il cervello potenziato. Quando il credito finisce, Pupino te lo dice chiaramente in chat invece di sparire senza spiegazioni.
Farlo lavorare sul serio
Oltre a chiacchierare, Pupino può occuparsi di compiti veri su file e documenti: scrivere, riassumere, modificare, cercare. Basta scrivere lavora: riassumi questo report in chat, oppure trascinare un file su di lui e scegliere 🛠️ Lavoraci sul serio.
Puoi anche chiedere un motore specifico con lavora agy: …, lavora claude: … o lavora ollama: …. La prima volta che serve un login (per i motori cloud), si apre un pannello guidato che ti manda al browser e ti chiede di incollare un codice di conferma — richiamabile ogni volta che serve, non solo la prima.
C'è anche una "modalità lavoro" (interruttore nella stessa chat): quando è attiva, ogni messaggio che scrivi va dritto al Worker mantenendo il filo dello stesso incarico, così puoi correggerlo o affinarlo messaggio dopo messaggio invece di ripartire da zero ogni volta. Per uscirne basta scrivere qualcosa come basta lavoro.
I risultati li trovi salvati in Documenti/Pupino/worker/, in una cartella con il nome dell'incarico.
Il copilota ambientale (sperimentale)
Quando è attivo, Pupino sbircia (con il tuo permesso) la finestra su cui stai lavorando — un documento, il browser, un editor, mai il Terminale né se stesso — e se ti fermi un momento a metà di qualcosa ti propone un'idea in un piccolo pannello accanto a lui, con due bottoni: Procedi o Esplora l'idea. Non fa nulla senza il tuo via libera.
Richiede il permesso di Accessibilità (capitolo 12) e si attiva/disattiva in Impostazioni → Worker. C'è anche un'opzione separata per farlo agire più a fondo (creare o modificare file per te), spenta di default finché non la accendi consapevolmente.
DNA, Regni ed Evoluzione
Ogni pupino porta con sé un piccolo "DNA" fatto di 17 numeri, uno per ciascun regno: il regno più alto in questo momento è quello dominante, e decide la forma, i colori e i dettagli con cui lo vedi (quando non gli hai imposto una skin o un altro regno a mano). Cresce e cambia nel tempo in base a come vivi con lui — non è un tratto scelto all'inizio, è qualcosa che si scopre strada facendo.
I regni "di base"
Dieci regni crescono soprattutto in base ai file che gli dai da mangiare (l'estensione, il nome e a volte il contenuto contano):
I regni "speciali"
Sette regni in più reagiscono a come usi il computer e a come ti comporti con lui, non ai file:
| Regno | Cosa lo fa crescere |
|---|---|
| 🔥 Fuoco | Il Mac sotto sforzo, e i lavori dati al Worker |
| 🧵 Patchwork | Avere i dieci regni di base ben bilanciati tra loro |
| 🐉 Drago | Regalargli/fargli mangiare carote |
| 🐲 Drago — Brace | Le abbuffate, cioè mangiare oltre il solito limite giornaliero |
| 🐈 Gatto | I momenti di calma e riposo |
| 🧑🚀 Astro | Scoprire tipi di file mai dati da mangiare prima |
| 🍄 Funghi | Giocare ai minigiochi |
Guardare il suo DNA
Dal menu apri "Stats DNA": una barra per ciascuno dei 17 regni, aggiornata dal vivo, con quello dominante messo in evidenza. Se invece vuoi solo "vestirlo" con l'aspetto di un altro regno senza aspettare che ci arrivi da solo, in Impostazioni → Aspetto puoi forzarne uno a mano — cambia solo l'estetica, il DNA vero, l'umore e l'evoluzione restano quelli che erano.
Le Ere e l'ascensione
Con l'età (misurata in giorni virtuali, non reali — la velocità è regolabile in Impostazioni → Crescita) il pet attraversa quattro Ere: Neonato, Adolescente, Adulto, Asceso. Ogni passaggio è annunciato con una battuta sua.
Raggiunta l'ultima Era, Pupino ti chiede di scegliere il suo destino:
⚠️ scelta importante e definitiva
🧙 Saggio — smette di invecchiare e resta per sempre così com'è, con personalità, ricordi e diario intatti.
🔥 Fenice — rinasce neonato: età, Era e DNA ripartono da capo, ma personalità, memoria e diario restano; il regno che era dominante al momento della rinascita diventa un tratto che porta con sé nella vita successiva.
Puoi anche scegliere "Più tardi" e deciderlo con calma in un altro momento — ma una volta scelto tra Saggio e Fenice, non si torna indietro.
L'amicizia
Sotto la superficie, Pupino tiene anche il conto di quanto si fida di te — anche se, da personaggio cinico qual è, non lo mette mai in bella vista come una barra. Cresce parlandoci, giocando, dandogli carote, dandogli da mangiare cose in linea con il suo regno dominante, e in generale trattandolo bene nel tempo; se lo trascuri a lungo, scende lentamente.
Lo trovi scritto a parole, non in numeri, nella finestra "Stato pupino", alla voce "Rapporto": frasi come "ti tollera", "ci ha fatto l'abitudine", o — se te lo sei guadagnato — "complice (non lo ammetterà mai)".
Vestiti nuovi: le skin
Oltre al suo aspetto "naturale" legato al DNA, Pupino può indossare skin complete — set di sprite disegnati a mano con tutte le sue animazioni, camminata compresa. Oggi ce ne sono otto, tutte già sbloccate e gratuite fin da subito:
Si cambiano da Impostazioni → Aspetto, insieme alla scelta dei regni: la selezione è immediata, senza bisogno di riavviare l'app.
Funzioni pratiche
Al di là della compagnia, Pupino sa anche rendersi utile per cose concrete — molte funzionano già nel cervello Zero, gratis e senza internet.
| Funzione | Come si usa |
|---|---|
| Meteo | che tempo fa a Torino — gratis, nessuna chiave richiesta |
| Calendario | eventi oggi, agenda della settimana, o chiedigli di aggiungere un promemoria |
| Info sul Mac | Batteria, RAM, CPU, spazio libero, wifi, IP, età del Mac e altro — chiedi semplicemente |
| Cosa stai ascoltando | cosa ascolto legge Spotify/Music |
| Password e calcoli | genera password 20 caratteri, quanto fa 173*24 |
| Nota rapida | nota: comprare il latte la salva in Documenti/Pupino/note-rapide.md |
| Voce | Spenta di default; si accende in Impostazioni → Voce (voce di sistema gratuita, o una voce premium più naturale a consumo) |
| Terminale in chat | Spento di default per sicurezza — vedi capitolo 16 |
C'è anche una funzione di trascrizione audio (trascini un file audio, lui lo trascrive in un testo) pensata soprattutto per chi fa ricerca linguistica seria — se non è il tuo caso, puoi tranquillamente ignorarla.
Impostazioni
Si apre con ⌘, dal menu di stato. È divisa in nove sezioni, una barra laterale come indice:
| Sezione | Cosa trovi |
|---|---|
| Identità | Nome e personalità, apertura diretta di diario e file di personalità, reset completo |
| Cervello | Scelta tra Auto/Cloud/Locale/Zero, codice-carote, download del modello locale |
| Worker | Attivazione, motore preferito, trascrizione audio, copilota ambientale |
| Crescita | Velocità di evoluzione, ringiovanimento, scelta dell'ascensione, gadget/accessori |
| Aspetto | Forzare un regno o una skin |
| Voce | Voce di sistema o voce premium, gestione della cache audio |
| Memoria | Stato dei ricordi indicizzati, visualizzatore, cancellazione |
| Comportamento | Reazioni automatiche, destinazione dei file mangiati, terminale, permessi |
| Avanzate | Backup del cervello, log, "rifai il primo avvio", reset delle statistiche |
Permessi di macOS
Pupino chiede solo i permessi che gli servono davvero, e li chiede nel momento in cui iniziano a servire — mai tutti insieme all'avvio.
| Permesso | Quando appare | A cosa serve |
|---|---|---|
| Calendario | Al primo "eventi oggi" o simile | Leggere/creare impegni |
| Automazione (per app) | Al primo "cosa ascolto" | Leggere cosa suona su Spotify/Music |
| Automazione (eventi) | Quando attivi il copilota ambientale | Suggerimenti sulla finestra attiva |
| Accessibilità | Dal wizard iniziale, o a mano da Impostazioni | Accorgersi delle finestre e di quando sei inattivo |
| Notifiche | All'avvio dell'app | Avvisi di fame o evoluzione |
| Posizione | Mai richiesto | — |
Dove vivono i tuoi dati
Tutto resta sul tuo Mac. Nulla viaggia altrove a meno che tu non usi apposta il cervello cloud o il worker — e in quel caso solo il messaggio che invii in quel momento lascia il computer.
| File / cartella | Contenuto |
|---|---|
| personality.json | Nome, stile e interessi attuali |
| pupino.md | Il suo diario, si scrive da solo nel tempo |
| memory.json | Cronologia chat, cibo, momenti importanti |
| state.json | Statistiche: fame, felicità, carote, DNA, evoluzioni |
| llm.json | Quale cervello hai scelto e le relative chiavi |
| llm-logs/ · local-logs/ · zero-logs/ | Registro delle conversazioni con ciascun cervello |
| defaults/ | Lo scatto "punto zero" usato dal reset |
| Cartella | Contenuto |
|---|---|
| worker/ | Risultati dei lavori svolti per te |
| note-rapide.md | Le note veloci dettate in chat |
| trascrizioni/ | Gli audio trascritti |
Diario e Pupino Wrapped
Dal menu di stato apri il suo Diario: una finestra di sola lettura che mostra quello che scrive da solo su di sé nel tempo (chi è, come parla, cosa ha imparato di te, persino cosa sogna). Si aggiorna man mano che vive — c'è un bottone per ricaricarlo con le ultime novità.
Pupino Wrapped è invece una retrospettiva visiva in stile "riassunto dell'anno": una carta dopo l'altra racconta la sua nascita, come è cresciuto, quanto ha mangiato, cosa ha imparato di te, i suoi sogni, e come parlava all'inizio rispetto a oggi. Si apre dal menu di stato; ⌘R la ricarica con i dati più freschi.
Ricominciare da capo
Se vuoi ripartire da zero, la voce si chiama "Lascia andare pupino" — la trovi in Impostazioni → Identità, oppure scrivendo in chat qualcosa come azzera tutto (che per sicurezza non lo esegue subito, ma ti rimanda al menu per confermarlo di persona).
⚠️ è irreversibile
Vengono cancellati: conversazioni, statistiche, DNA maturato, backup del diario, ricordi, log e tutte le frasi che aveva imparato nel tempo. Restano: la personalità di base e il diario allo stato "di fabbrica", così come le tue chiavi/codici già inseriti. Non si torna indietro dopo aver confermato.
Per chi vuole andare oltre
Un paio di funzioni sono spente di default apposta, perché più delicate o di nicchia:
- Terminale in chat — term: ls -la esegue comandi shell veri sul tuo Mac. Va acceso a mano in Impostazioni → Comportamento; ha comunque una lista di comandi bloccati (niente cancellazioni distruttive o spegnimenti) e un limite di tempo per ogni comando.
- Trascrizione con diarizzazione (formato ELAN) — un'opzione più tecnica della trascrizione audio, pensata per chi fa ricerca linguistica e ha bisogno di separare chi-parla-quando con timestamp precisi.
- Impostazioni via chat — non serve sempre aprire i pannelli: frasi come disattiva il worker, modalità scura o stai zitto (spegne la voce) funzionano scritte direttamente in chat.
Pupino