Spaces:
Sleeping
Sleeping
File size: 4,004 Bytes
517dc2d f913a5a 517dc2d 63e81bc 517dc2d f913a5a d481494 f913a5a c6f3cd7 839f799 d27c146 c6f3cd7 f913a5a 2c906d5 f913a5a 2c906d5 f913a5a 2c906d5 f913a5a |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 |
---
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 |