agent-recipes 0.0.5__py3-none-any.whl

agent_recipes/templates/ai-broll-builder/tools.py

@@ -0,0 +1,204 @@
+"""
+AI B-roll Builder Tools
+
+Create B-roll video with:
+- Ken Burns effect
+- Pan and zoom
+- Crossfade transitions
+"""
+
+import logging
+import os
+import subprocess
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def create_ken_burns(
+    image_path: str,
+    output_path: str,
+    duration: float = 5.0,
+    zoom_start: float = 1.0,
+    zoom_end: float = 1.2,
+    pan_x: float = 0.0,
+    pan_y: float = 0.0,
+) -> Dict[str, Any]:
+    """
+    Apply Ken Burns effect to an image.
+    
+    Args:
+        image_path: Path to input image
+        output_path: Path to output video
+        duration: Duration in seconds
+        zoom_start: Starting zoom level
+        zoom_end: Ending zoom level
+        pan_x: Horizontal pan (-1 to 1)
+        pan_y: Vertical pan (-1 to 1)
+        
+    Returns:
+        Dictionary with output info
+    """
+    try:
+        # Use ffmpeg for Ken Burns effect
+        zoom_expr = f"zoom+{(zoom_end - zoom_start) / (duration * 25)}"
+        
+        cmd = [
+            "ffmpeg", "-y",
+            "-loop", "1",
+            "-i", image_path,
+            "-vf", f"scale=8000:-1,zoompan=z='{zoom_expr}':x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)':d={int(duration * 25)}:s=1920x1080:fps=25",
+            "-c:v", "libx264",
+            "-t", str(duration),
+            "-pix_fmt", "yuv420p",
+            output_path
+        ]
+        
+        result = subprocess.run(cmd, capture_output=True, text=True)
+        
+        if result.returncode != 0:
+            logger.warning(f"FFmpeg warning: {result.stderr}")
+        
+        return {
+            "path": output_path,
+            "duration": duration,
+            "effect": "ken_burns",
+        }
+        
+    except Exception as e:
+        logger.error(f"Error creating Ken Burns: {e}")
+        return {"error": str(e)}
+
+
+def apply_pan_zoom(
+    image_path: str,
+    output_path: str,
+    duration: float = 5.0,
+    effect: str = "zoom_in",
+) -> Dict[str, Any]:
+    """
+    Apply pan or zoom effect to image.
+    
+    Args:
+        image_path: Input image path
+        output_path: Output video path
+        duration: Duration in seconds
+        effect: Effect type (zoom_in, zoom_out, pan_left, pan_right)
+        
+    Returns:
+        Dictionary with output info
+    """
+    effects = {
+        "zoom_in": "zoompan=z='zoom+0.001':x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'",
+        "zoom_out": "zoompan=z='1.5-on*0.001':x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'",
+        "pan_left": "zoompan=z='1.1':x='iw*on/100':y='ih/2-(ih/zoom/2)'",
+        "pan_right": "zoompan=z='1.1':x='iw-iw*on/100':y='ih/2-(ih/zoom/2)'",
+    }
+    
+    filter_expr = effects.get(effect, effects["zoom_in"])
+    
+    try:
+        cmd = [
+            "ffmpeg", "-y",
+            "-loop", "1",
+            "-i", image_path,
+            "-vf", f"scale=4000:-1,{filter_expr}:d={int(duration * 25)}:s=1920x1080:fps=25",
+            "-c:v", "libx264",
+            "-t", str(duration),
+            "-pix_fmt", "yuv420p",
+            output_path
+        ]
+        
+        subprocess.run(cmd, capture_output=True, check=True)
+        
+        return {
+            "path": output_path,
+            "duration": duration,
+            "effect": effect,
+        }
+        
+    except Exception as e:
+        logger.error(f"Error applying effect: {e}")
+        return {"error": str(e)}
+
+
+def build_broll(
+    images: List[str],
+    output_path: Optional[str] = None,
+    duration_per_image: float = 5.0,
+    transition: str = "crossfade",
+    transition_duration: float = 0.5,
+) -> Dict[str, Any]:
+    """
+    Build B-roll video from multiple images.
+    
+    Args:
+        images: List of image paths
+        output_path: Output video path
+        duration_per_image: Duration per image
+        transition: Transition type
+        transition_duration: Transition duration
+        
+    Returns:
+        Dictionary with output info
+    """
+    import tempfile
+    
+    if not output_path:
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_path = f"broll_{timestamp}.mp4"
+    
+    if not images:
+        return {"error": "No images provided"}
+    
+    with tempfile.TemporaryDirectory() as temp_dir:
+        clips = []
+        effects = ["zoom_in", "zoom_out", "pan_left", "pan_right"]
+        
+        # Create individual clips with effects
+        for i, image in enumerate(images):
+            if not os.path.exists(image):
+                logger.warning(f"Image not found: {image}")
+                continue
+            
+            clip_path = os.path.join(temp_dir, f"clip_{i:03d}.mp4")
+            effect = effects[i % len(effects)]
+            
+            result = apply_pan_zoom(image, clip_path, duration_per_image, effect)
+            if "path" in result:
+                clips.append(result["path"])
+        
+        if not clips:
+            return {"error": "No clips created"}
+        
+        # Create concat file
+        concat_file = os.path.join(temp_dir, "concat.txt")
+        with open(concat_file, "w") as f:
+            for clip in clips:
+                f.write(f"file '{clip}'\n")
+        
+        # Concatenate clips
+        try:
+            cmd = [
+                "ffmpeg", "-y",
+                "-f", "concat",
+                "-safe", "0",
+                "-i", concat_file,
+                "-c:v", "libx264",
+                "-pix_fmt", "yuv420p",
+                output_path
+            ]
+            
+            subprocess.run(cmd, capture_output=True, check=True)
+            
+            return {
+                "path": output_path,
+                "clips": len(clips),
+                "total_duration": len(clips) * duration_per_image,
+            }
+            
+        except Exception as e:
+            logger.error(f"Error building B-roll: {e}")
+            return {"error": str(e)}

agent_recipes/templates/ai-calendar-scheduler/README.md

@@ -0,0 +1,60 @@
+# Calendar Scheduler
+
+Parse and schedule events from text to iCal
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-calendar-scheduler <input>
+
+# With output directory
+praison recipes run ai-calendar-scheduler <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-calendar-scheduler <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-calendar-scheduler
+
+# Check dependencies
+praison recipes doctor ai-calendar-scheduler
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-calendar-scheduler")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+- icalendar
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`productivity`, `calendar`, `scheduling`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-calendar-scheduler/TEMPLATE.yaml

@@ -0,0 +1,29 @@
+name: ai-calendar-scheduler
+version: "1.0.0"
+description: Parse and schedule events from text to iCal
+author: praison
+license: Apache-2.0
+tags:
+  - productivity
+  - calendar
+  - scheduling
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+    - icalendar
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-calendar-scheduler
+  examples:
+    - praison recipes run ai-calendar-scheduler <input>
+    - praison recipes run ai-calendar-scheduler <input> --output ./output/
+    - praison recipes run ai-calendar-scheduler <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true

agent_recipes/templates/ai-changelog-generator/README.md

@@ -0,0 +1,14 @@
+# AI Changelog Generator
+
+Generate CHANGELOG.md from git commit history.
+
+## Usage
+```bash
+praison run ai-changelog-generator ./my-repo
+praison run ai-changelog-generator ./my-repo --since v1.0.0
+```
+
+## Output
+- `CHANGELOG.md` - Formatted changelog
+- `release-notes.md` - Human-readable summary
+- `commits.json` - Structured commit data

agent_recipes/templates/ai-changelog-generator/TEMPLATE.yaml

@@ -0,0 +1,46 @@
+name: ai-changelog-generator
+version: "1.0.0"
+description: Generate CHANGELOG.md from git commit history.
+author: praisonai
+license: Apache-2.0
+tags: [git, changelog, release-notes, documentation]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools]
+  env: [OPENAI_API_KEY]
+  external:
+    - name: git
+      check: "git --version"
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  since:
+    type: string
+
+cli:
+  command: ai-changelog-generator
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --since
+  examples:
+    - "praison run ai-changelog-generator ./my-repo"
+    - "praison run ai-changelog-generator ./my-repo --since v1.0.0"
+
+outputs:
+  - name: CHANGELOG.md
+    type: file
+  - name: release-notes.md
+    type: file
+  - name: commits.json
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-chart-generator/README.md

@@ -0,0 +1,61 @@
+# Chart Generator
+
+Generate charts/visualizations from data
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-chart-generator <input>
+
+# With output directory
+praison recipes run ai-chart-generator <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-chart-generator <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-chart-generator
+
+# Check dependencies
+praison recipes doctor ai-chart-generator
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-chart-generator")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+- pandas
+- matplotlib
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`data`, `chart`, `visualization`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-chart-generator/TEMPLATE.yaml

@@ -0,0 +1,32 @@
+name: ai-chart-generator
+version: "1.0.0"
+description: Generate charts/visualizations from data
+author: praison
+license: Apache-2.0
+tags:
+  - data
+  - chart
+  - visualization
+
+requires:
+  tools:
+    - data_tool
+    - chart_tool
+    - llm_tool
+  packages:
+    - openai
+    - pandas
+    - matplotlib
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-chart-generator
+  examples:
+    - praison recipes run ai-chart-generator <input>
+    - praison recipes run ai-chart-generator <input> --output ./output/
+    - praison recipes run ai-chart-generator <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true

agent_recipes/templates/ai-code-documenter/README.md

@@ -0,0 +1,12 @@
+# AI Code Documenter
+
+Generate documentation from source code.
+
+## Usage
+```bash
+praison run ai-code-documenter ./src/
+```
+
+## Output
+- `docs/` - Generated documentation
+- `api.md` - API documentation

agent_recipes/templates/ai-code-documenter/TEMPLATE.yaml

@@ -0,0 +1,37 @@
+name: ai-code-documenter
+version: "1.0.0"
+description: Generate documentation from source code.
+author: praisonai
+license: Apache-2.0
+tags: [code, documentation, api-docs]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools]
+  env: [OPENAI_API_KEY]
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+
+cli:
+  command: ai-code-documenter
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+  examples:
+    - "praison run ai-code-documenter ./src/"
+
+outputs:
+  - name: docs/
+    type: directory
+  - name: api.md
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-code-refactorer/README.md

@@ -0,0 +1,59 @@
+# Code Refactorer
+
+Refactor code with AI suggestions (patch-based, tests-first option)
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-code-refactorer <input>
+
+# With output directory
+praison recipes run ai-code-refactorer <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-code-refactorer <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-code-refactorer
+
+# Check dependencies
+praison recipes doctor ai-code-refactorer
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-code-refactorer")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`code`, `refactoring`, `improvement`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-code-refactorer/TEMPLATE.yaml

@@ -0,0 +1,28 @@
+name: ai-code-refactorer
+version: "1.0.0"
+description: Refactor code with AI suggestions (patch-based, tests-first option)
+author: praison
+license: Apache-2.0
+tags:
+  - code
+  - refactoring
+  - improvement
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-code-refactorer
+  examples:
+    - praison recipes run ai-code-refactorer <input>
+    - praison recipes run ai-code-refactorer <input> --output ./output/
+    - praison recipes run ai-code-refactorer <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true

agent_recipes/templates/ai-code-reviewer/README.md

@@ -0,0 +1,59 @@
+# Code Reviewer
+
+Automated code review with suggestions
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-code-reviewer <input>
+
+# With output directory
+praison recipes run ai-code-reviewer <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-code-reviewer <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-code-reviewer
+
+# Check dependencies
+praison recipes doctor ai-code-reviewer
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-code-reviewer")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- git
+
+## Tags
+
+`code`, `review`, `quality`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-code-reviewer/TEMPLATE.yaml

@@ -0,0 +1,31 @@
+name: ai-code-reviewer
+version: "1.0.0"
+description: Automated code review with suggestions
+author: praison
+license: Apache-2.0
+tags:
+  - code
+  - review
+  - quality
+
+requires:
+  tools:
+    - repo_tool
+    - llm_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+  external:
+    - git
+
+cli:
+  command: praison recipes run ai-code-reviewer
+  examples:
+    - praison recipes run ai-code-reviewer <input>
+    - praison recipes run ai-code-reviewer <input> --output ./output/
+    - praison recipes run ai-code-reviewer <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true