🎬 Script Architect

AI-powered short-form video script generator for TikTok, Instagram Reels & YouTube Shorts — built on Apify + LangGraph + Gemini 2.0 Flash.

Stop staring at a blank screen. Script Architect researches what's trending, studies top creators in your niche, and writes you a fully structured, ready-to-film video script — complete with hooks, scene-by-scene breakdowns, dialogue, visual prompts, and captions.

---

✨ What It Does

Script Architect is a fully autonomous AI agent that:

1. 🔍 Researches trending content — scrapes TikTok/Instagram for what's going viral in your niche right now
2. 👥 Analyzes top creators — reverse-engineers hook styles, pacing, engagement patterns, and visual techniques from successful videos
3. ✍️ Writes your script — generates a structured, scene-by-scene video script with hooks, narration, visual prompts, and on-screen text
4. ✅ Validates everything — Pydantic validators enforce duration math, scene sequencing, and output quality before delivery

---

🚀 How It Works

The agent runs as a LangGraph state machine with four coordinated nodes:

Input → Trending Research → Creator Analysis → Script Generation → Validated Output

Each node is powered by Gemini 2.0 Flash with specialized prompts for its task. All research is done via live Apify sub-actors with real data.

---

📥 Input

Parameter	Type	Description
topic	string	Your video topic or niche (e.g. "morning routine", "AI tools")
platform	string	Target platform: tiktok, instagram, or youtube_shorts
duration	number	Target video length in seconds (15–60)
style	string	Creator style: educational, entertainment, storytime, tutorial
creatorHandle	string	(Optional) A creator handle to analyze for style reference

---

📤 Output

Each run produces a structured script object:

{
  "title": "5 AI Tools That Will 10x Your Productivity",
  "hook": "You are working 10 hours a day and still falling behind — here is why.",
  "totalDuration": 45,
  "scenes": [
    {
      "sceneNumber": 1,
      "duration": 5,
      "type": "hook",
      "narration": "You are working 10 hours a day and still falling behind. Here is why.",
      "visualPrompt": "Close-up of tired person at laptop, clock ticking in corner",
      "onScreenText": "Sound familiar?",
      "transition": "quick_cut"
    }
  ],
  "caption": "5 AI tools that changed my workflow forever #productivity #aitools",
  "hashtags": ["#productivity", "#aitools", "#worksmarter"],
  "trendingInsights": { "topHooks": [], "avgDuration": 42 },
  "creatorAnalysis": { "hookStyle": "question", "pacing": "fast" }
}

---

🏗️ Scene Structure

Every scene includes:

Field	Description
narration	Exactly what to say (voice-over or talking head)
visualPrompt	What to show on screen / b-roll description
onScreenText	Captions, text overlays, emojis
duration	Scene length in seconds (all scenes sum to total duration)
transition	Cut type to next scene
type	hook / content / cta / outro

---

💰 Pricing

Event	Cost	When
Script Generated	$0.05	Per complete script produced
Trending Research	$0.02	Per trending topic research cycle
Creator Analysis	$0.03	Per creator style profile analyzed

A typical run (1 script + research + creator analysis) costs ~$0.10

---

🛠️ Running Locally

git clone https://github.com/moulds-ai/script-generation
cd script-generation
pip install -r requirements.txt
export APIFY_TOKEN=your_token
export GEMINI_API_KEY=your_key
apify run

---

☁️ Deploying to Apify

apify login
apify push

---

🔗 Built With

• Apify Platform — scraping infrastructure & actor orchestration
• LangGraph — agentic state machine framework
• Gemini 2.0 Flash — fast, multimodal AI reasoning
• Pydantic — output validation & schema enforcement

---

Made with love by Rahul Agarwal · moulds.ai/script-generation