🌟 Generosity Matchmaker: AI-Powered Community Giving & Charity Companion

This is a submission for Weekend Challenge: Generosity Edition

What I Built

The Generosity Matchmaker Voice is an interactive, multi-modal 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—complete with verified platform search terms, an accessible audio voice guide, lightning-fast Solana micro-donations via scannable QR codes, and cloud impact logging powered by Snowflake.

Demo

Live App:

Generosity-MatchMaker-App

Code

GitHub Repository:

Hizba-cloud / generosity-matchmaker-voice

🌟 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—complete with verified platform search terms, an audio voice narration guide, lightning-fast Solana micro-donations, and secure impact tracking analytics via Snowflake.

---

🛠️ Built With

• Python
• Streamlit (for the frontend user interface)
• Google GenAI SDK (gemini-2.5-flash) (for fast, structured natural language generation)
• ElevenLabs API (for accessible, human-like voice synthesis and audio guides)
• Solana & Python-QRcode (for instant, low-fee web3 micro-donations via scannable QR codes)
• Snowflake (snowflake-connector-python)…

View on GitHub

How I Built It

How I Used Google AI (Gemini), ElevenLabs, Solana & Snowflake

To power this application, the project integrates the Google GenAI SDK using the gemini-2.5-flash model, the ElevenLabs API for text-to-speech voice synthesis, Solana with Python-QRcode for instant web3 micro-donations, and Snowflake for secure cloud data warehousing and impact tracking analytics.

The AI & Data Workflow

When a user submits their donation intent, the app executes a multi-step pipeline:

• Intelligent Matching & Platform Sourcing: Gemini processes the user's input 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.
  • Suggested Platforms & Search Terms: Verified organizations, platforms, or search queries to help users find active local drives and direct donation links.
  • A Polished Outreach Draft: A professional template that users can instantly copy-paste to email or message local non-profits.

• Multi-Modal Voice Narration: Using the st.session_state persistence layer, the generated action plan feeds seamlessly into the ElevenLabs API, allowing users to generate and listen to an audio narration guide of their complete generosity plan.

• Web3 Micro-Donations & QR Code Integration: Users can support community initiatives with low-fee ($0.00025) crypto contributions by instantly scanning the dynamically generated Solana QR code with a wallet like Phantom or Solflare.

• Cloud Analytics Logging (Snowflake): Every user contribution and match category is securely recorded into a Snowflake cloud data warehouse table (generosity_logs), enabling data-driven insights and impact tracking.

Built With

• Python
• Streamlit (for the frontend user interface)
• Google GenAI SDK (gemini-2.5-flash) (for fast, structured natural language generation)
• ElevenLabs API (for accessible, human-like voice synthesis)
• Solana & Python-QRcode (for instant, low-fee web3 micro-donations via scannable QR codes)
• Snowflake (for cloud data logging and impact tracking analytics)
• 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 search terms instantly.
• Step 4: Click "🔊 Generate & Play Voice Guide" to hear your complete action plan read aloud via ElevenLabs voice synthesis for seamless accessibility!
• Step 5: Scan the Solana QR code using a wallet like Phantom or Solflare to support community initiatives with lightning-fast, ultra-low-fee micro-donations.

Comments

[S M Tahosin]

Nice. but if you add a system prompt of donation link , it will be better.

[ℋℐ𝒵ℬ𝒜 (✿◠‿◠)⭐]

Thank you! I totally agree about making it as actionable as possible. I've updated the prompt to pull in specific search terms and verified platform categories so users know exactly where to go next, alongside the new voice narration feature. Thanks for checking it out!

[ℋℐ𝒵ℬ𝒜 (✿◠‿◠)⭐]

Great use of Google AI! How did you handle the API rate limits in your workflow?