Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rihoneailabs/african-language-catalog-demo
A demo Flask app to showcase and provide information about the diverse languages spoken across the African continent.
https://github.com/rihoneailabs/african-language-catalog-demo
africa african-languages flask-application linguistics python sqlite
Last synced: 2 days ago
JSON representation
A demo Flask app to showcase and provide information about the diverse languages spoken across the African continent.
- Host: GitHub
- URL: https://github.com/rihoneailabs/african-language-catalog-demo
- Owner: rihoneailabs
- Created: 2024-10-20T08:22:25.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-20T13:47:20.000Z (2 months ago)
- Last Synced: 2024-12-19T05:44:33.819Z (4 days ago)
- Topics: africa, african-languages, flask-application, linguistics, python, sqlite
- Language: HTML
- Homepage: https://huggingface.co/spaces/ndamulelonemakh/afri-lang-catalog-demo-02
- Size: 78.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# African Languages Catalog
## Description
The African Languages Catalog is a web application designed to showcase and provide information about the diverse languages spoken across the African continent. This project aims to celebrate linguistic diversity, promote language preservation, and serve as an educational resource for anyone interested in African languages.
## Features
- Browse languages by region
- Detailed information pages for individual languages
- Search functionality (planned)
- User-friendly interface built with Flask and styled with Tailwind CSS
## Technologies Used
- Python 3.11+
- Flask
- SQLAlchemy
- SQLite (can be configured for other databases)
- Tailwind CSS
- HTML5
## Installation
1. Clone the repository:
```bash
git clone https://github.com/ndamulelonemakh/afri-lingo-idx.git
cd afri-lingo-idx.
```
2. Set up a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```
3. Install the required packages:
```bash
pip install -r requirements.txt
```
4. Initialize the database:
```bash
python seed.py
```
5. Run the application:
```bash
export SECRET_KEY=
FLASK_APP=application flask --app application:app run --host 0.0.0.0 --reload
```
6. Open a web browser and navigate to `http://localhost:5000`
## Project Structure
```
african-languages-catalog/
│
├── app.py
├── models.py
├── seed.py
├── requirements.txt
├── README.md
│
├── templates/
│ ├── index.html
│ ├── about.html
│ ├── category.html
│ └── language.html
│
└── static/
└── css/
└── styles.css
```
## Contributing
If you'd like to contribute, please follow these steps:
1. Fork the repository
2. Create a new branch (`git checkout -b feature/AmazingFeature`)
3. Make your changes
4. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
5. Push to the branch (`git push origin feature/AmazingFeature`)
6. Open a Pull Request
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
## Contact
- Email: [Rihone AI Labs](mailto:[email protected])
## Acknowledgements
- [Flask Documentation](https://flask.palletsprojects.com/)
- [SQLAlchemy Documentation](https://docs.sqlalchemy.org/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Wikipedia - African Languages](https://en.wikipedia.org/wiki/Languages_of_Africa)