๐ Generosity Matchmaker: AI-Powered Community Giving & Charity Companion
DEV Weekend Challenge: Generosity Edition Submission ๐
This is a submission for Weekend Challenge: Generosity Edition
What I Built
The Generosity Matchmaker is an interactive web application designed to bridge the gap between people wanting to give back (donating items, books, clothes, or volunteer time) and local charities or community organizations. Instead of wondering how or where to contribute, users input what they have or want to do, and the app instantly structures a custom action plan.
Demo
Live App:
Generosity-MatchMaker-App
Code
GitHub Repository:
๐ Generosity Matchmaker
An AI-powered community giving and charity companion built for the DEV Weekend Challenge: Generosity Edition.
๐ About The Project
The Generosity Matchmaker is a lightweight, interactive web application designed to bridge the gap between people wanting to give back (donating items, books, clothes, or volunteer time) and local charities or community organizations. Instead of wondering how or where to contribute, users input what they have or want to do, and the app instantly generates a custom action plan.
๐ ๏ธ Built With
- Python
- Streamlit (for the frontend user interface)
-
Google GenAI SDK (
gemini-2.5-flash) (for fast, structured natural language generation) - Python-Dotenv (for secure environment configuration)
๐ก How It Works
- User Input: The user types what they would like to contribute (e.g., “I have 3 boxes of English storybooks to give away”).
- Google AI Processing: The input is sent via the Google GenAI SDK to theโฆ
How I Built It
How I Used Google AI (Gemini)
To qualify for the Best Use of Google AI category, this project integrates the Google GenAI SDK using the gemini-2.5-flash model.
The AI Workflow
When a user submits their donation intent, Gemini processes the natural language to dynamically generate:
The Target Charity Category:
Identifying the exact cause domain (e.g., Education, Warmth Drives, Food Security).
Actionable Preparation Steps:
Clear checklists on sorting, packing, or organizing contributions.
A Polished Outreach Draft:
A professional template that users can instantly copy-paste to email or message local non-profits.
Built With
Python
Streamlit (for the frontend UI)
Google GenAI SDK (gemini-2.5-flash)
Python-Dotenv (for secure environment configuration)
How It Works
Step 1
Open the live app link and navigate to the clean Streamlit interface.
Step 2
Enter your donation or volunteering idea in the text area (e.g., “I have 3 boxes of English storybooks to give away”).
Step 3
Click “Find Match & Generate Guide โจ” to receive your tailored plan and ready-to-use outreach message instantly!