agent-recipes 0.0.5__py3-none-any.whl

agent_recipes/templates/ai-video-highlight-extractor/README.md

@@ -0,0 +1,60 @@
+# Video Highlight Extractor
+
+Auto-detect and extract key moments/highlights from long videos
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-video-highlight-extractor <input>
+
+# With output directory
+praison recipes run ai-video-highlight-extractor <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-video-highlight-extractor <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-video-highlight-extractor
+
+# Check dependencies
+praison recipes doctor ai-video-highlight-extractor
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-video-highlight-extractor")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- ffmpeg-python
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- ffmpeg
+
+## Tags
+
+`video`, `highlights`, `extraction`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-video-highlight-extractor/TEMPLATE.yaml

@@ -0,0 +1,33 @@
+name: ai-video-highlight-extractor
+version: "1.0.0"
+description: Auto-detect and extract key moments/highlights from long videos
+author: praison
+license: Apache-2.0
+tags:
+  - video
+  - highlights
+  - extraction
+
+requires:
+  tools:
+    - media_tool
+    - whisper_tool
+    - llm_tool
+  packages:
+    - ffmpeg-python
+    - openai
+  env:
+    - OPENAI_API_KEY
+  external:
+    - ffmpeg
+
+cli:
+  command: praison recipes run ai-video-highlight-extractor
+  examples:
+    - praison recipes run ai-video-highlight-extractor <input>
+    - praison recipes run ai-video-highlight-extractor <input> --output ./output/
+    - praison recipes run ai-video-highlight-extractor <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true

agent_recipes/templates/ai-video-merger/recipe.yaml

@@ -0,0 +1,40 @@
+name: ai-video-merger
+version: 1.0.0
+description: Merge voice audio with video, sync audio and video tracks
+author: PraisonAI
+tags:
+  - video
+  - audio
+  - merge
+  - sync
+
+config:
+  output_format: mp4
+  audio_sync: true
+  normalize_audio: true
+
+input:
+  type: object
+  properties:
+    video_path:
+      type: string
+    audio_path:
+      type: string
+
+output:
+  type: object
+  properties:
+    merged_path:
+      type: string
+
+requires:
+  external:
+    - ffmpeg
+
+workflow:
+  agents:
+    - name: merger
+      role: Video Audio Merger
+      tools:
+        - merge_audio_video
+        - sync_tracks

agent_recipes/templates/ai-video-merger/tools.py

