README.md

---
title: Latifa AI — Under The Palm Tree
emoji: 🌴
colorFrom: yellow
colorTo: gray
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
python_version: 3.11
---

# 🌴 Latifa AI — Under The Palm Tree

**Your Voice Guide Under The Palm Tree**
دليلك الصوتي تحت شجرة النخيل

An interactive, voice-first educational assistant for the *Under the Palm Tree* English learning project, set in Oman, 1973.

## Features

- **Voice-first interaction** — speak to Latifa and hear her reply
- **Automatic language detection** — Arabic or English
- **Piper TTS** — free, open-source text-to-speech
- **Groq Whisper STT** — speech-to-text for microphone input
- **Knowledge base** — characters, chapters, locations, games, skills, cultural notes
- **Quick action chips** — one-tap access to common questions
- **Earthy heritage design** — warm sand, clay, burgundy palette

## Voices

| Language | Voice | Note |
|----------|-------|------|
| English | Alba (en_GB, female) | British accent |
| Arabic | Khalil (ar_JO, male) | Jordanian dialect — closest available Arabic Piper voice |

> **Limitation:** No Omani Arabic female Piper voice is currently available.
> A custom voice can be trained using Piper with Omani Arabic recordings.

## Setup

1. Duplicate or edit the Space on Hugging Face
2. Add `GROQ_API_KEY` as a **Secret** in Space settings
3. Upload the corrected `app.py`, `requirements.txt`, and `README.md`
4. The Space will rebuild automatically

## Credits

**Thuraya Mohammed Ali Al-Naabia**
Founder, Under the Palm Tree
Omani English Teacher & Educational Innovator
[www.under-palm-tree.com](https://www.under-palm-tree.com)