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.9.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.9.0.tar.gz | 1.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| echo_words-1.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.0 MB
Release files / echo_words-1.9.0.tar.gz
| Download URL | echo_words-1.9.0.tar.gz |
|---|---|
| Size | 1.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d29dc0c1b54c1bb79bdebc4d8987c9befd2bc9d0529a198a12266cf484fe284e
|
|
BLAKE2b-256 checksum How to use checksums |
62f96302e591e9932f83b0ffc06a540cb21966325a0204cd5f241fcbf6418cd3
|
| 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.9.0-py3-none-any.whl
| Download URL | echo_words-1.9.0-py3-none-any.whl |
|---|---|
| Size | 89.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4f23a43b680fad567e4e24d352e1001bd54f6014b48039cf42b99a9f82b7d74b
|
|
BLAKE2b-256 checksum How to use checksums |
3014f5663407b1305e0efc0d43bcaf97dceccd5b1914b11c0c7a0fd03bb1a61a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
