---
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](https://huggingface.co/learn).
---


### 🗂 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:
   ```bash
   git checkout -b feature-xyz

















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