Instalar · PreceptorOS

Volver a la portada

Dos aparatos, dos caminos, y los dos empiezan igual: clonas el repositorio y lo arrancas tú. No hay instalador que pida contraseña, y nada se descarga a tu espalda.

NO_DATA · el «fichero de un clic» todavía no existe. Causa: el repositorio es público, pero no ha publicado ninguna release y dist/aurelius responde 404. Comprobado el 2026-08-27 contra la API de GitHub. La guía del repositorio lo describe como si estuviera; hasta que se publique, el camino de abajo es el que funciona.

En un ordenador · Linux o macOS

  1. Comprueba que tienes Python.

    python3 -V — hace falta 3.10 o más nuevo. Si falta, el instalador lo dice y para: no lo instala con sudo, porque pedir una contraseña a mitad de un guion es como se cuelan las sorpresas.

  2. Clona el repositorio.

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

  3. Crea la puerta.

    cd ~/aurelius && bash bin/instalar-pc — pone el icono en tu menú de aplicaciones y nada más. No arranca nada al terminar: crea la puerta; entrar lo decides tú. Para quitarlo, bash bin/instalar-pc --desinstalar, que borra el icono y no toca tu memoria.

  4. Crea tu memoria.

    python3 preceptoros.py — te hace las preguntas del primer arranque. Empieza vacía, y lo dice.

  5. Abre la cara web.

    bin/preceptoros-servicio arranca y ve a http://127.0.0.1:8740. Es tu máquina hablando consigo misma: ese 127.0.0.1 no sale de ahí.

En un teléfono Android · por Termux

  1. Instala Termux desde F-Droid.

    No desde Google Play: esa versión está abandonada y falla. Es el error que más gente pierde en el primer minuto.

  2. Trae git y el repositorio.

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

  3. Prepara el teléfono.

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

  4. Memoria, atajo y cara web.

    python3 preceptoros.py
    bin/crear-acceso-directo-android (opcional, recomendado)
    bin/preceptoros-servicio arranca, y abre http://127.0.0.1:8740.

    Para que el atajo salga como icono hace falta Termux:Widget (también de F-Droid). Si no está, el guion lo dice y explica qué hacer — no crea un icono que no va a aparecer.

NO_DATA · el APK que se instala y se abre sin terminal no existe todavía. Causa: nadie lo ha construido. Lo decimos antes de que lo busques.

Qué hace desde el minuto uno, y qué todavía no

Sí hace: crea tu memoria, te hace las preguntas del primer arranque, guarda lo que le cuentas, y te enseña la frontera — el filtro que tacha claves, rutas y direcciones antes de que un texto salga de tu máquina.

No hace todavía: conversar. Para eso faltan dos piezas grandes que no caben dentro y no se descargan sin tu permiso:

El motor · ~10 MB · Es código ejecutable de otros. Este proyecto firma datos, no programas.

El cerebro · 2,3 GB · Se ofrece con su licencia y su huella delante, y lo aceptas tú.

Sin ellas, PreceptorOS pregunta y recuerda pero no conversa. Es la descripción honesta, y no promete más de lo que trae dentro.

Dónde queda lo tuyo

En ~/.aurelius/memory.db. Un solo fichero. Puedes copiarlo, llevártelo en un USB o borrarlo. Nada sale de tu máquina si tú no lo exportas.

Errores comunes

«PreceptorOS ya estaba abierto». Lo está. Se abrió el navegador y no se arrancó un segundo, porque dos a la vez sobre la misma memoria haría que vieras una cosa y el fichero dijera otra.

«El servidor no llegó a responder». Algo ocupa el puerto 8740. bin/preceptoros-servicio para cierra lo que haya.

«falta python3». El instalador para ahí a propósito. Instálalo tú y vuelve.

Termux se cierra o falla raro. Casi siempre es la versión de Google Play. Desinstálala y pon la de F-Droid.

¿Te has atascado? Pregúntale a la IA que ya usas

No hace falta que resuelvas esto solo ni que esperes a nadie. Ante cualquier duda de instalación, tira de una IA externa: sabe de terminales y de tu sistema operativo más que esta página, y te ahorra la mitad del camino. Copia esto, pégale encima el error que te salió, y dáselo a Gemini, ChatGPT, Claude o tu IA local.

Da igual cuál uses: el texto no está atado a ninguna. Esa es la idea — que no dependas de una sola, tampoco para pedir ayuda.

Las cinco láminas: que las dibuje tu propia IA

Este sitio es estático y no genera imágenes: no tiene servidor que las haga, y no vamos a fingir uno. Pero la IA que ya usas sí puede — y así tu historia es tuya. El texto completo, con el personaje descrito y su imagen de referencia, está en la historia.