Icona di Pupino Pupino ← Torna al sito
🐰 manuale del custode

Come funziona Pupino

Una guida a tutto quello che il tuo pupino sa fare oggi: come vive sul desktop, come cresce, come parlarci, dove tiene i suoi (e i tuoi) ricordi.

Questa guida descrive Pupino così com'è oggi. Qualche funzione — come il negozio in-app per le carote — è quasi pronta ma non ancora attiva: dove succede, te lo segnaliamo chiaramente invece di far finta di niente.

Indice
  1. Cos'è Pupino
  2. Il primo incontro
  3. Vivere insieme
  4. Parlare con Pupino
  5. Farlo lavorare sul serio
  6. Il copilota ambientale
  7. DNA, Regni ed Evoluzione
  8. L'amicizia
  9. Vestiti nuovi: le skin
  10. Funzioni pratiche
  11. Impostazioni
  12. Permessi di macOS
  13. Dove vivono i tuoi dati
  14. Diario e Pupino Wrapped
  15. Ricominciare da capo
  16. Per chi vuole andare oltre
Capitolo 1

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.

Capitolo 2

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):

  1. Ciao! — una presentazione veloce: Pupino è già vivo, non devi configurare nulla per vederlo muoversi.
  2. 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.
  3. 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).
  4. 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).
  5. 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.
  6. 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".

Capitolo 3

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:

TastoAzione
Cammina, si arrampica
Salta
Si abbassa / scende da una piattaforma
FMossa speciale della skin attiva
B R N C P ZBevi · rampino · nascondino · carota · pensiero · riposo
SpazioRaccoglie la carota più vicina
EscEsce 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.

Capitolo 4

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):

CervelloCome funziona
Auto (consigliato)Usa il cloud se hai credito, altrimenti il locale se è scaricato, altrimenti Zero. Non si blocca mai.
ZeroSempre 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 privatoUn 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.

Capitolo 5

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.

Capitolo 6

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.

Capitolo 7

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):

🌿Bio
⚙️Cyber
💧Fluido
💎Cristallo
Stellare
🏺Antico
🎭Pop
🕰️Steam
👻Ombra
🧠Accademico

I regni "speciali"

Sette regni in più reagiscono a come usi il computer e a come ti comporti con lui, non ai file:

RegnoCosa lo fa crescere
🔥 FuocoIl Mac sotto sforzo, e i lavori dati al Worker
🧵 PatchworkAvere i dieci regni di base ben bilanciati tra loro
🐉 DragoRegalargli/fargli mangiare carote
🐲 Drago — BraceLe abbuffate, cioè mangiare oltre il solito limite giornaliero
🐈 GattoI momenti di calma e riposo
🧑‍🚀 AstroScoprire tipi di file mai dati da mangiare prima
🍄 FunghiGiocare 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.

Capitolo 8

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)".

Capitolo 9

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:

Goku — mossa speciale Kamehameha
Pikachu
Neko
Spider-Man 🕷️ — cammina sui muri, ragnatele
Boxer
Robot 🤖
Chibi ✨
Spakkone — pausa sigaretta come mossa firma

Si cambiano da Impostazioni → Aspetto, insieme alla scelta dei regni: la selezione è immediata, senza bisogno di riavviare l'app.

Capitolo 10

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.

FunzioneCome si usa
Meteoche tempo fa a Torino — gratis, nessuna chiave richiesta
Calendarioeventi oggi, agenda della settimana, o chiedigli di aggiungere un promemoria
Info sul MacBatteria, RAM, CPU, spazio libero, wifi, IP, età del Mac e altro — chiedi semplicemente
Cosa stai ascoltandocosa ascolto legge Spotify/Music
Password e calcoligenera password 20 caratteri, quanto fa 173*24
Nota rapidanota: comprare il latte la salva in Documenti/Pupino/note-rapide.md
VoceSpenta di default; si accende in Impostazioni → Voce (voce di sistema gratuita, o una voce premium più naturale a consumo)
Terminale in chatSpento 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.

Capitolo 11

Impostazioni

Si apre con , dal menu di stato. È divisa in nove sezioni, una barra laterale come indice:

SezioneCosa trovi
IdentitàNome e personalità, apertura diretta di diario e file di personalità, reset completo
CervelloScelta tra Auto/Cloud/Locale/Zero, codice-carote, download del modello locale
WorkerAttivazione, motore preferito, trascrizione audio, copilota ambientale
CrescitaVelocità di evoluzione, ringiovanimento, scelta dell'ascensione, gadget/accessori
AspettoForzare un regno o una skin
VoceVoce di sistema o voce premium, gestione della cache audio
MemoriaStato dei ricordi indicizzati, visualizzatore, cancellazione
ComportamentoReazioni automatiche, destinazione dei file mangiati, terminale, permessi
AvanzateBackup del cervello, log, "rifai il primo avvio", reset delle statistiche
Capitolo 12

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.

PermessoQuando appareA cosa serve
CalendarioAl primo "eventi oggi" o simileLeggere/creare impegni
Automazione (per app)Al primo "cosa ascolto"Leggere cosa suona su Spotify/Music
Automazione (eventi)Quando attivi il copilota ambientaleSuggerimenti sulla finestra attiva
AccessibilitàDal wizard iniziale, o a mano da ImpostazioniAccorgersi delle finestre e di quando sei inattivo
NotificheAll'avvio dell'appAvvisi di fame o evoluzione
PosizioneMai richiesto
Capitolo 13

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.

In ~/Library/Application Support/DesktopPet/
File / cartellaContenuto
personality.jsonNome, stile e interessi attuali
pupino.mdIl suo diario, si scrive da solo nel tempo
memory.jsonCronologia chat, cibo, momenti importanti
state.jsonStatistiche: fame, felicità, carote, DNA, evoluzioni
llm.jsonQuale 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
In ~/Documents/Pupino/ (visibile, apribile normalmente)
CartellaContenuto
worker/Risultati dei lavori svolti per te
note-rapide.mdLe note veloci dettate in chat
trascrizioni/Gli audio trascritti
Capitolo 14

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.

Capitolo 15

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.

Capitolo 16

Per chi vuole andare oltre

Un paio di funzioni sono spente di default apposta, perché più delicate o di nicchia:

  • Terminale in chatterm: 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 cambia ed evolve nel tempo — così farà anche questa guida. Se qualcosa qui non corrisponde più a quello che vedi nell'app, è probabile che nel frattempo sia migliorato ancora un po'.

↑ Inizio