kbz-21/lang_learn_ethiopia

Learn Ethiopian languages effortlessly with our interactive web-based platform. Engage in fun, gamified lessons designed to build vocabulary, grammar, and speaking skills. Master Amharic, Oromo, Tigrinya, and more at your own pace! # Ethiopian Language Learning Platform ## Overview The **Ethiopian Language Learning Platform** is a web-based application designed to help users learn Ethiopian languages such as Amharic, Oromo, and Tigrinya. It offers interactive lessons, quizzes, and gamified learning experiences to enhance language acquisition. ## Features - User authentication (registration, login, and profile management) - Interactive lessons and exercises - Speech recognition for pronunciation practice - Gamified learning with points, badges, and leaderboards - Multi-language support (Amharic, Oromo, Tigrinya, etc.) - Progress tracking and performance analytics ## Technologies Used - **Back-end**: Django (Python) - **Front-end**: React/Vue (JavaScript) - **Database**: PostgreSQL/MySQL - **Authentication**: JWT, Django Authentication - **APIs**: Text-to-Speech (TTS), Speech Recognition ## Installation ### Prerequisites - Python 3.x - Django - Virtual environment (venv or virtualenv) - PostgreSQL/MySQL database setup ### Setup Steps 1. **Clone the repository** ```sh git clone github.com cd ethiopian-language-learning ``` 2. **Create and activate a virtual environment** ```sh python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate ``` 3. **Install dependencies** ```sh pip install -r requirements.txt ``` 4. **Configure environment variables** (Create a `.env` file and set necessary keys) ```sh SECRET_KEY=your_secret_key DEBUG=True DATABASE_URL=your_database_url ``` 5. **Run database migrations** ```sh python manage.py migrate ``` 6. **Create a superuser** (for admin access) ```sh python manage.py createsuperuser ``` 7. **Start the development server** ```sh python manage.py runserver ``` 8. **Access the application** Open `127.0.0.1` in your browser. ## API Endpoints (if applicable) | Method | Endpoint | Description | |--------|---------|-------------| | GET | /api/lessons/ | Retrieve all lessons | | …