echo-words
A private AI vocabulary tutor for every word you meet. Send a word, phrase, or whole sentence, and echo-words explains what a dictionary will not: distinct senses and registers, real usage, origins, and examples worth remembering. It also creates the Anki material for you — four cards that test one selected sense in both directions, with natural pronunciation — in the deck you already review. echo-words explains; Anki makes you remember.
A word, a phrase, a sentence |
Analysis, audio, card in Anki |
A sentence, translated and explained |
What one word gets you:
- an explanation, not just a translation — distinct senses and registers, collocations, prepositions, common confusions, origins, and translated examples; a phrase is taught as a whole while its words remain available as chips
- one selected sense, reviewed four ways — word and context test recognition and production; every other sense stays one tap away from its own note
- a real voice, not a robot — natural-sounding audio in the app and on the cards
- a whole sentence becomes a lesson — echo-words translates it, explains the hard parts, and turns every useful word or expression into a one-tap lesson
- a deeper entry on demand — one tap asks the strongest model for rare senses, deeper etymology, near-synonyms, and the mistakes learners make
- private and free by default — tailnet-only, no application database, and a pool of free LLM providers; the optional paid model is capped
Documentation
Development
uv sync
npm --prefix webapp ci
inv dev # http://127.0.0.1:8080
inv test # Python + frontend suites
inv pre # ruff, ruff-format, pyrefly, file hygiene
inv test silently skips the frontend suite when webapp/node_modules is
missing, so npm ci is part of the setup, not an optional extra. Never call
Ruff directly — inv pre is the only gate that matches CI.
Deployment is invoke over ssh, and the frontend is built on the VM by the
deploy itself:
inv setup-app --with-host-prep # one-time, idempotent
inv deploy --ref=main
inv status
inv logs
See Development and Deploy to Oracle Cloud in the docs.
Reports
Created with cookiecutter using template
1 maintainer
Release files for echo-words 1.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| echo_words-1.8.0.tar.gz | 1.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| echo_words-1.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.9 MB
Release files / echo_words-1.8.0.tar.gz
| Download URL | echo_words-1.8.0.tar.gz |
|---|---|
| Size | 1.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
49b91ba0556a4d0a89c650e01fa63d21f4e2dee91206afb96124f9240bd282bb
|
|
BLAKE2b-256 checksum How to use checksums |
56986b95bc2a3fd5ed35a8980f6dd7deeab3af627713ff8271a40b53be1c5ee3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / echo_words-1.8.0-py3-none-any.whl
| Download URL | echo_words-1.8.0-py3-none-any.whl |
|---|---|
| Size | 85.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
56f383f45f817eaa05379ed26c55e517b876bfa6e6e82742db6c691d8e10d5b4
|
|
BLAKE2b-256 checksum How to use checksums |
df0d13f5b4313f3c0868f19d3876ae5469c67acae42a96624fcda8eb57c713df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
