How jaybaradd/screenplay works
This is a local, single-user studio for turning screenplay text into a human-approved cultural adaptation and production-ready visual assets. Its main path runs from project setup and scene extraction through continuity control, cultural research and planning, screenplay adaptation, visual production, sequential scene generation, and export. The README documents the workflow gates and major visual, audit, and export capabilities; sampled source and the SOURCE INDEX support the API, workflow, provider, persistence, and culture components. Some detailed stage-to-stage implementation links are documented rather than visible in the excerpts.
Main entry points: workflow.py LangGraph engine · api.py FastAPI · pages Streamlit screens · providers.py AI provider
Components 24
Studio experience
- Streamlit screens
frontend/pages - FastAPI
backend/api.py
Adaptation workflow
- Project setup
backend/api.py - Scene extraction
backend/services.py - Six-layer plan
backend/workflow.py - Screenplay adaptation
backend/services.py - LangGraph engine
backend/workflow.py
Culture and continuity
- Continuity control
backend/continuity.py - Cultural brief
backend/workflow.py - Culture profiles
backend/cultures/registry.py - Prompt context
backend/cultures/context.py
Visual production
- Visual manifest
backend/services.py - Asset generation
backend/services.py - Scene prompts
backend/services.py - Visual verification
backend/services.py - Export package
backend/services.py
Persistence and operations
- AI provider
backend/providers.py - Revision store
backend/storage.py - Workflow checkpoints
backend/workflow.py - Local assets
backend/config.py - Usage and traces
backend/observability.py
Other components
- Screenplay author
- Human reviewer
- Langfuse
Connections 27
- Screenplay author → Streamlit screens: provides screenplay
README.md - Human reviewer → Streamlit screens: reviews and approves
README.md - Streamlit screens → FastAPI: sends HTTP requests
README.md - FastAPI → Project setup: creates project
backend/api.py - FastAPI → LangGraph engine: starts and advances
backend/api.py - FastAPI → Revision store: reads and writes
backend/api.py - FastAPI → Culture profiles: lists profiles
backend/api.py - LangGraph engine → Scene extraction: runs extraction
README.md - LangGraph engine → Continuity control: checks continuity
backend/workflow.py - LangGraph engine → Cultural brief: builds brief
README.md - LangGraph engine → Six-layer plan: builds plan
README.md - LangGraph engine → Screenplay adaptation: adapts screenplay
backend/workflow.py - LangGraph engine → Visual manifest: builds manifest
backend/workflow.py - LangGraph engine → Scene prompts: compiles prompts
README.md - LangGraph engine → Asset generation: generates assets
README.md - LangGraph engine → Visual verification: requests verification
README.md - LangGraph engine → Export package: exports project
README.md - LangGraph engine → Workflow checkpoints: checkpoints state
README.md - LangGraph engine → Revision store: stores revisions
README.md - LangGraph engine → Culture profiles: uses profile snapshot
README.md - LangGraph engine → Prompt context: compiles stage context
backend/workflow.py - LangGraph engine → AI provider: requests model work
backend/workflow.py - Cultural brief → AI provider: grounds research
README.md - Asset generation → Local assets: stores image bytes
README.md - Export package → Local assets: packages images
README.md - AI provider → Usage and traces: records usage
backend/providers.py - Usage and traces → Langfuse: sends optional traces
backend/observability.py