A platform to learn African writing systems.
Africa is home to several writing systems. However, most of these systems are primarily used by linguists and are not widely adopted by the general population. Today, many Africans rely on English or French spellings to express native sounds in writing.
While Input Method Engines (IMEs) exist to facilitate typing in these scripts, they assume prior knowledge of the writing system. But how can someone use an IME if they haven't learned the script?
Through this project, we aim to make African writing systems more accessible by helping users learn not only the scripts themselves, but also their alphabets and pronunciations.
Lewa can be installed via Pip or Docker. To start, clone the repo to your local computer and change into the proper directory.
- Python 3.11+ (Download)
- Docker (Optional) (Install Docker)
- UV (Optional, for fast Python package management) (Install UV)
- With Pip:
pip install .- With uv:
uv sync- With Docker: Not needed
- With Python:
python lewa/manage.py migrate- With uv:
uv run lewa/manage.py migrate- With Docker: Not needed
- With Python:
python lewa/manage.py runserver- With uv:
uv run lewa/manage.py runserver- With Docker:
docker compose up -d- With Python:
python lewa/manage.py shell -c "import core.dummy_data"- With uv:
uv run lewa/manage.py shell -c "import core.dummy_data"- With Docker:
docker compose exec lewa ./entrypoint.sh shell -c \"import core.dummy_data\"Access the webapp
Open your browser at: http://127.0.0.1:8000 or http://127.0.0.1:8000/admin for the admin
Contributions, issues and feature requests are welcome! See CONTRIBUTING.md.
Give a ⭐️ if this project helped you!
All the code in this repository is released under the Mozilla Public License v2.0, for more information take a look at the LICENSE file.