Install · PreceptorOS

Back to the front page

Two devices, two paths, and both start the same way: you clone the repository and you start it yourself. No installer asks for a password, and nothing downloads behind your back.

NO_DATA · the "one-click file" does not exist yet. Cause: the repository is public, but it has published no release and dist/aurelius answers 404. Checked on 2026-08-27 against the GitHub API. The repository's own guide describes it as if it were there; until it is published, the path below is the one that works.

On a computer · Linux or macOS

  1. Check that you have Python.

    python3 -V — 3.10 or newer. If it is missing, the installer says so and stops: it does not install it with sudo, because asking for a password halfway through a script is how surprises get in.

  2. Clone the repository.

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

  3. Make the door.

    cd ~/preceptoros && bash bin/instalar-pc — it puts the icon in your applications menu and nothing else. It starts nothing when it finishes: it makes the door; walking through it is your decision. To remove it, bash bin/instalar-pc --desinstalar, which deletes the icon and does not touch your memory.

  4. Create your memory.

    python3 preceptoros.py — it asks you the first-run questions. It starts empty, and it says so.

  5. Open the web face.

    bin/preceptoros-servicio arranca, then go to http://127.0.0.1:8740. That is your machine talking to itself: that 127.0.0.1 goes nowhere else.

On Windows · through WSL

There are no separate steps: inside WSL you have a Linux, so the ones above work as they are. Open wsl and follow the Linux section. We say it here so you do not go looking.

On an Android phone · through Termux

  1. Install Termux from F-Droid.

    Not from Google Play: that version is abandoned and fails. It is the error that loses most people in the first minute.

  2. Get git and the repository.

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

  3. Prepare the phone.

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

  4. Memory, shortcut and web face.

    python3 preceptoros.py
    bin/crear-acceso-directo-android (optional, recommended)
    bin/preceptoros-servicio arranca, then open http://127.0.0.1:8740.

    For the shortcut to appear as an icon you also need Termux:Widget (F-Droid as well). If it is not there, the script says so and explains what to do — it does not create an icon that is never going to show up.

NO_DATA · the APK you install and open without a terminal does not exist yet. Cause: nobody has built it. We say so before you go looking for it.

What it does from minute one, and what it does not do yet

It does: create your memory, ask you the first-run questions, keep what you tell it, and show you the border — the filter that redacts keys, paths and addresses before any text leaves your machine.

It does not converse yet. That needs two large pieces that do not fit inside and are not downloaded without your permission:

The engine · ~10 MB · It is somebody else's executable code. This project signs data, not programs.

The brain · 2.3 GB · It is offered with its licence and its fingerprint in front of you, and you accept it.

Without them, PreceptorOS asks and remembers but does not converse. That is the honest description, and it promises no more than what it actually ships.

Where your side of it lives

In ~/.preceptoros/memory.db. One single file. You can copy it, carry it on a USB stick, or delete it. Nothing leaves your machine unless you export it.

If you installed it under the old name, your memory stays where it is and keeps working: the product adopts the old home instead of moving your data on its own.

Common errors

"PreceptorOS was already open". It was. The browser opened and a second copy was not started, because two at once over the same memory would mean you see one thing and the file says another.

"The server never answered". Something is holding port 8740. bin/preceptoros-servicio para closes whatever is there.

"python3 is missing". The installer stops there on purpose. Install it yourself and come back.

Termux closes or fails strangely. It is almost always the Google Play version. Uninstall it and use the F-Droid one.

Stuck? Ask the AI you already use

You do not have to solve this alone or wait for anyone. For any installation doubt, reach for an external AI: it knows more about terminals and about your operating system than this page does, and it saves you half the road. Copy this, paste your error on top of it, and hand it to Gemini, ChatGPT, Claude or your local AI.

It does not matter which one you use: the text is not tied to any of them. That is the point — do not depend on a single one, not even to ask for help.

Your own plates: let your AI draw them

This site is static and does not generate images: it has no server to make them, and we are not going to fake one. But the AI you already use can — and that way the story is yours. The full text, with the character described and its reference image, lives in the product repository.