agent-recipes 0.0.5__py3-none-any.whl

agent_recipes/templates/shorts-generator/README.md

@@ -0,0 +1,61 @@
+# Shorts Generator
+
+Generate short-form video clips from long videos for social media platforms.
+
+## Features
+
+- **Multi-platform support**: TikTok, YouTube Shorts, Instagram Reels
+- **AI content analysis**: Identifies viral-worthy moments
+- **Auto-captioning**: Platform-optimized captions
+- **Multiple aspect ratios**: 9:16, 1:1, 16:9
+
+## Requirements
+
+- `OPENAI_API_KEY` environment variable
+- Optional: `moviepy`, `pillow` for video processing
+
+## Usage
+
+### CLI
+
+```bash
+# Basic usage
+praisonai run shorts-generator ./video.mp4
+
+# Custom settings
+praisonai run shorts-generator ./video.mp4 --duration 30 --clips 5
+
+# Different aspect ratio
+praisonai run shorts-generator ./video.mp4 --aspect 1:1
+```
+
+### Python API
+
+```python
+from praisonaiagents import Workflow
+
+workflow = Workflow.from_template(
+    "shorts-generator",
+    config={
+        "input": "./video.mp4",
+        "duration": 45,
+        "num_clips": 5,
+        "caption_style": "bold"
+    }
+)
+result = workflow.run()
+```
+
+## Configuration
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `input` | string | required | Video file path or YouTube URL |
+| `duration` | integer | 60 | Target clip duration (15-90 seconds) |
+| `aspect_ratio` | string | "9:16" | Aspect ratio: 9:16, 1:1, 16:9 |
+| `caption_style` | string | "modern" | Caption style: modern, classic, minimal, bold |
+| `num_clips` | integer | 3 | Number of clips to generate |
+
+## License
+
+Apache-2.0

agent_recipes/templates/shorts-generator/TEMPLATE.yaml

@@ -0,0 +1,65 @@
+name: shorts-generator
+version: "1.0.0"
+description: Generate short-form video clips from long videos for social media
+author: praisonai
+license: Apache-2.0
+tags: [video, shorts, clips, social-media, tiktok, youtube-shorts, reels]
+
+requires:
+  tools: [youtube_tool]
+  packages: [moviepy, pillow]
+  env: [OPENAI_API_KEY]
+
+workflow: workflow.yaml
+agents: agents.yaml
+
+config:
+  input:
+    type: string
+    required: true
+    description: Video file path or YouTube URL
+  duration:
+    type: integer
+    default: 60
+    description: Target clip duration in seconds (15-90)
+  aspect_ratio:
+    type: string
+    default: "9:16"
+    enum: ["9:16", "1:1", "16:9"]
+  caption_style:
+    type: string
+    default: "modern"
+    enum: [modern, classic, minimal, bold]
+  num_clips:
+    type: integer
+    default: 3
+    description: Number of clips to generate
+
+defaults:
+  duration: 60
+  aspect_ratio: "9:16"
+  caption_style: modern
+  num_clips: 3
+
+cli:
+  command: shorts
+  args:
+    - name: input
+      positional: true
+      description: Video file path or YouTube URL
+    - name: --duration
+      default: 60
+      description: Target clip duration in seconds
+    - name: --aspect
+      default: "9:16"
+      description: Aspect ratio (9:16, 1:1, 16:9)
+    - name: --style
+      default: modern
+      description: Caption style
+    - name: --clips
+      default: 3
+      description: Number of clips to generate
+  examples:
+    - praisonai run shorts-generator ./video.mp4
+    - praisonai run shorts-generator ./video.mp4 --duration 30 --clips 5
+    - praisonai run shorts-generator "https://youtube.com/watch?v=xxx" --aspect 1:1

agent_recipes/templates/shorts-generator/agents.yaml

