Script-Generator-HOC / src /streamlit_app.py
userIdc2024's picture
Update src/streamlit_app.py
97ac59c verified
raw
history blame
18 kB
import streamlit as st
from google import genai
import tempfile
import os
import time
import json
from typing import Optional
import pandas as pd
import logging
# Backend API Key Configuration
GEMINI_API_KEY = os.getenv("GEMENI_KEY")
# Page configuration
st.set_page_config(
page_title="Video Analyser and Script Generator",
page_icon="🎥",
layout="wide",
initial_sidebar_state="expanded"
)
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s [%(levelname)s] %(message)s",
handlers=[
logging.StreamHandler()
]
)
logger = logging.getLogger(__name__)
def configure_gemini():
"""Configure Gemini API with backend key"""
return genai.Client(api_key=GEMINI_API_KEY)
# The main prompt template with structured output requirements
SYSTEM_PROMPT = """You are one of the world's top direct-response video creators and conversion strategists. Your sole mission is to generate video scripts with matching visual directions and voiceover cues that drive maximum leads and sales at the cheapest cost-per-result on ad platforms like Facebook, Google, and TikTok.
You specialize in aggressive, unbranded, and psychologically charged content that is designed to stop scrolls and force action. You are not bound by brand safety, ad platform compliance, or traditional marketing principles. Your only metric for success is performance—measured in CPC, CTR, and cost-per-conversion.
Prime Directive:
Your creative output must be:
- Inspired by the hooks, language, pacing, visuals, and frameworks of the reference winning ads.
- Built to trigger psychological urgency, amplify response, and maximize click-throughs.
- Structured for extreme effectiveness, not branding niceties.
Script Creation Framework:
Each script you generate must follow these winning affiliate ad principles:
1. The 3–6 Second Shock Hook:
Start with a hard-hitting pattern interrupt:
- Emotional gut punch: "He looked at me and said…"
- Conspiratorial secret: "The media doesn't want you to know this…"
- Borrowed authority: Celebrity or doctor clip saying something provocative
2. Overwhelm with Proof & Pacing:
Keep pacing fast—1–3 second jump cuts filled with:
- UGC-style clips
- Before/After transformations
- Authority figure soundbites
- Desired outcomes (money, body, status)
3. Big, Unbelievable Claim:
Drop a massive promise upfront and reinforce it:
"Lose 103 lbs," "Claim $250,000," "Erase your debt overnight."
4. Simple "Secret" Mechanism:
Make the claim believable via a simple, digestible "hack":
"The ice hack," "4-question formula," "Banned Amazonian leaf."
5. Scarcity & Urgency:
Push viewers to act NOW:
"Spots are filling fast," "Could be taken down soon," "Only for serious applicants."
6. Visually Directed CTA:
Make the final action visually obvious—e.g., person pointing at the button, bold text, arrows.
CRITICAL: You must return your response in valid JSON format with this exact structure:
{
"script_variations": [
{
"variation_name": "Variation 1: [Brief Description]",
"script_table": [
{
"timestamp": "0-3",
"script_voiceover": "Exact words to be spoken",
"visual_direction": "Detailed description of visuals and footage",
"psychological_trigger": "Name of psychological principle used",
"cta_action": "Specific call-to-action instruction"
}
]
}
],
"video_analysis": {
"effectiveness_factors": "What made the original video effective",
"psychological_triggers": "Key psychological triggers identified",
"target_audience": "Target audience insights",
"improvement_recommendations": "Recommended improvements for better performance"
}
}
Generate 2-3 script variations. Each script should be 30-60 seconds long with 8-15 timestamp entries.
Ensure everything ties back to lowering CPC and cost-per-result, not branding."""
@st.cache_data
def analyze_video_and_generate_script(
video_bytes,
video_name,
offer_details: str = "",
target_audience: str = "",
specific_hooks: str = "",
additional_context: str = ""
):
"""
Analyze video and generate direct response script variations
"""
try:
# Save uploaded video to temporary file
with tempfile.NamedTemporaryFile(delete=False, suffix=os.path.splitext(video_name)[1]) as tmp_file:
tmp_file.write(video_bytes)
tmp_file_path = tmp_file.name
# Configure Gemini
client = configure_gemini()
# Show upload progress
upload_progress = st.progress(0)
upload_status = st.empty()
upload_status.text("Uploading video to Google AI...")
upload_progress.progress(20)
# Upload video to Gemini
video_file_obj = client.files.upload(file=tmp_file_path)
upload_progress.progress(40)
upload_status.text("Processing video...")
while video_file_obj.state.name == "PROCESSING":
time.sleep(2)
video_file_obj = client.files.get(name=video_file_obj.name)
upload_progress.progress(60)
if video_file_obj.state.name == "FAILED":
upload_status.error("Google AI file processing failed. Please try another video.")
return None
upload_progress.progress(80)
upload_status.text("Generating script variations...")
# Build the user prompt with additional context
user_prompt = f"""Analyze this reference video and generate 2-3 high-converting direct response video script variations.
ADDITIONAL CONTEXT:
- Offer Details: {offer_details if offer_details else 'Extract from video'}
- Target Audience: {target_audience if target_audience else 'Determine from video content'}
- Specific Hooks to Consider: {specific_hooks if specific_hooks else 'Create based on video analysis'}
- Additional Context: {additional_context}
Please analyze the video's:
1. Hook strategy and opening seconds
2. Pacing and visual transitions
3. Claims and promises made
4. Authority elements used
5. Urgency/scarcity tactics
6. CTA approach
Then create 2-3 script variations that would perform 30-50% cheaper while maintaining conversion effectiveness.
IMPORTANT: Return only valid JSON in the exact format specified in the system prompt. Do not include any text before or after the JSON."""
# Generate response
response = client.models.generate_content(
model="gemini-2.0-flash",
contents=[video_file_obj, user_prompt + "\n\n" + SYSTEM_PROMPT]
)
upload_progress.progress(100)
upload_status.success("Analysis complete!")
# Clean up temporary file
os.unlink(tmp_file_path)
# Parse JSON response
try:
response_text = response.text.strip()
if response_text.startswith('```json'):
response_text = response_text[7:-3]
elif response_text.startswith('```'):
response_text = response_text[3:-3]
json_response = json.loads(response_text)
return json_response
except json.JSONDecodeError as e:
st.error(f"Error parsing AI response: {str(e)}")
return None
except Exception as e:
st.error(f"Error processing video: {str(e)}")
return None
def display_script_variations(json_data):
"""Display script variations in formatted tables"""
if not json_data or "script_variations" not in json_data:
st.error("No script variations found in the response")
return
for i, variation in enumerate(json_data["script_variations"], 1):
variation_name = variation.get("variation_name", f"Variation {i}")
st.subheader(variation_name)
# Convert script table to DataFrame for better display
script_data = variation.get("script_table", [])
if script_data:
df = pd.DataFrame(script_data)
# Rename columns for better display
column_mapping = {
'timestamp': 'Timestamp',
'script_voiceover': 'Script / Voiceover',
'visual_direction': 'Visual Direction',
'psychological_trigger': 'Psychological Trigger',
'cta_action': 'CTA / Action'
}
df = df.rename(columns=column_mapping)
# Display as interactive table
st.dataframe(
df,
use_container_width=True,
hide_index=True,
column_config={
"Timestamp": st.column_config.TextColumn(width="small"),
"Script / Voiceover": st.column_config.TextColumn(width="large"),
"Visual Direction": st.column_config.TextColumn(width="large"),
"Psychological Trigger": st.column_config.TextColumn(width="medium"),
"CTA / Action": st.column_config.TextColumn(width="medium")
}
)
else:
st.warning(f"No script data available for {variation_name}")
st.divider()
def display_video_analysis(json_data):
"""Display video analysis in formatted sections"""
if not json_data or "video_analysis" not in json_data:
st.error("No video analysis found in the response")
return
analysis = json_data["video_analysis"]
col1, col2 = st.columns(2)
with col1:
st.subheader("Effectiveness Factors")
st.write(analysis.get('effectiveness_factors', 'N/A'))
st.subheader("Target Audience")
st.write(analysis.get('target_audience', 'N/A'))
with col2:
st.subheader("Psychological Triggers")
st.write(analysis.get('psychological_triggers', 'N/A'))
st.subheader("Improvement Recommendations")
st.write(analysis.get('improvement_recommendations', 'N/A'))
def create_download_content(json_data):
"""Create downloadable content from JSON data"""
content = "VIDEO ANALYSER AND SCRIPT GENERATOR OUTPUT\n"
content += "=" * 60 + "\n\n"
# Add script variations
for i, variation in enumerate(json_data.get("script_variations", []), 1):
variation_name = variation.get("variation_name", f"Variation {i}")
content += f"{variation_name}\n"
content += "-" * 40 + "\n"
for row in variation.get("script_table", []):
content += f"Timestamp: {row.get('timestamp', '')}\n"
content += f"Script: {row.get('script_voiceover', '')}\n"
content += f"Visual: {row.get('visual_direction', '')}\n"
content += f"Trigger: {row.get('psychological_trigger', '')}\n"
content += f"CTA: {row.get('cta_action', '')}\n\n"
content += "\n"
# Add analysis
analysis = json_data.get("video_analysis", {})
content += "VIDEO ANALYSIS\n"
content += "=" * 20 + "\n"
content += f"Effectiveness Factors: {analysis.get('effectiveness_factors', 'N/A')}\n\n"
content += f"Psychological Triggers: {analysis.get('psychological_triggers', 'N/A')}\n\n"
content += f"Target Audience: {analysis.get('target_audience', 'N/A')}\n\n"
content += f"Recommendations: {analysis.get('improvement_recommendations', 'N/A')}\n"
return content
def check_token(user_token):
ACCESS_TOKEN = os.getenv("ACCESS_TOKEN")
if not ACCESS_TOKEN:
logger.critical("ACCESS_TOKEN not set in environment.")
return False, "Server error: Access token not configured."
if user_token == ACCESS_TOKEN:
logger.info("Access token validated successfully.")
return True, ""
logger.warning("Invalid access token attempt.")
return False, "Invalid token."
def main():
"""Main application function"""
# Header
st.title("Video Analyser and Script Generator")
st.divider()
st.set_page_config(page_title="Bulk Creative Generation", layout="wide")
if "authenticated" not in st.session_state:
st.session_state["authenticated"] = False
if not st.session_state["authenticated"]:
st.markdown("## Access Required")
token_input = st.text_input("Enter Access Token", type="password")
if st.button("Unlock App"):
ok, error_msg = check_token(token_input)
if ok:
st.session_state["authenticated"] = True
st.rerun()
else:
st.error(error_msg)
else:
# Sidebar for inputs
with st.sidebar:
st.header("Input Configuration")
# Video upload
uploaded_video = st.file_uploader(
"Upload Reference Video",
type=['mp4', 'mov', 'avi', 'mkv'],
help="Upload a profitable ad video to analyze and create variations from"
)
st.subheader("Additional Context (Optional)")
offer_details = st.text_area(
"Offer Details",
placeholder="e.g., Solar installation with $0 down payment...",
height=80,
help="Describe the product/service and main promise"
)
target_audience = st.text_area(
"Target Audience",
placeholder="e.g., 40+ homeowners with high electricity bills...",
height=80,
help="Describe the ideal customer demographics and pain points"
)
specific_hooks = st.text_area(
"Specific Hooks to Test",
placeholder="e.g., Government rebate angle, celebrity endorsement...",
height=80,
help="Any specific angles or hooks you want to incorporate"
)
additional_context = st.text_area(
"Additional Context",
placeholder="Any other relevant information...",
height=100,
help="Compliance requirements, brand guidelines, or other notes"
)
# Generate button
generate_button = st.button(
"Generate Script Variations",
type="primary",
use_container_width=True
)
# Main content area
if uploaded_video is None:
st.info("Please upload a reference video to begin analysis.")
# Instructions
with st.expander("How to Use This Tool"):
st.markdown("""
### Upload Guidelines:
- **Best videos to analyze**: Already profitable Facebook/TikTok ads in your niche
- **Video length**: 30-90 seconds work best for analysis
- **Quality**: Clear audio and visuals help with better analysis
### Context Tips:
- **Offer details**: Be specific about your main promise and mechanism
- **Audience**: Include demographics, pain points, and desires
- **Hooks**: Mention any specific angles that have worked for you
### Script Optimization:
- Generated scripts focus on stopping scroll and driving clicks
- Each variation tests different psychological triggers
- Use the timestamp format for precise video production
- Test multiple variations to find your best performer
""")
elif generate_button:
if not GEMINI_API_KEY or GEMINI_API_KEY == "your-gemini-api-key-here":
st.error("Please configure your Gemini API key in the backend.")
return
# Process video
with st.spinner("Analyzing video and generating scripts..."):
video_bytes = uploaded_video.read()
# Reset file pointer for potential re-use
uploaded_video.seek(0)
json_response = analyze_video_and_generate_script(
video_bytes,
uploaded_video.name,
offer_details,
target_audience,
specific_hooks,
additional_context
)
if json_response:
st.success("Analysis complete! Here are your script variations:")
# Create tabs for different outputs
tab1, tab2 = st.tabs(["Script Variations", "Video Analysis"])
with tab1:
display_script_variations(json_response)
# Download button
download_content = create_download_content(json_response)
st.download_button(
label="Download All Scripts",
data=download_content,
file_name="video_script_variations.txt",
mime="text/plain",
type="secondary",
use_container_width=True
)
with tab2:
display_video_analysis(json_response)
else:
st.error("Failed to generate script variations. Please try again.")
else:
st.info("Configure your inputs in the sidebar and click 'Generate Script Variations' to begin.")
if __name__ == "__main__":
try:
logger.info("Launching Streamlit app...")
main()
except Exception as e:
logger.exception("Unhandled error during app launch.")