README.md

metadata

title: BalPOS - Balochi Part-of-Speech Tagger
sdk: gradio
emoji: 📚
colorFrom: yellow
colorTo: blue
pinned: true

---
title: BalPOS - Balochi Part-of-Speech Tagger
emoji: 🏔️
colorFrom: teal
colorTo: blue
sdk: gradio
sdk_version: 4.36.0
app_file: app.py
pinned: true
---

# 🏔️ BalPOS - Balochi Part-of-Speech Tagger

**BalPOS** is an interactive Balochi Natural Language Processing system for automatic **Part-of-Speech (POS) tagging**.

Enter a Balochi sentence and the model predicts the grammatical category of each word using the **Universal Part-of-Speech (UPOS)** tagset.

## 🚀 Try BalPOS

### How to use

1. Enter or paste a Balochi sentence.
2. Click **Tag Sentence**.
3. Review the predicted POS tags.
4. Check the token-level confidence scores.
5. Try the example sentences provided in the Space.

The interface is designed for **desktop, tablet, and mobile devices**.

---

## 🧠 Model

**Model:** `shahbakhsh/BalPOS`

**Task:** Balochi Part-of-Speech Tagging

**Backbone:** BalBERT

**Tagset:** Universal Part-of-Speech (UPOS)

BalPOS is part of a broader research project focused on developing NLP resources and models for the Balochi language.

---

## 📊 Evaluation Results

The final held-out evaluation reported the following results:

| Metric | Score |
|---|---:|
| Accuracy | **87.26%** |
| Balanced Accuracy | **78.81%** |
| Precision (Macro) | **79.56%** |
| Recall (Macro) | **78.81%** |
| F1 (Macro) | **78.99%** |
| Precision (Weighted) | **87.41%** |
| Recall (Weighted) | **87.26%** |
| F1 (Weighted) | **87.22%** |
| MCC | **0.8526** |

These results are from the project's final held-out evaluation set. They do not guarantee the same performance on every new Balochi sentence.

---

## 🏷️ UPOS Tags

BalPOS predicts 16 Universal POS categories:

| Tag | Description |
|---|---|
| `NOUN` | Noun |
| `PROPN` | Proper noun |
| `PRON` | Pronoun |
| `VERB` | Verb |
| `AUX` | Auxiliary |
| `ADJ` | Adjective |
| `ADV` | Adverb |
| `ADP` | Adposition |
| `CCONJ` | Coordinating conjunction |
| `SCONJ` | Subordinating conjunction |
| `DET` | Determiner |
| `NUM` | Numeral |
| `PART` | Particle |
| `PUNCT` | Punctuation |
| `INTJ` | Interjection |
| `X` | Other / unknown |

---

## 🔎 What You Can Test

You can test BalPOS with:

- Individual Balochi sentences
- Different grammatical structures
- Different vocabulary
- Punctuation
- Longer Balochi sentences
- Real-world Balochi text
- Different writing styles

The Space provides:

**Token → POS Tag → Confidence**

Example:

```text
چہ       → ADP
وتی      → PRON
فلسفہ    → NOUN
ءِ       → ADP
استاد    → NOUN
ءَ       → ADP

---

🧪 Testing and Feedback

If you find a potentially incorrect prediction, please record:

Sentence:
[complete Balochi sentence]

Word:
[problematic word]

Predicted POS:
[model prediction]

Expected POS:
[expected POS tag]

Additional note:
[optional explanation]

This type of feedback can help identify weaknesses and guide future improvements.

---

⚠️ Limitations

BalPOS is a research model and may produce incorrect predictions, particularly for:

• Rare words
• Unseen vocabulary
• Ambiguous words
• Different Balochi dialects
• Code-switched text
• Unusual spelling
• Text outside the training distribution

The displayed confidence represents the model's prediction confidence. It should not be interpreted as a guarantee that a prediction is correct.

For research or linguistic annotation, predictions should be reviewed by a qualified Balochi speaker or linguist.

---

🌐 Balochi NLP Research

BalPOS is one component of a larger Balochi NLP development pipeline:

Balochi Corpus
      ↓
Balochi Tokenizer
      ↓
BalBERT
      ↓
BalPOS
      ↓
BalNER
      ↓
BalMorph
      ↓
BalParser
      ↓
Balochi Language Model

The broader goal is to develop reusable NLP resources and models for Balochi.

---

🔗 Resources

🤗 Hugging Face Model

BalPOS

https://huggingface.co/shahbakhsh/BalPOS

💻 GitHub Repository

BalPOS

https://github.com/shah-bakhsh/BalPOS

---

📄 Citation

If you use BalPOS in research, please refer to the model and project repository for the latest citation information.

---

🙏 Acknowledgements

This project is part of ongoing work toward improving computational resources and NLP tools for the Balochi language.

Thank you to the Balochi speakers, researchers, annotators, and contributors supporting the development of Balochi NLP.

---

🏔️ BalPOS

Balochi NLP · Part-of-Speech Tagging · Low-Resource Language Technology