How arpit-26/smart-cultural-storyteller works
Smart Cultural Storyteller is a Streamlit/Flask application for generating culturally themed stories, narration, imagery, and videos. The main workflow runs from user selections in the interface through Flask API orchestration, story generation and optional Hindi translation, then audio and image generation; video requests combine those assets into a video. Cultural facts, theme/language options, and regional-accent narration are supporting capabilities. The graph follows README statements and shown excerpts; some API internals and integrations are only partially sampled, so uncertain links are omitted.
Main entry points: app.py Flask API · streamlit_app.py Streamlit UI · story_generator.py Local Story Model · image_generator.py Scene Imagery
Components 14
User Interface
- Streamlit UI
frontend/streamlit_app.py
API Orchestration
- Flask API
app.py
Story Content
- Cultural Logic
storyteller.py - Local Story Model
models/story_generator.py - Hindi Translation
models/story_generator.py
Media Generation
- Scene Imagery
models/image_generator.py - Audio Narration
storyteller.py - Video Workflow
video_creator.py - Video Compiler
video_compiler.py
Other components
- Storyteller
- ElevenLabs
- Pollinations.ai
- Google Translate
- FFmpeg
Connections 13
- Storyteller → Streamlit UI: selects story
README.md - Streamlit UI → Flask API: requests stories
frontend/streamlit_app.py - Flask API → Cultural Logic: requests cultural content
app.py - Flask API → Local Story Model: generates story
app.py - Flask API → Hindi Translation: translates story
app.py - Local Story Model → Google Translate: translates text
models/story_generator.py - Flask API → Scene Imagery: requests imagery
app.py - Flask API → Audio Narration: requests narration
app.py - Audio Narration → ElevenLabs: generates speech
storyteller.py - Scene Imagery → Pollinations.ai: generates images
models/image_generator.py - Flask API → Video Workflow: creates video
app.py - Video Workflow → Video Compiler: delegates compilation
video_creator.py - Video Compiler → FFmpeg: encodes video
video_compiler.py