Hugging Face's logo

Spaces:
dlaima
/
GalaGuide_Agentic_RAG
Sleeping

App Files Community
GalaGuide_Agentic_RAG / README.md
dlaima's picture
dlaima
Update README.md
531ca97 verified
preview code
|
raw
history blame contribute delete
4 kB

A newer version of the Gradio SDK is available: 6.2.0

Upgrade
metadata
title: GalaGuide Agentic RAG
emoji: 💻
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: 5.30.0
app_file: app.py
pinned: false
license: mit
short_description: 🎩 Elegant & Professional GalaGuide

🎩 Elegant & Professional GalaGuide

A sleek, intelligent assistant app designed to support event organizers during a gala by providing personalized guest experiences and real-time support.

🧑‍🏫 This app is part of the Hugging Face Courses series and was developed as an educational project to showcase how machine learning can be used in real-world event scenarios. Learn more at Hugging Face Courses.

🗂 Folder Structure 

GalaGuide Agentic RAG_app/
│
├── app.py                       # Main launcher script that initializes and runs the Gradio app.
├── tools.py                     # Tools definitions (e.g Web search tool (e.g., DuckDuckGo, ContextualWeb), Weather info tool (dummy or real API integration), etc)
├── retriever.py                 # Guest info retriever logic (CSV/JSON dataset support)
├── .env.template                # Template file showing expected environment variables (e.g., API keys).
├── requirements.txt             # Python dependencies 
└── README.md                    # Project overview, setup instructions, usage examples

✨ Features

  • ✅ Loads the Hugging Face guest dataset by default
  • ✅ Allows uploading custom guest lists (CSV or JSON)
  • ✅ Offers sample data for exploration
  • ✅ Uses AI to generate conversation starters and guest insights
  • ✅ Displays structured guest info including relationships, interests, and bios
  • ✅ Pre-event, in-event, and post-event support capabilities

🧠 Capabilities Overview

🎟️ Guest Management

Task Description
📇 Guest Lookup Retrieve profiles using name, email, or relation
🧠 Personalized Intros Suggest how to approach guests based on their interests

🗣️ Conversation & Networking Help

Task Description
💬 Conversation Starters Suggest icebreakers based on a guest’s background
📎 Guest Matchmaking Recommend attendees to meet based on shared interests
🗂️ Topic Summaries Provide short summaries of key topics (e.g., AI, climate policy)
🧠 Prep Notes Brief you on a guest’s role before meeting them

🔧 Event Tools

Tool Purpose
WeatherInfoTool Inform guests about weather/coat preparation
NewsSearchTool Fetch relevant news related to event themes
DuckDuckGoSearchTool General-purpose web search during Q&A or open discussions

🛠️ How to Use

  1. Launch the app in your browser (hosted on Hugging Face Spaces)
  2. 📤 Upload your own CSV or JSON guest file with your custom guest list — or use the default dataset 📥 Download sample_guests.csv
  3. Browse guest profiles, get insights, and use tools for networking and event prep
  4. 💡 Suggested prompts are available directly in the app interface for inspiration.

🤝 Contributing

We welcome contributions to improve GalaGuide!

  1. Fork the repository
  2. Create a new branch:
    git checkout -b feature-xyz

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference