avar-me

Python library and CLI for Avar language dictionary data — for parsers, translators, tokenizers, corpora, content systems, and ML pipelines.

• PyPI: avar-me
• Docs: python.avar.me
• Repo: github.com/avar-me/python

Install

pip install avar-me

CLI

avar normalize "бет1ер"
# бетӏер

avar translate "рахӏат"
# отдых, покой; спокойствие

avar lookup "аб"
avar info

Python API

import avar

avar.normalize("бет1ер")       # → 'бетӏер'
avar.translate("рахӏат")       # → 'отдых, покой; спокойствие'
avar.lookup("а")               # → list[Entry] (homographs supported)
avar.get_dictionary("av-ru")   # → Dictionary

entry = avar.lookup("аб")[0]
entry.stem                     # 'а'
entry.forms                    # ('аб', 'алъ', 'алъул', 'ал')
avar.lookup("ботӏроца")[0].word  # 'бетӏер' — search by inflected form

Documentation with examples — forms, stress, see_also, gender_forms, JSON/CLI.

Dictionaries

Pair	Status	File
av-ru	available	data/av-ru.dictionary.jsonl
ru-av	planned	—

More pairs (en-av, av-en, tr-av, …) will follow the same {source}-{target} naming.

Development

git clone git@github.com:avar-me/python.git && cd python
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest

See CONTRIBUTING.md, AGENTS.md (for LLM agents), and VERSIONING.md.

License

MIT — see LICENSE. Dictionary data licensing is described in the documentation.