@@ -0,0 +1,66 @@
+agents:
+  analyzer:
+    name: ContentAnalyzer
+    role: Video Content Analyst
+    goal: Identify engaging moments for short clips
+    backstory: |
+      I am an expert at analyzing video content for viral potential.
+      I understand what makes content engaging on social media platforms
+      and can identify the most shareable moments in any video.
+    instructions: |
+      Analyze video transcript and identify:
+      1. Hook moments (first 3 seconds grabbers)
+      2. Key insights or memorable quotes
+      3. Emotional peaks and reactions
+      4. Call-to-action opportunities
+      5. Viral-worthy segments
+    tools: [youtube_tool]
+    verbose: true
+
+  clipper:
+    name: VideoClipper
+    role: Video Editor
+    goal: Extract and format video clips
+    backstory: |
+      I am a professional video editor specializing in short-form content.
+      I know how to cut videos for maximum impact while maintaining
+      proper pacing and visual quality.
+    instructions: |
+      Extract clips from the video:
+      - Include 1-2 second buffer at start/end
+      - Ensure clean cuts at natural breaks
+      - Maintain audio sync
+      - Apply aspect ratio cropping
+    verbose: true
+
+  captioner:
+    name: Captioner
+    role: Caption Designer
+    goal: Generate engaging captions for clips
+    backstory: |
+      I specialize in creating captions that boost engagement and
+      accessibility. I understand platform-specific caption styles
+      and what makes text readable on mobile screens.
+    instructions: |
+      Create captions for each clip:
+      - Readable in 2-3 seconds per line
+      - Include relevant emoji where appropriate
+      - Hook viewers in first line
+      - End with engagement prompt
+    verbose: true
+
+  optimizer:
+    name: PlatformOptimizer
+    role: Social Media Specialist
+    goal: Optimize clips for platform requirements
+    backstory: |
+      I am a social media expert who understands the algorithms and
+      best practices for TikTok, YouTube Shorts, and Instagram Reels.
+      I know how to maximize reach and engagement.
+    instructions: |
+      Optimize each clip for social media:
+      - Add trending hashtags
+      - Suggest posting times
+      - Create thumbnail recommendations
+      - Write platform-specific descriptions
+    verbose: true

agent_recipes/templates/shorts-generator/workflow.yaml

@@ -0,0 +1,86 @@
+name: Shorts Generator
+description: Generate short-form video clips from long videos
+
+workflow:
+  verbose: true
+  stream: true
+
+variables:
+  input: "{{input}}"
+  duration: "{{duration}}"
+  aspect_ratio: "{{aspect_ratio}}"
+  caption_style: "{{caption_style}}"
+  num_clips: "{{num_clips}}"
+
+agents:
+  analyzer:
+    name: ContentAnalyzer
+    role: Video Content Analyst
+    goal: Identify engaging moments for short clips
+    instructions: |
+      Analyze video transcript and identify:
+      1. Hook moments (first 3 seconds grabbers)
+      2. Key insights or memorable quotes
+      3. Emotional peaks and reactions
+      4. Call-to-action opportunities
+      5. Viral-worthy segments
+      Return timestamps and descriptions for {{num_clips}} best moments.
+    tools: [youtube_tool]
+
+  clipper:
+    name: VideoClipper
+    role: Video Editor
+    goal: Extract and format video clips
+    instructions: |
+      Extract clips from the video:
+      - Target duration: {{duration}} seconds
+      - Aspect ratio: {{aspect_ratio}}
+      - Include 1-2 second buffer at start/end
+      - Ensure clean cuts at natural breaks
+
+  captioner:
+    name: Captioner
+    role: Caption Designer
+    goal: Generate engaging captions for clips
+    instructions: |
+      Create captions for each clip:
+      - Style: {{caption_style}}
+      - Readable in 2-3 seconds per line
+      - Include relevant emoji where appropriate
+      - Hook viewers in first line
+      - End with engagement prompt
+
+  optimizer:
+    name: PlatformOptimizer
+    role: Social Media Specialist
+    goal: Optimize clips for platform requirements
+    instructions: |
+      Optimize each clip for social media:
+      - Add trending hashtags
+      - Suggest posting times
+      - Create thumbnail recommendations
+      - Write platform-specific descriptions
+
+steps:
+  - name: analyze
+    agent: analyzer
+    action: "Analyze video and identify {{num_clips}} best moments: {{input}}"
+    output_variable: moments
+    
+  - name: extract
+    agent: clipper
+    action: "Extract clips at identified timestamps"
+    context_from: [analyze]
+    output_variable: clips
+    
+  - name: caption
+    agent: captioner
+    action: "Generate captions for each clip"
+    context_from: [extract]
+    output_variable: captioned_clips
+    
+  - name: optimize
+    agent: optimizer
+    action: "Optimize clips for social media platforms"
+    context_from: [caption]
+    output_variable: final_clips

