Skip to content

Repository files navigation

🎬 Scriptify AI

Scriptify AI Banner

From One Idea to a Complete Screenplay

AI-Powered Creative Co-Writer for Movies, Stories, Dialogues & Songs

Python FastAPI Streamlit LangGraph SQLite IBM Bob License


πŸ“– Overview

Scriptify AI is an AI-powered creative writing platform that transforms a single idea into a complete production-ready screenplay.

Instead of generating isolated responses like traditional AI chatbots, Scriptify AI acts as an intelligent creative partner by guiding users through the complete storytelling workflowβ€”from idea generation to screenplay writing, dialogue creation, song generation, review, and export.

The platform uses a multi-agent AI architecture with persistent memory to maintain character consistency, relationships, story progression, and creative continuity throughout the project.

Built for the IBM AI Builders Challenge – Creative Industries Theme.


🎯 Problem Statement

Creating high-quality stories, movies, and songs requires significant time, planning, and creativity.

Writers frequently struggle with:

  • Writer's block
  • Character inconsistency
  • Story continuity
  • Dialogue writing
  • Plot organization
  • Maintaining context across long projects

Existing AI tools generate isolated responses without remembering the complete project, making long-form storytelling difficult.


πŸ’‘ Solution

Scriptify AI acts as an AI Creative Co-Writer.

A user provides a simple idea such as

"A detective solving mysterious murders in Mumbai."

Scriptify AI automatically develops:

  • Story Concept
  • Characters
  • Story Structure
  • Scene Planning
  • Screenplay
  • Dialogues
  • Songs
  • Scene Improvements
  • Exportable Project

using specialized AI agents working together.


✨ Features

  • πŸ’‘ AI Idea Generator
  • πŸ‘€ Character Builder
  • πŸ“– Story Structure Generator
  • 🎬 Screenplay Writer
  • πŸ’¬ Dialogue Generator
  • 🎡 Song Generator
  • ✨ AI Rewrite Assistant
  • 🧠 Persistent Story Memory
  • πŸ“ Multi Project Management
  • πŸ“„ PDF / TXT / JSON Export

πŸ”„ Workflow

Idea

↓

Story Development

↓

Character Creation

↓

Story Structure

↓

Scene Planning

↓

Screenplay Writing

↓

Dialogue Generation

↓

Song Generation

↓

Review & Rewrite

↓

Export

πŸ€– AI Agent Architecture

Scriptify AI follows a Multi-Agent Architecture.

Agent Responsibility
Idea Agent Converts ideas into story concepts
Character Agent Creates detailed character profiles
Story Agent Generates story structure
Screenplay Agent Writes screenplay scenes
Dialogue Agent Generates contextual dialogues
Song Agent Creates songs and lyrics
Review Agent Reviews and rewrites scenes

🧠 AI Approach

Instead of relying on a single prompt, Scriptify AI orchestrates multiple specialized AI agents using LangGraph.

The application maintains long-term story consistency using:

  • SQLite for structured project data
  • ChromaDB for semantic memory
  • Shared state management between agents

This allows every agent to understand previous events, character personalities, relationships, and story progression.


πŸ—οΈ System Architecture

image

πŸ’» Tech Stack

Category Technology
Language Python
Frontend Streamlit
Backend FastAPI
AI Workflow LangGraph
LLM IBM Granite (via Ollama)
Development Tool IBM Bob
Database SQLite
Vector Database ChromaDB
Validation Pydantic
Version Control Git & GitHub

πŸ“‚ Project Structure

SCRIPTIFYAI/

