glosings0n/hadithiai

HadithiAI is a modern storytelling platform designed to preserve and celebrate African oral traditions through the power of Generative AI # HadithiAI HadithiAI is a Live Agents challenge submission focused on real-time storytelling and learning. ## Challenge Submission Checklist ### 1) Public Code Repository URL - github.com ### 2) Reproducible Spin-up Instructions Prerequisites: - Flutter SDK 3.35+ - Dart SDK (bundled with Flutter) - Android Studio or VS Code with Flutter tooling - Android/iOS emulator or physical device Quick start: ```bash git clone github.com cd hadithiai flutter pub get flutter run ``` Validation: ```bash flutter analyze ``` Backend target used by this app: - Cloud Run API base URL is configured in lib/core/constants/api_constants.dart - Current value: hadithiai-orchestrator-2922… ### 3) Proof of Google Cloud Deployment Google Cloud proof is provided through one of the following: - Option A: a short recording proving backend is running on Google Cloud (Cloud Run console page or live logs) - Option B: a repository code link proving usage of Google Cloud services/APIs Code evidence links: - Cloud Run backend URL config: lib/core/constants/api_constants.dart - Live API docs on deployed backend: hadithiai-orchestrator-2922… - Frontend API contract consumed from orchestrator: github.com - Story generation API calls from app: - lib/core/services/api_service.dart - lib/core/providers/story_provider.dart Cloud Run deployment screenshot: Other proof: - Recording URL (Cloud Run proof): [LINK_HERE] - Optional backend repository/code proof link: github.com ### 4) Architecture Diagram ```mermaid flowchart LR U["Mobile User"] --> A["Flutter App"] subgraph APP["App Layer"] A --> P1["AppSessionProvider"] A --> P2["StoryProvider"] A --> P3["StoryNarrationProvider"] A --> P4["LiveAudioProvider"] A --> P5["RiddleProvider"] e …