# 🌟 Joyful Kids Bible Agent
### *A Gentle, Playful 5-Day Bible Activity Generator for Little Ones (Ages 2–7)*
Built with OpenAI Agentic AI & Gradio — Created with love for families 💛

---
## 🚀 Try It Now!

[![Try it now!](https://huggingface.co/spaces/HannaZZZ/joyful-kids-bible-agent)]

---

## ✨ What This App Does

This app instantly creates a **5-day Bible playtime plan** customized for young children.

Each day includes:
- 📖 A short devotional  
- 🎨 Easy crafts and hands-on activities  
- 🎶 Praise prompts or songs  
- 💬 Parent encouragement  
- 📅 A suggested calendar reminder  

Perfect for busy families wanting meaningful, faith-filled moments without complicated prep.

---

## 👨‍👩‍👧‍👦 Who It’s For

- Christian parents  
- Children ages **2–7**  
- Sunday school helpers  
- Families wanting to plant seeds of faith 🌱  

Warm, simple, joyful, and family-friendly.

---

## 🎁 How It Works

1. Choose a theme (Christmas, Easter, Thankfulness, Joy, Courage, etc.)  
2. Select the children’s age range  
3. Pick a daily duration  
4. Click **Generate**  
5. Receive a personalized, child-friendly 5-day Bible series  

Powered by OpenAI's agentic tools for structured and consistent output.

---

## 🔧 Tech Behind the App

- OpenAI Python SDK  
- Agentic function tools  
- Async streaming  
- Gradio UI  
- Hugging Face Spaces  

---

## 🛡️ Notes

- Email sending is disabled for safety  
- No personal data is collected  
- API usage is protected by billing limits  

---

## 🌈 Future Enhancements

- Printable worksheets  
- Audio “Storytime Mode”  
- ICS calendar file download  
- Chinese + English bilingual mode  
- Memory verse mini-games  
- More seasonal themes  

---

## ❤️ Creator’s Note

“I built this as a mom who wants to share God’s love, joy, and peace with little ones in fun, simple ways.  
May this bring warmth and connection to your family time.”

Blessings to you and your children ✨🧸💛