agent_recipes/templates/transcript-generator/README.md

@@ -0,0 +1,103 @@
+# Transcript Generator
+
+Generate transcripts from audio/video files using AI speech recognition.
+
+## Features
+
+- **Multi-source input**: Local files or YouTube URLs
+- **Language detection**: Automatic or specify language
+- **Multiple output formats**: TXT, SRT, VTT, JSON
+- **AI cleanup**: Optional LLM-powered transcript cleanup
+
+## Requirements
+
+- `OPENAI_API_KEY` environment variable
+- Optional: `youtube_tool` for YouTube URL support
+
+## Usage
+
+### CLI
+
+```bash
+# Basic usage
+praisonai run transcript-generator ./audio.mp3
+
+# With format
+praisonai run transcript-generator ./video.mp4 --format srt
+
+# YouTube URL
+praisonai run transcript-generator "https://youtube.com/watch?v=xxx" --language en
+
+# Skip cleanup
+praisonai run transcript-generator ./audio.mp3 --no-cleanup
+```
+
+### Python API
+
+```python
+from praisonaiagents import Workflow
+
+# Load and run template
+workflow = Workflow.from_template(
+    "transcript-generator",
+    config={
+        "input": "./audio.mp3",
+        "output_format": "srt",
+        "language": "en"
+    }
+)
+result = workflow.run()
+print(result["output"])
+```
+
+## Configuration
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `input` | string | required | Audio/video file path or YouTube URL |
+| `output_format` | string | "txt" | Output format: txt, srt, vtt, json |
+| `language` | string | "auto" | Language code or 'auto' for detection |
+| `cleanup` | boolean | true | Apply LLM cleanup for readability |
+
+## Output Formats
+
+### TXT
+Plain text with paragraphs.
+
+### SRT (SubRip)
+```
+1
+00:00:00,000 --> 00:00:05,000
+First line of transcript.
+
+2
+00:00:05,000 --> 00:00:10,000
+Second line of transcript.
+```
+
+### VTT (WebVTT)
+```
+WEBVTT
+
+00:00:00.000 --> 00:00:05.000
+First line of transcript.
+
+00:00:05.000 --> 00:00:10.000
+Second line of transcript.
+```
+
+### JSON
+```json
+{
+  "segments": [
+    {"start": 0.0, "end": 5.0, "text": "First line"},
+    {"start": 5.0, "end": 10.0, "text": "Second line"}
+  ],
+  "language": "en",
+  "duration": 10.0
+}
+```
+
+## License
+
+Apache-2.0

agent_recipes/templates/transcript-generator/TEMPLATE.yaml

@@ -0,0 +1,57 @@
+name: transcript-generator
+version: "1.0.0"
+description: Generate transcripts from audio/video files using AI speech recognition
+author: praisonai
+license: Apache-2.0
+tags: [audio, video, transcript, speech-to-text, whisper]
+
+requires:
+  tools: [youtube_tool]
+  packages: [openai]
+  env: [OPENAI_API_KEY]
+
+workflow: workflow.yaml
+agents: agents.yaml
+
+config:
+  input:
+    type: string
+    required: true
+    description: Path to audio/video file or YouTube URL
+  output_format:
+    type: string
+    default: "txt"
+    enum: [txt, srt, vtt, json]
+  language:
+    type: string
+    default: "auto"
+    description: Language code (e.g., en, es, fr) or 'auto' for detection
+  cleanup:
+    type: boolean
+    default: true
+    description: Apply LLM cleanup for readability
+
+defaults:
+  output_format: txt
+  language: auto
+  cleanup: true
+
+cli:
+  command: transcript
+  args:
+    - name: input
+      positional: true
+      description: Audio/video file path or YouTube URL
+    - name: --format
+      default: txt
+      description: Output format (txt, srt, vtt, json)
+    - name: --language
+      default: auto
+      description: Language code or 'auto'
+    - name: --no-cleanup
+      flag: true
+      description: Skip LLM cleanup step
+  examples:
+    - praisonai run transcript-generator ./audio.mp3
+    - praisonai run transcript-generator ./video.mp4 --format srt
+    - praisonai run transcript-generator "https://youtube.com/watch?v=xxx" --language en

agent_recipes/templates/transcript-generator/agents.yaml

@@ -0,0 +1,62 @@
+agents:
+  ingester:
+    name: MediaIngester
+    role: Media Handler
+    goal: Download or load media files for processing
+    backstory: |
+      I am an expert at handling various media formats and sources.
+      I can download from YouTube, process local files, and prepare
+      audio for transcription.
+    instructions: |
+      Handle media input:
+      - If YouTube URL, extract audio using youtube_tool
+      - If local file, verify it exists and is accessible
+      - Return the path to the audio file ready for transcription
+    tools: [youtube_tool]
+    verbose: true
+
+  transcriber:
+    name: Transcriber
+    role: Speech Recognition Specialist
+    goal: Convert audio to text using AI speech recognition
+    backstory: |
+      I specialize in converting spoken audio to accurate text.
+      I use state-of-the-art AI models to transcribe speech with
+      high accuracy across multiple languages.
+    instructions: |
+      Transcribe the audio file:
+      - Use OpenAI Whisper API for transcription
+      - Detect language automatically if not specified
+      - Return raw transcript text with timestamps if available
+    verbose: true
+
+  editor:
+    name: TranscriptEditor
+    role: Content Editor
+    goal: Clean up and format the transcript for readability
+    backstory: |
+      I am a professional editor who specializes in making transcripts
+      readable while preserving the original meaning and intent.
+    instructions: |
+      Clean up the transcript:
+      - Fix punctuation and capitalization
+      - Add paragraph breaks at natural pauses
+      - Remove filler words (um, uh, like)
+      - Preserve speaker intent and meaning
+      - Do NOT change the actual content or meaning
+    verbose: true
+
+  exporter:
+    name: FormatExporter
+    role: Format Specialist
+    goal: Export transcript in the requested format
+    backstory: |
+      I am an expert at formatting text into various standard formats
+      including plain text, subtitles, and structured data.
+    instructions: |
+      Export the transcript in the requested format:
+      - txt: Plain text with paragraphs
+      - srt: SubRip subtitle format with timestamps
+      - vtt: WebVTT format with timestamps
+      - json: Structured JSON with segments and metadata
+    verbose: true

agent_recipes/templates/transcript-generator/workflow.yaml

