Spaces:
Sleeping
Sleeping
| 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 |