@@ -0,0 +1,172 @@
+"""
+AI Video Merger Tools
+
+Merge and sync audio with video:
+- Audio/video merging
+- Track synchronization
+- Audio normalization
+"""
+
+import logging
+import os
+import subprocess
+from datetime import datetime
+from typing import Any, Dict, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def merge_audio_video(
+    video_path: str,
+    audio_path: str,
+    output_path: Optional[str] = None,
+    replace_audio: bool = True,
+    normalize: bool = True,
+) -> Dict[str, Any]:
+    """
+    Merge audio track with video.
+    
+    Args:
+        video_path: Path to video file
+        audio_path: Path to audio file
+        output_path: Output file path
+        replace_audio: Replace existing audio
+        normalize: Normalize audio levels
+        
+    Returns:
+        Dictionary with output info
+    """
+    if not os.path.exists(video_path):
+        return {"error": f"Video not found: {video_path}"}
+    if not os.path.exists(audio_path):
+        return {"error": f"Audio not found: {audio_path}"}
+    
+    if not output_path:
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_path = f"merged_{timestamp}.mp4"
+    
+    try:
+        if replace_audio:
+            # Replace audio entirely
+            cmd = [
+                "ffmpeg", "-y",
+                "-i", video_path,
+                "-i", audio_path,
+                "-c:v", "copy",
+                "-c:a", "aac",
+                "-map", "0:v:0",
+                "-map", "1:a:0",
+                "-shortest",
+                output_path
+            ]
+        else:
+            # Mix audio tracks
+            cmd = [
+                "ffmpeg", "-y",
+                "-i", video_path,
+                "-i", audio_path,
+                "-filter_complex", "[0:a][1:a]amix=inputs=2:duration=first[a]",
+                "-c:v", "copy",
+                "-map", "0:v:0",
+                "-map", "[a]",
+                output_path
+            ]
+        
+        result = subprocess.run(cmd, capture_output=True, text=True)
+        
+        if result.returncode != 0:
+            logger.warning(f"FFmpeg stderr: {result.stderr}")
+        
+        if os.path.exists(output_path):
+            return {
+                "path": output_path,
+                "video_source": video_path,
+                "audio_source": audio_path,
+                "size_bytes": os.path.getsize(output_path),
+            }
+        else:
+            return {"error": "Output file not created"}
+        
+    except Exception as e:
+        logger.error(f"Error merging: {e}")
+        return {"error": str(e)}
+
+
+def sync_tracks(
+    video_path: str,
+    audio_path: str,
+    output_path: Optional[str] = None,
+    audio_offset: float = 0.0,
+) -> Dict[str, Any]:
+    """
+    Sync audio track with video with offset adjustment.
+    
+    Args:
+        video_path: Path to video file
+        audio_path: Path to audio file
+        output_path: Output file path
+        audio_offset: Audio offset in seconds (positive = delay audio)
+        
+    Returns:
+        Dictionary with output info
+    """
+    if not output_path:
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_path = f"synced_{timestamp}.mp4"
+    
+    try:
+        if audio_offset >= 0:
+            # Delay audio
+            cmd = [
+                "ffmpeg", "-y",
+                "-i", video_path,
+                "-itsoffset", str(audio_offset),
+                "-i", audio_path,
+                "-c:v", "copy",
+                "-c:a", "aac",
+                "-map", "0:v:0",
+                "-map", "1:a:0",
+                "-shortest",
+                output_path
+            ]
+        else:
+            # Delay video (advance audio)
+            cmd = [
+                "ffmpeg", "-y",
+                "-itsoffset", str(-audio_offset),
+                "-i", video_path,
+                "-i", audio_path,
+                "-c:v", "copy",
+                "-c:a", "aac",
+                "-map", "0:v:0",
+                "-map", "1:a:0",
+                "-shortest",
+                output_path
+            ]
+        
+        subprocess.run(cmd, capture_output=True, check=True)
+        
+        return {
+            "path": output_path,
+            "audio_offset": audio_offset,
+        }
+        
+    except Exception as e:
+        logger.error(f"Error syncing: {e}")
+        return {"error": str(e)}
+
+
+def get_duration(file_path: str) -> float:
+    """Get duration of audio/video file in seconds."""
+    try:
+        cmd = [
+            "ffprobe",
+            "-v", "error",
+            "-show_entries", "format=duration",
+            "-of", "default=noprint_wrappers=1:nokey=1",
+            file_path
+        ]
+        result = subprocess.run(cmd, capture_output=True, text=True, check=True)
+        return float(result.stdout.strip())
+    except Exception:
+        return 0.0

agent_recipes/templates/ai-video-thumbnails/README.md

@@ -0,0 +1,16 @@
+# AI Video Thumbnails
+
+Extract thumbnails from video with AI-selected best frame.
+
+## Usage
+```bash
+praison run ai-video-thumbnails video.mp4
+praison run ai-video-thumbnails video.mp4 --count 10
+praison run ai-video-thumbnails video.mp4 --interval 30
+```
+
+## Output
+- `thumbnails/` - Extracted frames
+- `best-frame.jpg` - AI-selected best thumbnail
+- `grid.jpg` - Contact sheet
+- `frames.json` - Frame metadata

agent_recipes/templates/ai-video-thumbnails/TEMPLATE.yaml

@@ -0,0 +1,53 @@
+name: ai-video-thumbnails
+version: "1.0.0"
+description: Extract thumbnails from video with AI-selected best frame.
+author: praisonai
+license: Apache-2.0
+tags: [video, thumbnails, frames, extraction]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools]
+  env: [OPENAI_API_KEY]
+  external:
+    - name: ffmpeg
+      check: "ffmpeg -version"
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  interval:
+    type: number
+    default: 10
+  count:
+    type: integer
+
+cli:
+  command: ai-video-thumbnails
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --interval
+      default: "10"
+    - name: --count
+  examples:
+    - "praison run ai-video-thumbnails video.mp4"
+    - "praison run ai-video-thumbnails video.mp4 --count 10"
+
+outputs:
+  - name: thumbnails/
+    type: directory
+  - name: best-frame.jpg
+    type: file
+  - name: grid.jpg
+    type: file
+  - name: frames.json
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-video-to-gif/README.md

@@ -0,0 +1,14 @@
+# AI Video to GIF
+
+Convert video to optimized GIF with palette optimization.
+
+## Usage
+```bash
+praison run ai-video-to-gif video.mp4
+praison run ai-video-to-gif video.mp4 --start 10 --duration 3 --fps 15
+```
+
+## Output
+- `output.gif` - Optimized GIF
+- `thumbnail.jpg` - Best frame thumbnail
+- `run.json` - Execution metadata

agent_recipes/templates/ai-video-to-gif/TEMPLATE.yaml

@@ -0,0 +1,64 @@
+name: ai-video-to-gif
+version: "1.0.0"
+description: |
+  Convert video to optimized GIF with AI-selected best frames.
+  Creates high-quality GIFs with palette optimization.
+
+author: praisonai
+license: Apache-2.0
+tags: [video, gif, conversion, optimization]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools]
+  external:
+    - name: ffmpeg
+      check: "ffmpeg -version"
+      install_hint: "brew install ffmpeg"
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  start:
+    type: number
+    default: 0
+  duration:
+    type: number
+    default: 5
+  fps:
+    type: integer
+    default: 10
+  width:
+    type: integer
+    default: 480
+
+cli:
+  command: ai-video-to-gif
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --start
+      default: "0"
+    - name: --duration
+      default: "5"
+    - name: --fps
+      default: "10"
+    - name: --width
+      default: "480"
+  examples:
+    - "praison run ai-video-to-gif video.mp4"
+    - "praison run ai-video-to-gif video.mp4 --start 10 --duration 3"
+
+outputs:
+  - name: output.gif
+    type: file
+  - name: thumbnail.jpg
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-voice-cloner/README.md

@@ -0,0 +1,59 @@
+# Voice Cloner
+
+Clone voice from sample for TTS narration (CONSENT REQUIRED)
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-voice-cloner <input>
+
+# With output directory
+praison recipes run ai-voice-cloner <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-voice-cloner <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-voice-cloner
+
+# Check dependencies
+praison recipes doctor ai-voice-cloner
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-voice-cloner")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`audio`, `voice`, `tts`, `cloning`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-voice-cloner/TEMPLATE.yaml

@@ -0,0 +1,31 @@
+name: ai-voice-cloner
+version: "1.0.0"
+description: Clone voice from sample for TTS narration (CONSENT REQUIRED)
+author: praison
+license: Apache-2.0
+tags:
+  - audio
+  - voice
+  - tts
+  - cloning
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-voice-cloner
+  examples:
+    - praison recipes run ai-voice-cloner <input>
+    - praison recipes run ai-voice-cloner <input> --output ./output/
+    - praison recipes run ai-voice-cloner <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true
+  requires_consent: true
+  consent_message: "Voice cloning requires explicit consent from the voice owner."

agent_recipes/templates/ai-voiceover-generator/recipe.yaml

@@ -0,0 +1,41 @@
+name: ai-voiceover-generator
+version: 1.0.0
+description: Generate voice overs from text using TTS APIs
+author: PraisonAI
+tags:
+  - audio
+  - voice
+  - tts
+  - speech
+
+config:
+  voice: alloy
+  model: tts-1
+  speed: 1.0
+  output_format: mp3
+
+input:
+  type: object
+  properties:
+    text:
+      type: string
+    voice:
+      type: string
+
+output:
+  type: object
+  properties:
+    audio_path:
+      type: string
+
+requires:
+  env:
+    - OPENAI_API_KEY
+
+workflow:
+  agents:
+    - name: voiceover_agent
+      role: Voice Over Generator
+      tools:
+        - generate_voiceover
+        - generate_speech