Practical overview
When it fits
Use it when you want a repository-based example of film-script text generation and are prepared to run the Streamlit app locally or inspect its data and model components.
Who it is for
- People who want to experiment with GPT-2-based film-script text generation through a Streamlit app.
- Developers exploring a small text-generation project with script parsing, data collection and model fine-tuning components.
Documented uses
- Generate film-script-style text in the Streamlit app.
- Collect film-script data into a JSON file using the included Scrapy spider.
- Explore the project's notebook and utilities for fine-tuning and parsing script text.
Requirements & limits
The project is published under the MIT license. The README documents local app setup; it does not describe a hosted app.
- The first local app run may take longer because it downloads the model from Hugging Face's model hub.
- The scraper exports JSON, but placing the output in the app's data directory is a manual step.
- The repository also contains Twitter bot code that publishes script snippets; the README describes posting about once per hour.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the Streamlit app locally
Install the repository requirements and launch the documented app entry point.
Before you start
- A local environment capable of cloning the public GitHub repository and installing its requirements.
- Internet access for the first-run download of the model from Hugging Face's model hub.
Steps
Clone https://github.com/cdpierse/script_buddy_v2.git.
Run the command below from the cloned repository.
pip install -r requirements.txtChange into the
script_buddydirectory.Run
streamlit run app.py.
Expected outcome
The README says this opens an instance of the app for experimenting with film-script text generation.
Guide limitations
- The first run may take a while while the model downloads.
Collect script data with the Scrapy spider
Export the spider's collected film-script data to JSON and place the file in the app's data directory.
Before you start
- The repository's
imsdb_scrapercomponent and a Scrapy environment.
Steps
Change into the
imsdb_scraperdirectory.Run
scrapy crawl scriptSpider -o scripts.json -t json.Manually move the resulting
scripts.jsonfile toscript_buddy/data/.
Expected outcome
The scraped output is placed in the data directory identified by the README for the model project.
Guide limitations
- The README says there is no pipeline to save the scraper output automatically.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- cdpierse/script_buddy_v2 · Official homepage title · retained in its source language

