model_card.md

# Myanmar Ghost Model Card

## 🏷️ Model Overview

**Model Name**: Myanmar-Ghost-Instruct  
**Model Type**: Text Classification (Sentiment Analysis)  
**Language**: Myanmar (Burmese)  
**Version**: 1.0.0  
**Last Updated**: 2025

## 📊 Model Description

Myanmar Ghost is an advanced sentiment analysis model for Myanmar language that classifies text into 4 sentiment categories with multi-modal capability (audio + text).

### Capabilities
- Myanmar text sentiment classification
- Multi-modal fusion (audio prosody + text)
- Explainable AI (SHAP, LIME)
- Privacy-preserving (Federated Learning ready)

### Limitations
- Best performance on formal Myanmar text
- May struggle with heavy use of emoji/emoticons
- Limited performance on code-mixed text

## 📈 Training Data

- **Source**: Myanmar speech datasets
- **Size**: ~1M samples
- **Splits**: 80% train, 10% validation, 10% test

## ⚙️ Model Architecture

```
Transformer (BERT-based multilingual)
├── Hidden Size: 768
├── Layers: 12
├── Heads: 12
└── Classifier Head
    └── 4-class output (negative, neutral, positive, sarcastic)
```

## 📉 Performance

| Metric | Score |
|--------|-------|
| Accuracy | ~92% |
| F1 (weighted) | ~91% |
| F1 (macro) | ~89% |
| Precision | ~91% |
| Recall | ~91% |

## 🔧 Usage

### Python
```python
from transformers import AutoModelForSequenceClassification, AutoTokenizer

model_name = "amkyawdev/Myanmar-Ghost-Instruct"
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForSequenceClassification.from_pretrained(model_name)

# Predict
text = "ကျေးဇူးပါ"
inputs = tokenizer(text, return_tensors="pt")
outputs = model(**inputs)
```

### API
```bash
curl -X POST http://localhost:8000/predict \
  -H "Content-Type: application/json" \
  -d '{"text": "ကျေးဇူးပါ"}'
```

## ⚠️ Ethical Considerations

- Model trained on publicly available Myanmar data
- No personally identifiable information used
- Regular evaluation for bias

## 📝 Citation

```
@software{myanmar_ghost,
  title = {Myanmar Ghost},
  author = {Aung Myo Kyaw},
  url = {https://huggingface.co/amkyawdev/Myanmar-Ghost-Instruct},
  year = {2025},
}
```

## 🤝 License

Apache 2.0