📅 Flyer2Calendar

Convert posters and flyers into ready-to-use calendar events using AI (Gemini), with options to download .ics files or add events directly to Google Calendar.
This app was built with Streamlit + Gemini API + Python.

---

🚀 Features

• 🧠 AI Event Extraction from flyer images
• 📸 Upload up to 5 flyers at once
• ✏️ Edit extracted event details before exporting
• 📥 Download individual or merged .ics files
• 🌐 Directly add events to Google Calendar (one or all events)
• 🗑️ Remove individual events or clear all
• ⚡ Fast, clean UI with streamlined workflow

---

🗂️ Project Structure

flyer2calendar/
│
├── app.py
├── requirements.txt
├── README.md
│
├── backend/
│   ├── extraction.py
│   ├── calendar_utils.py
│   └── __init__.py
│
├── posters/           # sample flyers (optional)

---

🔧 Installation

1️⃣ Clone the repository

git clone https://github.com/YOUR_USERNAME/flyer2calendar.git
cd flyer2calendar

2️⃣ Create a virtual environment

python3 -m venv venv
source venv/bin/activate      # Mac/Linux
venv\Scripts\activate         # Windows

3️⃣ Install dependencies

pip install -r requirements.txt

---

🔑 Environment Variables

Create a .env file in the project root:

GEMINI_API_KEY=your_api_key_here

Each user provides their own Gemini API key — your repo stays safe.

---

▶️ Run the app

streamlit run app.py

The app will open at:

• Local: http://localhost:8501
• Network: http://:8501

---

📤 How It Works

1. Upload 1–5 flyer images
2. Gemini extracts event info
3. You review/edit the results
4. Choose:
   • Download .ics
   • Add to Google Calendar
   • Add ALL to Google Calendar
5. Done!

---

📦 Requirements

See requirements.txt:

streamlit
python-dotenv
Pillow
google-generativeai

---

🤝 Contributing

Pull requests are welcome!
If you'd like to improve extraction accuracy or UI, feel free to open an issue.

---

Enjoy using Flyer2Calendar!
For issues or ideas, reach out anytime.