targum
Read a text in the language you are learning with a translation beside it, sentence by sentence. Tap any word for its dictionary form and what it means, keep the words you want, export them. Named for the Aramaic word for translation.
Hebrew, Russian, English, Arabic, French, Spanish, German and Latin, right-to-left done properly.
Start
uv is the one prerequisite. Python 3.11 or newer. The install pulls a few hundred megabytes, most of it PyTorch.
uv tool install "targum[difficulty]"
export ANTHROPIC_API_KEY=... # a key comes from console.anthropic.com
targum serve
A page opens. Drop in an EPUB, text or markdown file, or paste a link — an article, a
Wikisource page, gutenberg:1342. Keep the Terminal window open while you read;
Ctrl-C stops it. The address carries a key that changes every start, so open it from
the Terminal rather than a bookmark.
Translating costs money — cents for an article, more for a book. The price is shown
before anything is spent, and finished work is cached. Readers are saved in
targum-out/ and open from there afterwards with no server running.
What it does
Readers are one self-contained HTML file per part: no network, no build step. They work offline, on a phone, and in an e-reader browser.
Three ways to read — parallel, interlinear, source only — on the keys p, i and o.
Tap a word to see how common it is and say how well you know it; that belongs to the
word in that language, not to the text you were reading. Drag across a few words to
keep a phrase. Sign in with an email address and a link and the list follows you to
every browser; without an account it stays in the one you are reading in.
The library carries a catalogue of texts that already have a published translation.
Building one of those costs nothing: the two texts are matched on your machine and no
model is asked to translate anything. Your own published translation aligns the same
way, with uv tool install "targum[difficulty,align]" and:
targum build source.he.md --translation published.en.md
targum rebuild rewrites every reader you already have. targum --help lists the rest.
Hebrew vowel points
Where the source is pointed, that pointing is what you see, no model consulted. Where it is bare, points are guessed on request by Nakdimon — roughly 90% right on modern Hebrew, 55–73% on classical. Guessed sentences are marked.
Those vowels are also what lets a word say how it is said. Install with
uv tool install "targum[phonetics]" and tapping a word shows its reading, stress
marked — בָּצָל is batsˈal and בְּצֵל is btsˈel, the same four letters read two ways,
and which one it is depends on the sentence rather than the dictionary. Read on your
machine by Phonikud, and only ever for a word that has
vowels above it: a word with no reading shows none. Vocal shva is the weak point, so
בְּאֶרֶץ comes out a syllable short.
What leaves your machine
Translating a text, and looking up a word, sends that text to Anthropic.
Signing in sends your email address, the words you have saved — the dictionary form, your own meaning, your notes — and the phrases you have cut, which are the actual words you picked out of what you were reading. They are kept on the server you signed in to. Stay signed out and all of it stays in the browser instead.
Tapping conjugations on a Hebrew verb opens Pealim in a new tab.
Nothing else goes anywhere. Your readers, the cache and the build artifacts stay on
disk, and a translation you supplied is never uploaded. targum serve listens on
127.0.0.1 only and is a single-user tool, not a hosted service — see
SECURITY.md.
Not supported
PDFs, logins, paywalls, and pages that are really web apps.
Licence
AGPL-3.0-or-later. Copyright © 2026 David Langellotti.
Read it, run it, change it. The one condition that bites: if you run a changed version as a service other people use, they are entitled to your changes. Full terms in LICENSE.
Metadata
Release files for targum 0.1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| targum-0.1.0.1.tar.gz | 863.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| targum-0.1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / targum-0.1.0.1.tar.gz
| Download URL | targum-0.1.0.1.tar.gz |
|---|---|
| Size | 863.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d418046f971755baa27e7506ee8a5d11190e7c1664935d94c725cee116bdb0a3
|
|
BLAKE2b-256 checksum How to use checksums |
f1b0c252540dc11d621bc2393f366d9d27edc4e14b07ad7f48ecd40a4949d729
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency logRelease files / targum-0.1.0.1-py3-none-any.whl
| Download URL | targum-0.1.0.1-py3-none-any.whl |
|---|---|
| Size | 506.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a4f8a35410c47a63925a6568cbaeb4bed137fbdbb16f37b13af5a5e7bb61b04
|
|
BLAKE2b-256 checksum How to use checksums |
c2cd27a08f5e6654ed5ad4f0ce906a75fbf3cff0c0aa53e8e428861c7b85a6e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency log