General
PromptBeginner5 minmarkdown
2. Apply Deepthink Protocol (reason about dependencies
risks
16
Sign in to like and favorite skills
Sign in to like and favorite skills
This document describes each AI agent in the Film Agent system.
The system uses 6 specialized AI agents that work together autonomously:
src.agents.director_agent.DirectorAgentThe Director Agent is the orchestrator of the entire film production pipeline.
__init__(self)Initializes all agent dependencies.
interpret_concept(self, prompt: str) -> DictTransforms user concept into a cohesive creative vision.
Parameters:
promptReturns:
{ "vision": "Creative vision statement", "style": "cinematic", "genre": "drama", "target_duration": "5 minutes" }
coordinate_agents(self, vision: Dict) -> DictOrchestrates the workflow of all agents.
Parameters:
visioninterpret_concept()Returns:
{ "script": {...}, "shots": [...], "audio": {...}, "effects": [...] }
review_output(self, output: Dict) -> DictEvaluates and approves final output from other agents.
Parameters:
outputReturns:
{ "approved": True, "feedback": "Output meets quality standards", "revisions_needed": [] }
make_artistic_decisions(self, context: Dict) -> DictMakes high-level artistic decisions autonomously.
Parameters:
contextReturns:
{ "color_grading": "warm", "pacing": "moderate", "mood": "neutral" }
src.agents.screenwriter_agent.ScreenwriterAgentThe Screenwriter Agent writes complete scripts with dialogue and scene descriptions.
__init__(self)Initializes the screenwriter agent.
generate(self, prompt: str, genre: str = "drama", length: str = "short") -> DictGenerates a complete film script from a user prompt.
Parameters:
promptgenrelengthReturns:
{ "title": "Untitled Film", "scenes": [], "characters": [], "dialogue": [], "structure": { "act1": "Setup", "act2": "Confrontation", "act3": "Resolution" } }
develop_character(self, name: str, traits: List[str]) -> DictCreates a detailed character profile.
Parameters:
nametraitsReturns:
{ "name": "Character Name", "backstory": "Character history", "motivations": ["goal1", "goal2"], "arc": "transformation" }
structure_narrative(self, events: List[Dict]) -> DictOrganizes story events into a three-act structure.
Parameters:
eventsReturns:
{ "act1": {"setup": [...], "inciting_incident": [...]}, "act2": {"rising_action": [...], "midpoint": [...]}, "act3": {"climax": [...], "resolution": [...]} }
write_dialogue(self, character: str, context: str) -> strGenerates dialogue for a character in a specific context.
Parameters:
charactercontextReturns:
"[Character]: Generated dialogue"
revise(self, script: Dict, feedback: str) -> DictImproves script based on director feedback.
Parameters:
scriptfeedbackReturns:
{...} # Revised script
src.agents.cinematographer_agent.CinematographerAgentThe Cinematographer Agent plans camera angles, movements, and compositions.
__init__(self)Initializes the cinematographer agent.
plan_shots(self, script: Dict) -> List[Dict]Creates a shot list from the script.
Parameters:
scriptReturns:
[ { "shot_type": "wide", "camera_movement": "static", "composition": "establishing", "duration": 5.0 } ]
design_lighting(self, scene: Dict) -> DictPlans lighting setup for a scene.
Parameters:
sceneReturns:
{ "key_light": {"position": "45 degrees", "intensity": "100%"}, "fill_light": {"position": "opposite", "intensity": "50%"}, "back_light": {"position": "behind subject", "intensity": "70%"}, "mood": "dramatic" }
compose_frame(self, shot_type: str, subject: str) -> DictDesigns camera composition for a shot.
Parameters:
shot_typesubjectReturns:
{ "rule_of_thirds": {"x": 1/3, "y": 1/2}, "headroom": "moderate", "look_room": "left", "depth": "shallow" }
create_shot_list(self, script: Dict) -> DictGenerates detailed shot breakdown.
Parameters:
scriptReturns:
{ "scenes": [...], "total_shots": 0, "est_duration": 0 }
ensure_continuity(self, shots: List[Dict]) -> boolVerifies visual continuity across shots.
Parameters:
shotsReturns:
True # or False if issues found
src.agents.editor_agent.EditorAgentThe Editor Agent assembles scenes into cohesive narrative.
__init__(self)Initializes the editor agent.
assemble(self, scenes: List[Dict], audio: Dict) -> DictCombines scenes and audio into final assembly.
Parameters:
scenesaudioReturns:
{ "timeline": [...], "duration": 0.0, "cuts": [...] }
determine_pacing(self, script: Dict) -> DictSets optimal timing and rhythm for scenes.
Parameters:
scriptReturns:
{ "tempo": "moderate", "timing": {...}, "rhythm": "steady" }
apply_transitions(self, timeline: Dict) -> DictAdds transitions between scenes.
Parameters:
timelineReturns:
{...} # Updated timeline
make_cut_decisions(self, shots: List[Dict]) -> List[Dict]Determines optimal cut points between shots.
Parameters:
shotsReturns:
[...] # Selected cuts
export_final(self, assembly: Dict, format: str = "mp4") -> DictRenders and exports the final video.
Parameters:
assemblyformatReturns:
{ "file_path": "output/video.mp4", "format": "mp4", "resolution": "1920x1080" }
src.agents.sound_designer_agent.SoundDesignerAgentThe Sound Designer Agent creates immersive audio experiences.
__init__(self)Initializes the sound designer agent.
design_music(self, script: Dict) -> DictSelects or generates background music for the film.
Parameters:
scriptReturns:
{ "score": [...], "mood": "neutral", "tempo": 120, "duration": 0.0 }
create_soundscape(self, scene: Dict) -> DictBuilds ambient audio environment for a scene.
Parameters:
sceneReturns:
{ "ambient": [...], "foley": [...], "spatial": "stereo" }
mix_audio(self, tracks: List[Dict]) -> DictBalances and mixes multiple audio tracks.
Parameters:
tracksReturns:
{ "levels": {...}, "master": {"volume": 0.8}, "dynamics": {"compression": True} }
sync_to_video(self, audio: Dict, video: Dict) -> DictSynchronizes audio with visual beats and cuts.
Parameters:
audiovideoReturns:
{...} # Synced audio
generate_voiceover(self, script: Dict, voice: str = "default") -> DictCreates voice narration for the film.
Parameters:
scriptvoiceReturns:
{ "audio": None, "timing": [...], "subtitles": [...] }
src.agents.vfx_agent.VFXAgentThe VFX Agent applies visual effects and color grading.
__init__(self)Initializes the VFX agent.
identify_enhancements(self, shots: List[Dict]) -> List[Dict]Finds opportunities for visual enhancement.
Parameters:
shotsReturns:
[ { "shot": 0, "suggestion": "color_grading", "priority": "high" } ]
apply_color_grading(self, shot: Dict) -> DictAdjusts color and contrast for visual consistency.
Parameters:
shotReturns:
{ "lut": "cinematic", "adjustments": { "contrast": 1.1, "saturation": 1.0, "temperature": 0 }, "mood": "warm" }
integrate_cgi(self, shot: Dict) -> DictAdds CGI elements to a shot.
Parameters:
shotReturns:
{ "elements": [...], "lighting": {...}, "blending": "normal" }
ensure_quality(self, video: Dict) -> DictTechnical quality check for final output.
Parameters:
videoReturns:
{ "issues": [], "passed": True, "recommendations": [] }
render_effects(self, shots: List[Dict]) -> List[Dict]Applies all VFX to shots.
Parameters:
shotsReturns:
[...] # Shots with effects
Parameters:
sceneReturns:
{ "ambient": [...], "foley": [...], "spatial": "stereo" }
mix_audio(self, tracks: List[Dict]) -> DictBalances and mixes multiple audio tracks.
Parameters:
tracksReturns:
{ "levels": {...}, "master": {"volume": 0.8}, "dynamics": {"compression": True} }
sync_to_video(self, audio: Dict, video: Dict) -> DictSynchronizes audio with visual beats and cuts.
Parameters:
audiovideoReturns:
{...} # Synced audio
generate_voiceover(self, script: Dict, voice: str = "default") -> DictCreates voice narration for the film.
Parameters:
scriptvoiceReturns:
{ "audio": None, "timing": [...], "subtitles": [...] }
src.agents.vfx_agent.VFXAgentThe VFX Agent applies visual effects and color grading.
__init__(self)Initializes the VFX agent.
identify_enhancements(self, shots: List[Dict]) -> List[Dict]Finds opportunities for visual enhancement.
Parameters:
shotsReturns:
[ { "shot": 0, "suggestion": "color_grading", "priority": "high" } ]
apply_color_grading(self, shot: Dict) -> DictAdjusts color and contrast for visual consistency.
Parameters:
shotReturns:
{ "lut": "cinematic", "adjustments": { "contrast": 1.1, "saturation": 1.0, "temperature": 0 }, "mood": "warm" }
integrate_cgi(self, shot: Dict) -> DictAdds CGI elements to a shot.
Parameters:
shotReturns:
{ "elements": [...], "lighting": {...}, "blending": "normal" }
ensure_quality(self, video: Dict) -> DictTechnical quality check for final output.
Parameters:
videoReturns:
{ "issues": [], "passed": True, "recommendations": [] }
render_effects(self, shots: List[Dict]) -> List[Dict]Applies all VFX to shots.
Parameters:
shotsReturns:
[...] # Shots with effects
Initializes the VFX agent.
identify_enhancements(self, shots: List[Dict]) -> List[Dict]Finds opportunities for visual enhancement.
Parameters:
shotsReturns:
[ { "shot": 0, "suggestion": "color_grading", "priority": "high" } ]
apply_color_grading(self, shot: Dict) -> DictAdjusts color and contrast for visual consistency.
Parameters:
shotReturns:
{ "lut": "cinematic", "adjustments": { "contrast": 1.1, "saturation": 1.0, "temperature": 0 }, "mood": "warm" }
integrate_cgi(self, shot: Dict) -> DictAdds CGI elements to a shot.
Parameters:
shotReturns:
{ "elements": [...], "lighting": {...}, "blending": "normal" }
ensure_quality(self, video: Dict) -> DictTechnical quality check for final output.
Parameters:
videoReturns:
{ "issues": [], "passed": True, "recommendations": [] }
render_effects(self, shots: List[Dict]) -> List[Dict]Applies all VFX to shots.
Parameters:
shotsReturns:
[...] # Shots with effects