Skip to main content

targum

Turn a text and its translations into a self-contained HTML bilingual reader, built for comprehensible-input language learning. Named for the Aramaic word for translation.

uv tool install "targum[difficulty] @ git+https://github.com/DLangellotti/targum"
export ANTHROPIC_API_KEY=...
targum serve

That opens a local page. Drop in an EPUB, plain text, or markdown file, or paste a link (an article, a Wikisource page, gutenberg:1342), say which language you are learning, and read. The cost of translating is shown before anything is spent, and finished work is cached so nothing is paid for twice.

The same pipeline runs from the command line:

targum build book.epub --to en --words --gloss
targum build source.he.md --translation published.en.md

Readers work offline, on a phone, in an e-reader browser. Tap any word for its dictionary form and meaning, drag across a phrase to keep it, and export what you saved as a CSV. A published translation you already have is aligned to the source sentence by sentence, which beats anything a machine produces. Hebrew, Russian, English, Arabic, French, Spanish, German, and Latin, with right-to-left layout done properly.

targum never bundles or uploads a copyrighted translation. The cache, the readers, and your word lists stay on your machine.

MIT. The roadmap is in NEXT-STEPS.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

targum-0.1.0.tar.gz (277.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

targum-0.1.0-py3-none-any.whl (95.3 kB view details)

Uploaded Python 3

File details

Details for the file targum-0.1.0.tar.gz.

File metadata

  • Download URL: targum-0.1.0.tar.gz
  • Upload date:
  • Size: 277.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for targum-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e00cc67454e72d1e86ceffe12cb790a68b34990b8e352e558a3e99d2f694c2b7
MD5 7a3dd5b6d8e922e64cc51d8681dc5510
BLAKE2b-256 218375dae9c57be8000a14e580f7bd0b6b581b89c494911fa345974713c15cb6

See more details on using hashes here.

Provenance

The following attestation bundles were made for targum-0.1.0.tar.gz:

Publisher: release.yml on DLangellotti/targum

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file targum-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: targum-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 95.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for targum-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 114a0fad624ef294089a54bef06e717f038eed6fe32b02c052a9f5acf8ba0e20
MD5 25c63fd4525a56c87e8d917df95d6a96
BLAKE2b-256 1c2afcadab7660d50c58ccd5222121614b6ed9c21145c526fd07f019640190f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for targum-0.1.0-py3-none-any.whl:

Publisher: release.yml on DLangellotti/targum

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page