Gondi Wordnet

A comprehensive digital lexical database and web platform for the Gondi language. This project aims to preserve, promote, and provide a research-oriented resource for Gondi, a South-Central Dravidian language.

✨ Creator

This repository and the accompanying web application were conceptualized, designed, and developed by Rutwik Muley.

• GitHub: Rutwik-M https://github.com/Rutwik-M
• LinkedIn: Rutwik Muley https://www.linkedin.com/in/rutwik-muley-b20707208
• Portfolio: Rutwik Muley rutwik-m.is-a.dev

---

📖 Academic Publication

This project and its underlying methodology are detailed in our peer-reviewed paper published in the IEEE Xplore digital library.

Title: Design and Development of MahaDict for Low-Level Maharashtra State Language (Gondi WordNet)
Conference: 2024 International Conference on Artificial Intelligence and Quantum Computation-Based Sensor Application (ICAIQSA)
DOI: 10.1109/ICAIQSA64000.2024.10882401
View on IEEE Xplore

To cite this work, please use the following BibTeX entry:

@INPROCEEDINGS{10882401,
  author={Muley, Rutwik and Karande, Sahil and Meshram, Saharsh and Madne, Omkar and Motghare, Manish and Nirkhi, Smita},
  booktitle={2024 International Conference on Artificial Intelligence and Quantum Computation-Based Sensor Application (ICAIQSA)}, 
  title={Design and Development of MahaDict for Low-Level Maharashtra State Language (Gondi WordNet)}, 
  year={2024},
  volume={},
  number={},
  pages={1-9},
  keywords={Translation;Accuracy;Quantum computing;Databases;Semantics;Buildings;Machine learning;Knowledge graphs;Text to speech;Reliability;Gondi Wordnet;Gondi-English;Lexicon Database;WordNet;Synset},
  doi={10.1109/ICAIQSA64000.2024.10882401}
}

---

Live Application: gondi-wordnet.onrender.com

---

📖 About The Project

A WordNet is a large lexical database where words are grouped into sets of synonyms called synsets, each expressing a distinct concept. This project applies that powerful lexicographical structure to the Gondi language.

The Gondi Wordnet serves two main purposes:

1. Language Preservation: To create a lasting, accessible digital archive of the Gondi lexicon.
2. Community & Research: To provide a collaborative tool for linguists, community members, and language learners to explore, contribute to, and analyze the Gondi language.

---

🚀 Features

The platform includes a robust set of features for both public users and registered contributors:

• Comprehensive Search: An intuitive interface to search for Gondi words and view their meanings, parts of speech, and relations.
• Multi-Level User System: Supports different user roles, including administrators and reviewers/contributors with distinct permissions.
• Contribution Workflow: Registered users can add new words and propose edits to existing ones.
• Review & Approval System: A dedicated interface for administrators or reviewers to approve or reject new submissions and edits, ensuring data quality and accuracy.
• Transliteration: Built-in logic to handle different scripts or transliteration schemes.
• Wordnet Visualization: A graphical representation of the lexical relationships between words.

---

🛠️ Tech Stack

• Backend: Python with the Flask web framework.
• Frontend: HTML, CSS, JavaScript.
• Database: PostgreSQL (or similar) for storing user data, words, and review entries.
• Deployment: Hosted on Render.

---

📂 Directory Structure

The repository is organized as follows:

└── rutwik-m-gondi-wordnet/
    ├── app.py                  # Main Flask application file (routes, logic)
    ├── config.example.py       # Example configuration file for environment variables
    ├── gondi_proper.json       # Gondi Alphabets JSON for Transliteration Model
    ├── Procfile                # Defines commands for the web server (for deployment)
    ├── requirements.txt        # Python dependencies for pip
    ├── runtime.txt             # Specifies Python runtime for deployment
    ├── transliteration.py      # Module for transliteration logic
    └── templates/              # Directory for all user-facing HTML templates
        ├── add_word.html
        ├── admin.html
        ├── create_user.html
        ├── edit_word.html
        ├── edit_word_review.html
        ├── index.html
        ├── login.html
        ├── login_review.html
        ├── review.html
        ├── review_entries.html
        └── wordnet_visualization.html

---

⚙️ Getting Started: Local Setup

To get a local copy up and running, follow these simple steps.

Prerequisites

• Python 3.8 or higher
• pip (Python package installer)

Installation

1. Clone the repository:

   git clone [https://github.com/rutwik-m-gondi/rutwik-m-gondi-wordnet.git](https://github.com/rutwik-m-gondi/rutwik-m-gondi-wordnet.git)
   cd rutwik-m-gondi-wordnet

2. Create and activate a virtual environment:

   • On macOS/Linux:

     python3 -m venv venv
     source venv/bin/activate

   • On Windows:

     python -m venv venv
     .\venv\Scripts\activate

3. Install the required packages:

   pip install -r requirements.txt

4. Configure the application:

   • Create a copy of the example configuration file and name it config.py:

     cp config.example.py config.py

   • Open config.py and set the required environment variables, such as a SECRET_KEY, your database connection details, and admin credentials.

5. Run the application:

   flask run

   The application will be available at http://127.0.0.1:5000.

---

🤝 Contributing

Contributions are welcome and greatly appreciated. Please fork the repository and open a pull request with your enhancements.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📜 License

This project is distributed under the MIT License. See the LICENSE file for more information. (Note: You should add a LICENSE file with the MIT License text to your repository).