sol654/Lucy_AI_POWERED_TOUR_GUIDE

Lucy AI Powered Tour Guide mobile App for heritage sites in Ethiopia # ሉሲ (Lucy) - AI-Powered Cultural Tour Guide **ሉሲ (Lucy)** is a state-of-the-art, multilingual AI tour guide designed to promote and preserve Ethiopian cultural heritage. Named after the famous hominid fossil, Lucy leverages advanced AI to provide an immersive, conversational experience for tourists and history enthusiasts. **📢 Open Source & Free for Everyone** — Lucy is completely open source under the MIT license. Anyone can use, modify, and contribute to this project. --- ## 🎬 Demo Video 📥 Download Demo Video (24MB) > 💡 **Note**: GitHub doesn't support video playback in README files. Click the link above to download the video and watch it on your device. --- ## ✨ Key Features - **🎙️ Voice-First Intelligence** — Powered by Groq Whisper for real-time voice transcription and gTTS for natural speech synthesis. Speak naturally, get instant responses. - **🌍 Multilingual Support** — Fully localized in Amharic (አማርኛ), Tigrinya (ትግርኛ), Oromo (Afaan Oromoo), and English. - **🧠 Context-Aware AI** — RAG pipeline using FAISS + Sentence Transformers delivers historically accurate, fact-grounded answers. - **🗺️ Interactive Heritage Maps** — Explore 11+ UNESCO and local heritage sites with geolocation and turn-by-turn navigation. - **🎒 Personalized Journeys** — Create custom itineraries, bookmark landmarks, and get AI-curated recommendations. - **🛡️ Admin Dashboard** — Comprehensive management for heritage sites, feedback analytics, and content moderation. --- ## 📁 Project Structure ``` . ├── backend/ # FastAPI Python Backend (RAG, Voice, Auth) ├── mobile/ # React Native Expo App (UI, Maps, Voice) ├── docker-compose.yml # Production orchestration └── README.md ``` --- ## 🚀 Quick Start ### Using Docker (Recommended) ```bash git clone github.com cd Lucy_AI_POWERED_TOUR_GUIDE docker-compose up --build ``` ### Local Development **Backend:** ```bash cd backend python -m venv venv source venv …