Tools Inkwell - Kindle AI Assistant

[cdhigh]

In the era of AI, I believe every screen deserves to connect with AI. Based on this idea, I developed Inkwell.
This is a script running on kterm that enhances Kindle's AI connectivity while aligning with Kindle's primary goal: reading and learning.



TLDR: With the Go version, just jailbreak your Kindle and install KUAL.
Extract the binary to /mnt/us and it’s ready to use.

The Python version requires Python 3 installed beforehand.

Key Features:
1. Supports displaying formatted Markdown text in the terminal.
2. Enables AI-powered summarization and interactive learning based on Kindle reading highlights and notes (My Clippings).
3. Allows exporting conversation history as well-formatted eBooks or sending it via email.
4. Supports OpenAI, Google, XAI, Anthropic, Mistral, Groq, Perplexity, and Alibaba.
5. Handles multiple API keys and servers with automatic rotation.

Installation:
1. Ensure your Kindle is jailbroken and has KUAL and Python3 (if python version is used) installed.
2. Extract inkwell.zip to the Kindle's root directory (/mnt/us). You don't need to install Kterm; it's already included in this package.
3. since 1.6, a Go lang port is also provided, no longer depends on Python, offering better startup speed and lower memory usage.
3.1. inkwell-go.zip: For firmware versions below 5.16.3
3.2. inkwell-go-hf.zip: For firmware versions 5.16.3 and above

Configuration:
There are two ways to configure Inkwell:
1. Open the config.json file in the Inkwell directory on your computer, edit the fields, and copy it back to your Kindle.
2. Select Inkwell Setup from the KUAL menu and follow the wizard. Simply press Enter for any unclear steps.


Of course, this script not only supports Kindle but can also run on any device as long as Python is installed.

For more details, visit my GitHub repository.

--

[cdhigh]

By the way, you don't need to pay to use AI services—at least for now. APIs from Google, xAI, Mistral, and Groq are free or offer free usage quotas.

The zip package I provided also includes a preconfigured DuckDuckGo demo service, ready to use out of the box, though its availability cannot be guaranteed for long.

[Hav4k]

Thx for the tool!!! No PocketBook support, too? Regards.

[cdhigh]

Originally Posted by Hav4k

Thx for the tool!!! No PocketBook support, too? Regards.

In theory, it is all supported as long as Python and a terminal are installed on your e-reader.
If you're interested, you can try running it. Once it works, you can share the format of the summary notes with me, and I can modify the code to read the book summaries.

Inkwell has no third-party library dependencies; all you need on another device is a single file inkwell.py.

[Hav4k]

Originally Posted by cdhigh

In theory, it is all supported as long as Python and a terminal are installed on your e-reader.
If you're interested, you can try running it. Once it works, you can share the format of the summary notes with me, and I can modify the code to read the book summaries.

Inkwell has no third-party library dependencies; all you need on another device is a single file inkwell.py.

I Will give a try, thanks! But need some assistance...

https://www.mobileread.com/forums/sh...d.php?t=358457

Is here Python for PockeBook Era Color 3?

Thanks for reply.

[cdhigh]

This version meets the requirements, >=3.8 is sufficient.

[cdhigh]

Since I developed Inkwell, my son has often been using ChatGPT on his Kindle over the past few months to get answers to various questions (as I don’t allow him to use a smartphone). While reading, he can also easily look up background information about certain chapters in real time.

Because the Kindle has limited memory and the original Inkwell was developed in Python, it consumed relatively large amounts of memory. To solve this, I ported the script to Go lang (which comes with a built-in cross-compilation toolchain). This significantly improves both startup speed and memory usage.

The latest version has been updated in the first post of this thread.

--------------
By the way, I highly recommend this approach to anyone who wants to develop terminal applications for Kindle. There’s no need to struggle with complex C cross-compilation environments anymore. Just use Go — a single command can produce a binary for the target platform:

GOOS=linux GOARCH=arm GOARM=5 go build app.go

or

set GOOS=linux
set GOARCH=arm
set GOARM=5
go build app.go

[HenriHenry]

Is there a detailed tutorial on how to install this and Python (or Go, whatever this is)
I am completely lost.
I also can't build/compile anything

Can only say this looks amazing!

[cdhigh]

Originally Posted by HenriHenry

Is there a detailed tutorial on how to install this and Python (or Go, whatever this is)
I am completely lost.
I also can't build/compile anything

Can only say this looks amazing!

inkwell-v1.6-go.zip: Python-free, for firmware below 5.16.3, armv5/armv7 armel ABI
inkwell-v1.6-go-hf.zip: Python-free, for firmware 5.16.3 and above, armv7 armhf ABI
inkwell-v1.6-python.zip: Python-dependent, for firmware below 5.16.3, armv5/armv7 armel ABI
inkwell-v1.6-python-hf.zip: Python-dependent, for firmware 5.16.3 and above, armv7 armhf ABI

With the Go version, just jailbreak your Kindle and install KUAL.
Extract the binary to /mnt/us and it’s ready to use.

The Python version requires Python 3 installed beforehand.

Kterm is already included in zip archive.