Installa · PreceptorOS

Torna alla home

Due apparecchi, due strade, e le due cominciano uguali: cloni il repository e lo avvii tu. Non c'è nessun installatore che chieda una password, e niente si scarica alle tue spalle.

NO_DATA · il «file da un clic» non esiste ancora. Causa: il repository è pubblico, ma non ha pubblicato nessuna release e dist/aurelius risponde 404. Verificato il 2026-08-27 contro l'API di GitHub. La guida del repository lo descrive come se ci fosse; finché non sarà pubblicato, la strada qui sotto è quella che funziona.

Scaricamento diretto

Android · via Termux Linux o macOS · install.sh Windows · install.ps1

Tutti e tre vanno a GitHub Releases. Finché non esce la prima versione danno 404 — è il NO_DATA qui sopra, detto dove si preme.

Su un computer · Linux o macOS

  1. Verifica di avere Python.

    python3 -V — serve la 3.10 o più recente. Se manca, l'installatore lo dice e si ferma: non lo installa con sudo, perché chiedere una password a metà di uno script è il modo in cui si infilano le sorprese.

  2. Clona il repository.

    git clone --depth 1 https://github.com/piskyRpapalo/PreceptorOS ~/preceptoros

  3. Crea la porta.

    cd ~/preceptoros && bash bin/instalar-pc — mette l'icona nel tuo menu delle applicazioni e nient'altro. Non avvia nulla alla fine: crea la porta; entrare lo decidi tu. Per toglierlo, bash bin/instalar-pc --desinstalar, che cancella l'icona e non tocca la tua memoria.

  4. Crea la tua memoria.

    python3 preceptoros.py — ti fa le domande del primo avvio. Comincia vuota, e lo dice.

  5. Apri la faccia web.

    bin/preceptoros-servicio arranca e vai su http://127.0.0.1:8740. È la tua macchina che parla con se stessa: quel 127.0.0.1 non esce da lì.

Su Windows · via WSL

Non ci sono passi propri: dentro WSL hai un Linux, quindi valgono quelli di sopra così come sono. Apri wsl e segui la sezione di Linux. Lo diciamo qui perché tu non lo cerchi.

Su un telefono Android · via Termux

  1. Installa Termux da F-Droid.

    Non da Google Play: quella versione è abbandonata e non funziona. È l'errore che fa perdere più gente nel primo minuto.

  2. Porta git e il repository.

    pkg install -y git
    git clone --depth 1 https://github.com/piskyRpapalo/PreceptorOS ~/preceptoros

  3. Prepara il telefono.

    cd ~/preceptoros && bash bin/instalar-android

  4. Memoria, scorciatoia e faccia web.

    python3 preceptoros.py
    bin/crear-acceso-directo-android (facoltativo, consigliato)
    bin/preceptoros-servicio arranca, e apri http://127.0.0.1:8740.

    Perché la scorciatoia appaia come icona serve Termux:Widget (anche questo da F-Droid). Se non c'è, lo script lo dice e spiega cosa fare — non crea un'icona che poi non comparirà.

NO_DATA · l'APK che si installa e si apre senza terminale non esiste ancora. Causa: nessuno l'ha costruito. Lo diciamo prima che tu lo cerchi.

Cosa fa dal primo minuto, e cosa ancora no

Sì fa: crea la tua memoria, ti fa le domande del primo avvio, conserva quello che gli racconti, e ti mostra la frontiera — il filtro che cancella chiavi, percorsi e indirizzi prima che un testo esca dalla tua macchina.

Non fa ancora: conversare. Per quello mancano due pezzi grandi che non ci stanno dentro e non si scaricano senza il tuo permesso:

Il motore · ~10 MB · È codice eseguibile di altri. Questo progetto firma dati, non programmi.

Il cervello · 2,3 GB · Si offre con la sua licenza e la sua impronta davanti, e lo accetti tu.

Senza quelli, PreceptorOS chiede e ricorda ma non conversa. È la descrizione onesta, e non promette più di quello che ha dentro.

Dove resta quello che è tuo

En ~/.preceptoros/memory.db. Un solo file. Puoi copiarlo, portartelo su una chiavetta o cancellarlo. Niente esce dalla tua macchina se non lo esporti tu.

Se lo avevi già installato con il vecchio nome, la tua memoria resta dov'è e continua a funzionare: il prodotto adotta la casa vecchia invece di spostare i tuoi dati di sua iniziativa.

Errori comuni

«PreceptorOS era già aperto». Lo è. Si è aperto il browser e non se n'è avviato un secondo, perché due alla volta sulla stessa memoria farebbero sì che tu veda una cosa e il file ne dica un'altra.

«Il server non ha risposto». Qualcosa occupa la porta 8740. bin/preceptoros-servicio para chiude quello che c'è.

«manca python3». L'installatore si ferma lì apposta. Installalo tu e torna.

Termux si chiude o si comporta in modo strano. Quasi sempre è la versione di Google Play. Disinstallala e metti quella di F-Droid.

Ti sei bloccato? Chiedi all'IA che già usi

Non devi risolverlo da solo né aspettare nessuno. Davanti a qualsiasi dubbio di installazione, usa un'IA esterna: sa di terminali e del tuo sistema operativo più di questa pagina, e ti risparmia metà strada. Copia questo, incollaci sopra l'errore che ti è uscito, e dallo a Gemini, ChatGPT, Claude o alla tua IA locale.

Non importa quale usi: il testo non è legato a nessuna. L'idea è questa — che tu non dipenda da una sola, nemmeno per chiedere aiuto.

Le cinque tavole: falle disegnare alla tua IA

Questo sito è statico e non genera immagini: non ha un server che le faccia, e non ne fingeremo uno. Ma l'IA che già usi sì che può — e così la tua storia è tua. Il testo completo, con il personaggio descritto e la sua immagine di riferimento, vive nel repository del prodotto.