RevelAI

Runs on your machine · nothing is uploaded

Run RevelAI without opening a terminal.

Choose a folder of album pages, watch each one being separated, and download the photographs as a zip. The page you are reading is a static file with no server behind it. The work is done by a copy of RevelAI running on your own computer, which you start and stop yourself.

Run RevelAI

Looking for RevelAI on this computer…

This page has no server behind it and never receives an image. It drives a copy of RevelAI running on your own machine, so your photographs are read by a program on your computer and go nowhere else. Two commands, once:

Install

pip install revelai

Start it

revelai serve --open

serve listens on 127.0.0.1:8765, which is this computer and nothing else — no other machine on your network can reach it. Leave that terminal open while you work, and stop it with Ctrl+C when you are done. Everything it wrote is deleted when it stops.

Running it on another port? Add ?port= to this page’s address.

What is actually happening

Your photographs never cross a network.

Three programs are involved and two of them are on your computer. It is worth a paragraph, because “a website that runs software on your folder” is exactly the sentence that should make somebody suspicious.

This page

A static file served from GitHub Pages. It has no backend, no database and no upload endpoint. It cannot receive an image; there is nowhere for one to go.

revelai serve

A small server you start yourself, bound to 127.0.0.1. That address is your own machine and is not reachable from your network, let alone the internet. It refuses requests from any page but this one.

The engine

The same Python code the command line runs, doing the same work with the same output. The browser is a remote control for it, not a replacement.

What the page sends where

  • Your images go to http://127.0.0.1:8765, which is a program on your own computer. They are written to a temporary folder that is deleted when you stop the server.
  • Nothing else goes anywhere. No analytics, no error reporting, no fonts from a third party. You can watch this in your browser’s network tab, and you should.
  • The one exception is a hosted backend — and it cannot be turned on from this page. Whether photographs are uploaded is decided by the flag you start the server with, not by anything a web page asks for.
revelai serve
$ revelai serve --openRevelAI 0.1.0 - split album pages, then restore the photographs Listening on http://127.0.0.1:8765Open:        https://maikotrindade.com/revelAI/run/Settings:    backend: local (local only) | faces and colourisation: refused Your photographs are processed here, on this machine, and are notuploaded anywhere. Press Ctrl+C to stop.

Before you start

The folder has to hold images and nothing else.

Checked before a single byte moves, and checked again on the way in. A folder that is not right is refused with the name of every file that is wrong.

What is checked

  • Every file is an image. First by extension, from the listing, before anything is sent. Then by decoding the bytes, because a name is a claim rather than evidence — holiday.jpg that is really a spreadsheet is caught here.
  • No subfolders. Flattening a tree quietly would produce name collisions nobody asked for, so a nested folder is reported instead.
  • No two files with one name, and nothing empty.
  • .DS_Store, Thumbs.db and their relatives are skipped rather than refused. Your desktop put them there; that is not you doing anything wrong.

And what comes back

A zip holding images only, numbered continuously — photo_00000001.png onwards. No logs, no JSON, no thumbnails, no folders. Every file in it is a lossless PNG carrying the source page’s colour profile and a record of what was done to it.

Pages RevelAI is not confident about are listed on the results screen by name and reason. They are still written — a flagged crop is usually the right crop — but you are told, which is the whole point.

Working through a big album? Read how to photograph album pages first. It makes more difference than any setting here.

Or don’t use a browser

Every button here is a flag there.

Nothing on this page can do something the command line cannot. If you are comfortable in a terminal, it is the better tool: it takes paths, writes where you tell it, and has options this page does not expose.

Split only

revelai split ./album-pages -o ./photos

Split, then restore

revelai run ./album-pages --out-split ./photos --out-enhanced ./restored

Restore only

revelai enhance ./photos -o ./restored --compare-dir ./compare

Serve this page’s engine

revelai serve --open

The full flag reference, the detection write-up and the honest limitations are in the engine README. The limitations are worth reading before you restore anything you care about: face restoration reconstructs faces rather than revealing them, and colourisation invents the colour.