Multi-agent conversational system generating immersive, location-aware audio tours with expressive TTS output.
### 🎓 FREE Step-by-Step Tutorial **👉 [Click here to follow our complete step-by-step tutorial](https://www.theunwindai.com/p/build-a-self-guided-ai-audio-tour-agent) and learn how to build this from scratch with detailed code walkthroughs, explanations, and best practices.** A conversational voice agent system that generates immersive, self-guided audio tours based on the user’s **location**, **areas of interest**, and **tour duration**. Built on a multi-agent architecture using OpenAI Agents SDK, real-time information retrieval, and expressive TTS for natural speech output. --- ## 🚀 Features ### 🎙️ Multi-Agent Architecture - **Orchestrator Agent** Coordinates the overall tour flow, manages transitions, and assembles content from all expert agents. - **History Agent** Delivers insightful historical narratives with an authoritative voice. - **Architecture Agent** Highlights architectural details, styles, and design elements using a descriptive and technical tone. - **Culture Agent** Explores local customs, traditions, and artistic heritage with an enthusiastic voice. - **Culinary Agent** Describes iconic dishes and food culture in a passionate and engaging tone. --- ### 📍 Location-Aware Content Generation - Dynamic content generation based on user-input **location** - Real-time **web search integration** to fetch relevant, up-to-date details - Personalized content delivery filtered by user **interest categories** --- ### ⏱️ Customizable Tour Duration - Selectable tour length: **15, 30, or 60 minutes** - Time allocations adapt to user interest weights and location relevance - Ensures well-paced and proportioned narratives across sections --- ### 🔊 Expressive Speech Output - High-quality audio generated using **Gpt-4o Mini Audio** ### How to get Started? 1. Clone the GitHub repository ```bash git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git cd ai_agent_tutorials/ai_audio_tour_agent ``` 2. Install the required dependencies: ```bash pip install -r requirements.txt ``` 3. Get your OpenAI API Key - Sign up for an [OpenAI account](https://platform.openai.com/) (or the LLM provider of your choice) and obtain your API key. 4. Run the Streamlit App ```bash streamlit run ai_audio_tour_agent.py ```