@@ -0,0 +1,82 @@
+name: Transcript Generator
+description: Generate transcripts from audio/video files
+
+workflow:
+  verbose: true
+  stream: true
+
+variables:
+  input: "{{input}}"
+  output_format: "{{output_format}}"
+  language: "{{language}}"
+  cleanup: "{{cleanup}}"
+
+agents:
+  ingester:
+    name: MediaIngester
+    role: Media Handler
+    goal: Download or load media files for processing
+    instructions: |
+      Handle media input:
+      - If YouTube URL, extract audio using youtube_tool
+      - If local file, verify it exists and is accessible
+      - Return the path to the audio file ready for transcription
+    tools: [youtube_tool]
+
+  transcriber:
+    name: Transcriber
+    role: Speech Recognition Specialist
+    goal: Convert audio to text using AI speech recognition
+    instructions: |
+      Transcribe the audio file:
+      - Use OpenAI Whisper API for transcription
+      - Detect language automatically if not specified
+      - Return raw transcript text with timestamps if available
+
+  editor:
+    name: TranscriptEditor
+    role: Content Editor
+    goal: Clean up and format the transcript for readability
+    instructions: |
+      Clean up the transcript:
+      - Fix punctuation and capitalization
+      - Add paragraph breaks at natural pauses
+      - Remove filler words (um, uh, like)
+      - Preserve speaker intent and meaning
+      - Do NOT change the actual content or meaning
+
+  exporter:
+    name: FormatExporter
+    role: Format Specialist
+    goal: Export transcript in the requested format
+    instructions: |
+      Export the transcript in {{output_format}} format:
+      - txt: Plain text with paragraphs
+      - srt: SubRip subtitle format with timestamps
+      - vtt: WebVTT format with timestamps
+      - json: Structured JSON with segments and metadata
+
+steps:
+  - name: ingest
+    agent: ingester
+    action: "Load or download media from: {{input}}"
+    output_variable: media_path
+    
+  - name: transcribe
+    agent: transcriber
+    action: "Transcribe audio file. Language: {{language}}"
+    context_from: [ingest]
+    output_variable: raw_transcript
+    
+  - name: cleanup
+    agent: editor
+    action: "Clean up transcript for readability"
+    context_from: [transcribe]
+    condition: "{{cleanup}}"
+    output_variable: clean_transcript
+    
+  - name: export
+    agent: exporter
+    action: "Export to {{output_format}} format"
+    context_from: [cleanup, transcribe]
+    output_variable: final_output

agent_recipes/templates/video-editor/README.md

@@ -0,0 +1,70 @@
+# Video Editor
+
+AI-powered video editing with natural language commands.
+
+## Features
+
+- **Natural language editing**: Describe edits in plain English
+- **Multiple operations**: Trim, effects, audio, text overlays
+- **Preview mode**: Generate low-res preview before final render
+- **Quality assurance**: Automatic QC checks
+
+## Requirements
+
+- `OPENAI_API_KEY` environment variable
+- Optional: `moviepy`, `ffmpeg-python` for video processing
+- `ffmpeg` installed on system
+
+## Usage
+
+### CLI
+
+```bash
+# Basic editing
+praisonai run video-editor ./raw.mp4 -o ./final.mp4 -i "Trim first 10s, add fade in"
+
+# Speed change
+praisonai run video-editor ./video.mp4 -i "Speed up 1.5x, add background music"
+
+# Text overlay
+praisonai run video-editor ./clip.mp4 -i "Add text 'Hello World' at center"
+```
+
+### Python API
+
+```python
+from praisonaiagents import Workflow
+
+workflow = Workflow.from_template(
+    "video-editor",
+    config={
+        "input": "./raw.mp4",
+        "output": "./final.mp4",
+        "instructions": "Trim first 10 seconds, add fade in and out",
+        "preview": True
+    }
+)
+result = workflow.run()
+```
+
+## Supported Operations
+
+- **Trim/Cut**: Remove sections, extract clips
+- **Speed**: Speed up, slow down, reverse
+- **Effects**: Fade, blur, color correction, filters
+- **Audio**: Volume, mute, add music, extract audio
+- **Text**: Overlays, subtitles, watermarks
+- **Transitions**: Cross-fade, wipe, dissolve
+
+## Configuration
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `input` | string | required | Input video file path |
+| `output` | string | auto | Output video file path |
+| `instructions` | string | required | Natural language editing instructions |
+| `preview` | boolean | true | Generate preview before final render |
+
+## License
+
+Apache-2.0