Skip to content

PalGeoLLM is a mobile chatbot application that provides accurate and unbiased information about Palestine’s geography and history.

License

Notifications You must be signed in to change notification settings

SinaLab/PalGeoLLM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PalGeoLLM

PalGeoLLM is a mobile chatbot application that provides accurate and unbiased information about Palestine’s geography and history. It is powered by a fine-tuned Large Language Model (LLM) trained on over 20,564 Arabic question-answer pairs.


Overview

Understanding Palestine’s geography and preserving its cultural identity is more important than ever. This project integrates machine learning and mobile development to offer a chatbot that can accurately answer questions about Palestine, from cities and landmarks to historical and demographic details.


Core Features

  • Custom Arabic Dataset: 20,564 manually and semi-synthetically curated Q&A pairs.
  • Fine-tuned LLMs: Three models evaluated — aya-expanse-8b, LLaMAX 3, and Mistral-7B-Instruct-v0.3.
    Final Model: Mistral-7B-Instruct-v0.3 for its top accuracy.
  • Instruction Fine-Tuning with QLoRA.
  • APIs via Hugging Face for seamless integration.
  • Flutter-based Mobile App (iOS & Android).
  • Local SQLite database support.

Dataset Summary


Model Evaluation

Model BERT F1 Score LLM-as-a-Judge Rating
aya-expanse-8b 0.75 ⭐⭐⭐⭐☆
LLaMAX 3 0.70 ⭐⭐⭐⭐☆
Mistral (Final) 0.74 ⭐⭐⭐⭐⭐

🛠️ Technologies Used

  • Python: Model fine-tuning and data processing
  • Transformers / PEFT / QLoRA
  • Label Studio: Data annotation
  • Hugging Face Hub: Model deployment
  • Flutter SDK: Mobile development
  • SQLite: Local storage

🔧 How to Run

  1. Clone the repo:

    https://github.com/SinaLab/PalGeoLLM.git 
  2. Set up the Flutter app:

    cd app
    flutter pub get
    flutter run
  3. Backend (LLM) is hosted on Hugging Face and queried via HTTP API from the mobile app.


Objectives

  • Counter LLM biases against Palestine by fine-tuning on reliable Arabic sources.

  • Build an accessible and educational mobile tool.

  • Raise awareness of Palestine’s geographic and cultural identity.


Support Palestine Through Technology

“Technology is a tool — we chose to use it to preserve our truth.”

About

PalGeoLLM is a mobile chatbot application that provides accurate and unbiased information about Palestine’s geography and history.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •