# google-deepmind/dramatron

Dramatron uses large language models to generate coherent scripts and screenplays.

Repository: https://github.com/google-deepmind/dramatron
Canonical: https://ross.abutalabs.com/products/dramatron
Homepage: https://deepmind.github.io/dramatron
Language: Jupyter Notebook
License: Apache-2.0
License Family: permissive
Last push: 2024-07-16T23:32:16+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 97
- inputs: {"age_days": 1365, "days_push": 778, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1112, forks 178 (observed 2026-08-28T04:03:37.796847+00:00)

## What it is
Dramatron is a research tool from DeepMind that uses pre-trained large language models to hierarchically co-write theatre scripts and screenplays, generating character descriptions, plot beats, locations, and dialogue from a log line. It ships as a Colab notebook where users plug in their own LLM sampling interface.

## Use cases
- co-write screenplays with an LLM
- generate a full script from a log line
- explore hierarchical story generation
- get dialogue and character ideas as a playwright
- run an LLM creative writing demo in Colab

## When to choose
- you are a writer or researcher exploring LLM-assisted scriptwriting
- you want a hierarchical story generation pipeline you can adapt to your own LLM
- you want to reproduce the SIGCHI 2023 co-writing study setup

## When to avoid
- you want a turnkey tool with a built-in LLM - you must implement your own sampling interface
- you need fully autonomous script generation - it is designed for human co-writing
- you need a production application rather than a research prototype

## Facets
- artifact type: application
- maturity: maintenance
- function: llm-inference, nlp, prompt-engineering
- domain: large-language-models, artificial-intelligence, entertainment
- platform: python
- tags: screenwriting, story-generation, co-writing, hierarchical-generation, creative-writing, colab, natural-language-processing, web-server

## Member repositories
- google-deepmind/dramatron (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:37.796847+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:42:43.313782+00:00, confidence not recorded.
  - readme: https://github.com/google-deepmind/dramatron (fetched 2026-08-28T04:03:37.796847+00:00, sha e6c6b7b30358)
- Data as of 2026-08-30T08:39:29.467469+00:00.