0xkal/tech-mezgeb-qalat

Ethiopian tech terminology dictionary (English <-> Amharic, Afaan Oromo, Tigrigna) built from the ELRC ICT Terms Dictionary. Works standalone in plain PHP or as a Laravel package.

v1.0.0 2026-08-04 06:16 UTC

Requires

• php: ^8.0

MIT

• 0xKal

• i18n
• translation
• laravel
• localization
• Ethiopia
• ICT
• Amharic
• oromo
• tigrigna
• afaan oromo
• mezgeb qalat

Published on Packagist.org on 2026-08-04 06:17 UTC

README

Open-source Ethiopian tech terminology dictionary — English translated into Amharic, Afaan Oromo, and Tigrigna — built from the 2,828-term ELRC ICT Terminology Dictionary.

"Mezgebe Qalat" (መዝገበ ቃላት) is Amharic for "dictionary," literally "a registry of words."

Live Web Application & Interactive Localizer Hub:
🌐 https://mezgeb-qalat-monorepo.vercel.app

Source: Translation of ICT Terms into three major Ethiopian Languages: Amharic, Oromo and Tigrigna — ICT Development Office and Ethiopian Languages Research Center (ELRC).

Ecosystem Packages

This repository ships the same dataset as three independent, idiomatic packages, one per ecosystem:

Package	Ecosystem	Live Registry Link	Installation Command
packages/php	PHP 8+ / Laravel	Packagist: 0xkal/tech-mezgeb-qalat	composer require 0xkal/tech-mezgeb-qalat
packages/js	Node / React / Next.js (TypeScript)	npm: tech-mezgeb-qalat	npm install tech-mezgeb-qalat
packages/python	Python 3.8+	PyPI: tech-mezgeb-qalat	pip install tech-mezgeb-qalat

Quick Usage Examples

PHP & Laravel

use MezgebQalat\Dictionary;

$dictionary = new Dictionary();
echo $dictionary->translate('Save', 'amharic'); // አስቀምጥ
echo $dictionary->translate('Save', 'oromo');   // Olkaa'i
echo $dictionary->translate('Save', 'tigrigna'); // ኣቕምጥ

JavaScript & TypeScript

import { dictionary, Dictionary } from 'tech-mezgeb-qalat';

console.log(dictionary.translate('Save', 'amharic'));   // አስቀምጥ
console.log(dictionary.translate('Save', 'oromo'));     // Olkaa'i
console.log(dictionary.translate('Save', 'tigrigna'));  // ኣቕምጥ

React & Next.js Hook

import { useMezgebQalat } from 'tech-mezgeb-qalat/react';

export function SaveButton() {
  const { translate } = useMezgebQalat();
  return <button>{translate('Save', 'amharic')}</button>;
}

Python

from tech_mezgeb_qalat import Dictionary

d = Dictionary()
print(d.translate("Save", "amharic"))   # አስቀምጥ
print(d.translate("Save", "oromo"))     # Olkaa'i
print(d.translate("Save", "tigrigna"))  # ኣቕምጥ

Repo Layout

tech-mezgeb-qalat/
├── data/
│   └── terms.json           # canonical dataset — 2,828 terms
├── scripts/
│   ├── extract_terms.py     # rebuilds data/terms.json from source PDF
│   └── sync_data.sh         # copies data/terms.json into each package
├── packages/
│   ├── php/                 # Composer package
│   ├── js/                  # npm package (Node + React + Next.js)
│   └── python/              # PyPI package
├── web/                     # Production web app (React + Vite)
└── LICENSE

Author & Credits

Created and maintained with ❤️ by kalcoder101 (0xKal).

Special thanks to the ICT Development Office and Ethiopian Languages Research Center (ELRC) for compiling the foundational 240-page ICT Terminology publication.

License

Code in all three packages is MIT Licensed.