README.md

---
title: Age Calculator
emoji: 📅
colorFrom: blue
colorTo: indigo
sdk: streamlit
sdk_version: "1.46.1"
app_file: app.py
pinned: false
---

# 📅 Age Calculator App (Years, Months, Days)

This is a simple and interactive web app built using **Streamlit** that allows users to calculate their exact age in **years, months, and days** based on their birthdate.

---

## 🚀 Features

- Select your **birthdate** using a calendar widget
- Displays your age in a friendly format:
  > 🎉 You are 25 years, 3 months, and 12 days old!
- Clean, responsive interface powered by Streamlit

---

## 📦 Requirements

This app uses the following Python packages:

- `streamlit`
- `python-dateutil`

These are already included in the `requirements.txt` file.

---

## 📁 Files Included

- `app.py` — Main application file
- `requirements.txt` — Python dependencies
- `README.md` — You're reading it!

---

## 🌐 Deployment

You can deploy this app on:

### ➤ Hugging Face Spaces

1. Go to [https://huggingface.co/spaces](https://huggingface.co/spaces)
2. Click on **Create New Space**
3. Choose:
   - SDK: **Streamlit**
   - Python version: 3.9 or 3.10
4. Upload:
   - `app.py`
   - `requirements.txt`
   - `README.md`
5. Done! Your app is live 🎉

---

## 🧑‍💻 Built With

- [Streamlit](https://streamlit.io)
- [Python Dateutil](https://dateutil.readthedocs.io/)

---

## 📜 License

This project is open-source and free to use.

---

## 🙋‍♂️ Author

**Najaf Ali**  
_A non-CS professional building AI-powered education tools using GenAI_