AI-CineAgent-EditPack

Inspiration

Films, Scripts, Editing, Pre-Production

What it does

Takes Scripts and convert it into EditPacks

How we built it

Using java, react, etc...

Challenges we ran into

Training an LLM to think for the Film Pre-Production work

Accomplishments that we're proud of

Does the Film Pre-Production Hours of works in seconds

What we learned

How to do and handle these creative projects

What's next for AI-CineAgent-EditPack

Automating it, improving by files parsing, and using Generative AI.

CineAgent turns a raw film scene into a ready-to-shoot edit pack: a structured shot list, a timed voiceover plan, and a color grading reference — generated through three role-specialized prompts and a full-stack app you run entirely on your own machine.

No paid API keys. No database. No vendor lock-in — just a Spring Boot backend, a React frontend, and a free chat at claude.ai.

Why this exists

Pre-production paperwork — shot lists, VO scripts, color references — is repetitive and time-consuming to write by hand for every scene. Claude CineAgent automates the first draft of that paperwork by turning a script into three precision-engineered prompts, one per "agent" persona (ShotListAgent, VOEditorAgent, ColoristAgent), each with a strict output contract so the reply can be parsed back into real CSV/JSON files instead of free-form prose.

How it works

The backend never talks to any AI API — it only builds prompts. You stay in control of every call to Claude, and the project never needs a billable API key.

Features

🎬 Three specialized agents — ShotListAgent, VOEditorAgent, and ColoristAgent prompts, each tuned to your chosen genre and mood
🧾 Strict output contracts — prompts force clean CSV/JSON replies so parsing is reliable instead of fragile regex-on-prose
📋 Built-in parser — hand-rolled CSV and JSON parsers (no external parsing library) that tolerate stray markdown code fences
⬇️ One-click download — parsed results export straight to shot_list.csv, voiceover.json, and color_palette.json
🎨 Custom-themed UI — a dark, clapperboard-inspired design system built with Tailwind, distinct from default component-library styling
🔒 Zero paid dependencies — Spring Boot + React only, runs fully offline except for the manual visit to claude.ai

Quick start

Tool	Version	Check with
Java JDK	17+	`java -version`
Maven	3.9+	`mvn -version`
Node.js	18+	`node -v`

Tech stack

Layer	Choices
Backend	Java 17, Spring Boot 3.2 (Spring Web), Maven
Frontend	React 18, Vite 5, Tailwind CSS 3
Parsing	Hand-written CSV/JSON parsers in `parser.js` — no external parsing library

Roadmap

Ideas for extending this further:

[ ] Optional direct Claude API integration (bring-your-own-key) to skip the manual copy/paste step
[ ] Export an EDL-compatible shot list for NLE import
[ ] Multi-scene batch mode (paste a full script, generate per-scene packs)
[ ] Persist generated packs to a lightweight database for project history
[ ] Dark/light theme toggle

Contributions and forks are welcome — open an issue or a PR.