β”‚
β”œβ”€β”€ assets/
β”‚
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ agents/
β”‚   β”œβ”€β”€ api/
β”‚   β”œβ”€β”€ db/
β”‚   β”œβ”€β”€ export/
β”‚   β”œβ”€β”€ memory/
β”‚   β”œβ”€β”€ config.py
β”‚   └── main.py
β”‚
β”œβ”€β”€ data/
β”‚
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ pages/
β”‚   └── app.py
β”‚
β”œβ”€β”€ tests/
β”‚
β”œβ”€β”€ .env
β”œβ”€β”€ .env.example
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ pip-constraints.txt
β”œβ”€β”€ run_pipeline_test.py
β”œβ”€β”€ test_live_call.py
β”œβ”€β”€ test_ollama_connection.py
β”œβ”€β”€ test_raw_generate_timing.py
└── README.md

πŸš€ Getting Started

Clone Repository

git clone https://github.com/your-username/ScriptifyAI.git

cd ScriptifyAI

Create Virtual Environment

python -m venv .venv

Windows

.venv\Scripts\activate

Linux/macOS

source .venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Configure Environment

Create .env

OLLAMA_BASE_URL=http://localhost:11434

MODEL_NAME=granite3.3:2b

Run Ollama

ollama serve

Pull Granite Model

ollama pull granite3.3:2b

Run Application

Backend

python -m uvicorn backend.main:app --reload --port 8000  

Frontend

streamlit run frontend/app.py

πŸ§ͺ Testing

Run

python test_ollama_connection.py
python run_pipeline_test.py

πŸ“„ Export Formats

Scriptify AI supports exporting projects as:

  • PDF
  • Plain Text
  • JSON

🎯 Challenge Theme

Creative Industries

Scriptify AI empowers writers, filmmakers, storytellers, and creators by transforming imagination into complete production-ready creative content using AI.


🀝 How IBM Bob Was Used

IBM Bob served as the primary AI development tool throughout this project.

It was used for:

  • Architecture planning
  • Folder structure design
  • Multi-agent workflow planning
  • Database schema design
  • LangGraph workflow design
  • API scaffolding
  • Code generation
  • Debugging
  • Testing
  • Code review
  • Performance optimization

πŸš€ Future Roadmap

  • Storyboard Generation
  • Voice Dialogue Generation
  • AI Casting Suggestions
  • Trailer Script Generation
  • Multi-language Support
  • Cloud Synchronization
  • Collaboration
  • Character Relationship Graphs

πŸ“Έ Screenshots

🏠 Home Dashboard

Scriptify AI Home

The main dashboard where users can create, manage, and continue creative writing projects.


πŸ“– Story Generator

Story Generator

Generate complete story concepts from a single idea, including title, genre, synopsis, theme, and target audience.


🎬 Screenplay Generator

Screenplay Generator

Generate professionally formatted screenplay scenes with action descriptions, characters, and scene headings.


πŸ’¬ Dialogue Generator

Dialogue & Review

Create natural, context-aware dialogues while maintaining character consistency throughout the story.


🎡 Song Generator

Song Generator

Generate songs and lyrics based on the story genre, emotions, and scene context.


πŸ“ Project Management

Project Management

Create, organize, switch, and manage multiple Scriptify AI projects from a centralized workspace.


✨ AI Review & Rewrite

AI Review

Review generated content and rewrite scenes with improved emotion, suspense, pacing, or cinematic quality.


πŸ“€ Export Project

Export Project

Export the completed project in multiple formats, including PDF, TXT, and JSON.


🧠 AI Workflow Pipeline

Pipeline

Illustration of Scriptify AI's multi-agent workflow, showing how specialized AI agents collaborate to transform a simple idea into a complete screenplay while maintaining long-term memory and consistency.

πŸ‘¨β€πŸ’» Author

Bhavesh Vadnere

GitHub: https://github.com/BhaveshV23

LinkedIn: https://www.linkedin.com/in/bhavesh-vadnere/


πŸ“œ License

This project is licensed under the MIT License.


⭐ If you found this project interesting, consider giving it a star.

Scriptify AI β€” From One Idea to a Complete Screenplay

About

AI-powered creative co-writer that transforms ideas into complete screenplays, stories, dialogues & songs using a multi-agent architecture.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages