gitwtfhub

wtf is riddle?

maximerivest/riddle — explained in plain English

Analysis updated 2026-05-18

1,705RustAudience · developerComplexity · 4/5Setup · hard

TL;DR

Turns a reMarkable Paper Pro tablet into a magic AI diary you write to and read from with real ink and handwriting.

Mindmap

mindmap
  root((repo))
    What it does
      Handwritten AI conversation
      Ink fades and replies animate
      Remembers past pages
    Tech stack
      Rust
      reMarkable Paper Pro
      Vision LLM API
      Quill display engine
    Use cases
      Chat with an AI in ink
      Recall old handwritten pages
      Build custom e-ink apps
    Audience
      reMarkable tablet owners
      Hardware tinkerers
    Setup
      Developer mode required
      remagic installer
      OpenAI-compatible API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Write questions by hand on a reMarkable tablet and get handwritten AI replies.

REASON 2

Ask the diary to recall and rewrite a page you wrote on a previous day.

REASON 3

Connect the diary to your own OpenAI, OpenRouter, or Groq API key.

REASON 4

Use the companion Quill engine to build other fast e-ink drawing apps.

What's in the stack?

RustreMarkable Paper ProOpenAI APIQuill

How it stacks up

maximerivest/riddlenubskr/walrusyynxxxxx/codex-x
Stars1,7051,8871,515
LanguageRustRustRust
Setup difficultyhardmoderateeasy
Complexity4/55/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires developer mode, a launcher, an AI API key, and only works on the reMarkable Paper Pro model.

No license information is stated in the README excerpt.

Wtf does this do

Riddle turns a reMarkable Paper Pro tablet into something like the diary of Tom Riddle from the Harry Potter books. You write on the screen with the tablet's pen, and after you pause for a couple of seconds, your handwritten words fade away as if the page absorbed the ink, then an answer writes itself back onto the page in flowing handwriting, one stroke at a time, before fading away too. There is no keyboard, no chat window, and no visible app interface, only ink appearing and disappearing on the page. The project is written in Rust and runs directly on the tablet. It captures raw pen input, including pressure detail, turns a finished page into an image, sends that image to an AI model that can read images, and converts the model's text reply into realistic handwritten strokes that animate onto the page. A companion project called Quill provides a low level way to draw directly on the tablet's e-ink screen for the fastest possible response. Beyond simple back and forth writing, the diary keeps a memory of every page you have written, including your original strokes and a transcription, so you can ask it in ink to recall something you wrote before, and it will rewrite that old page in your own handwriting, dated, in faded ink. You can also flip the pen's marker end to erase, draw a large question mark to bring up a built in guide, or tap the screen with five fingers to leave the diary and return to the normal tablet interface. To answer you, the diary connects to a vision capable AI model, either through any service that speaks the OpenAI style chat API, such as OpenAI, OpenRouter, or Groq, using your own API key, or through a separate tool called pi if you already run that. Setting it up requires putting the reMarkable Paper Pro into developer mode, installing a launcher, and either installing riddle through a companion tool called remagic or copying a prebuilt release onto the tablet by hand. The project is explicit that this modifies your device and is not affiliated with reMarkable, and that it has only been tested on that one specific tablet model.

Yoink these prompts

Prompt 1
Walk me through putting my reMarkable Paper Pro into developer mode using remagic.
Prompt 2
Explain how riddle turns my pen strokes into an image sent to an AI model.
Prompt 3
Help me configure oracle.env to use OpenRouter with a vision-capable model.
Prompt 4
Describe what the takeover mode display backend does differently from qtfb.

Frequently asked questions

wtf is riddle?

Turns a reMarkable Paper Pro tablet into a magic AI diary you write to and read from with real ink and handwriting.

What language is riddle written in?

Mainly Rust. The stack also includes Rust, reMarkable Paper Pro, OpenAI API.

What license does riddle use?

No license information is stated in the README excerpt.

How hard is riddle to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is riddle for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.