A newer version of the Streamlit SDK is available:
1.54.0
metadata
title: StoryLens
emoji: 🎬
colorFrom: green
colorTo: blue
sdk: streamlit
sdk_version: 1.53.0
app_file: app.py
pinned: false
license: apache-2.0
🎬 StoryLens
Professional video ad narrative structure analyzer powered by AI. Diagnose your ad's storytelling effectiveness in 60 seconds.
✨ Features
- Multi-source Input: Upload video files (MP4, MOV, AVI, WebM) or paste YouTube URL
- AI-Powered Analysis: MiniMax Vision for frame analysis, OpenAI Whisper for transcription
- Functional Role Classification: 21 roles across 5 categories (Opening, Problem, Product, Persuasive, Closure)
- Story Arc Detection: Identifies patterns like AIDA, PAS, HFBA, and more
- Industry Benchmarks: Recommendations based on Meta research (WWW 2026)
- Actionable Insights: Prioritized recommendations with expected performance uplift
🚀 Quick Start
- Configure API keys in sidebar:
- MiniMax API Key + Group ID (for vision & LLM)
- OpenAI API Key (for Whisper transcription)
- Select your Industry and Campaign Goal
- Upload video file or paste YouTube URL
- Click "Analyze"
- Review narrative timeline, story arc, and recommendations
🔑 API Keys Required
- MiniMax: Get from MiniMax Platform
- OpenAI: Get from OpenAI Platform
📊 Supported Industries
- Apparel & Accessories
- Beauty
- Food
- Beverages
- Other
🎯 Campaign Goals
- Retention (Dwell Rate)
- Click-Through (CTR)
- Conversions (CVR)
📚 Based On
Research paper: MLLM-VADStory: Domain Knowledge-Driven Multimodal LLMs for Video Ad Storyline Insights (Meta, WWW 2026)
🛡️ Privacy
- API keys never stored permanently
- Videos processed temporarily only
- No data retention
📄 License
Licensed under Apache License 2.0
👨💻 Author
Marek Staniszewski Heuristica 🌐 www.heuristica.pl 📧 staniszewski@heuristica.pl
For questions, suggestions, or support, please contact the author.