README.md

metadata

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