agent-recipes 0.0.5__py3-none-any.whl

agent_recipes/templates/ai-voiceover-generator/tools.py

@@ -0,0 +1,194 @@
+"""
+AI Voiceover Generator Tools
+
+Generate voice overs using TTS:
+- OpenAI TTS
+- Multiple voices
+- Speed control
+"""
+
+import logging
+import os
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Dict, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def generate_voiceover(
+    text: str,
+    output_path: Optional[str] = None,
+    voice: str = "alloy",
+    model: str = "tts-1",
+    speed: float = 1.0,
+) -> Dict[str, Any]:
+    """
+    Generate voiceover from text using OpenAI TTS.
+    
+    Args:
+        text: Text to convert to speech
+        output_path: Output audio file path
+        voice: Voice to use (alloy, echo, fable, onyx, nova, shimmer)
+        model: TTS model (tts-1, tts-1-hd)
+        speed: Speech speed (0.25 to 4.0)
+        
+    Returns:
+        Dictionary with audio info
+    """
+    import requests
+    
+    api_key = os.environ.get("OPENAI_API_KEY")
+    if not api_key:
+        return {"error": "OPENAI_API_KEY not set"}
+    
+    if not output_path:
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_path = f"voiceover_{timestamp}.mp3"
+    
+    Path(output_path).parent.mkdir(parents=True, exist_ok=True)
+    
+    try:
+        response = requests.post(
+            "https://api.openai.com/v1/audio/speech",
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "Content-Type": "application/json",
+            },
+            json={
+                "model": model,
+                "input": text,
+                "voice": voice,
+                "speed": speed,
+            },
+            timeout=120,
+        )
+        response.raise_for_status()
+        
+        with open(output_path, "wb") as f:
+            f.write(response.content)
+        
+        return {
+            "path": output_path,
+            "voice": voice,
+            "model": model,
+            "text_length": len(text),
+            "size_bytes": len(response.content),
+        }
+        
+    except Exception as e:
+        logger.error(f"Error generating voiceover: {e}")
+        return {"error": str(e)}
+
+
+def generate_speech(
+    script: str,
+    output_dir: Optional[str] = None,
+    voice: str = "alloy",
+    chunk_size: int = 4000,
+) -> Dict[str, Any]:
+    """
+    Generate speech from a longer script, chunking if needed.
+    
+    Args:
+        script: Full script text
+        output_dir: Output directory
+        voice: Voice to use
+        chunk_size: Max characters per chunk
+        
+    Returns:
+        Dictionary with audio files
+    """
+    output_dir = output_dir or "./voiceovers"
+    Path(output_dir).mkdir(parents=True, exist_ok=True)
+    
+    # Split into chunks if needed
+    chunks = []
+    if len(script) > chunk_size:
+        words = script.split()
+        current_chunk = []
+        current_length = 0
+        
+        for word in words:
+            if current_length + len(word) + 1 > chunk_size:
+                chunks.append(" ".join(current_chunk))
+                current_chunk = [word]
+                current_length = len(word)
+            else:
+                current_chunk.append(word)
+                current_length += len(word) + 1
+        
+        if current_chunk:
+            chunks.append(" ".join(current_chunk))
+    else:
+        chunks = [script]
+    
+    audio_files = []
+    
+    for i, chunk in enumerate(chunks):
+        output_path = os.path.join(output_dir, f"speech_{i:03d}.mp3")
+        result = generate_voiceover(chunk, output_path, voice)
+        
+        if "path" in result:
+            audio_files.append(result["path"])
+        else:
+            logger.warning(f"Error generating chunk {i}: {result.get('error')}")
+    
+    # Concatenate if multiple files
+    if len(audio_files) > 1:
+        final_path = os.path.join(output_dir, "speech_full.mp3")
+        concat_audio(audio_files, final_path)
+        return {
+            "path": final_path,
+            "chunks": len(audio_files),
+            "chunk_files": audio_files,
+        }
+    elif audio_files:
+        return {
+            "path": audio_files[0],
+            "chunks": 1,
+        }
+    else:
+        return {"error": "No audio generated"}
+
+
+def concat_audio(
+    audio_files: list,
+    output_path: str,
+) -> Dict[str, Any]:
+    """
+    Concatenate multiple audio files.
+    
+    Args:
+        audio_files: List of audio file paths
+        output_path: Output file path
+        
+    Returns:
+        Dictionary with output info
+    """
+    import subprocess
+    import tempfile
+    
+    try:
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".txt", delete=False) as f:
+            for audio in audio_files:
+                f.write(f"file '{audio}'\n")
+            concat_file = f.name
+        
+        cmd = [
+            "ffmpeg", "-y",
+            "-f", "concat",
+            "-safe", "0",
+            "-i", concat_file,
+            "-c", "copy",
+            output_path
+        ]
+        
+        subprocess.run(cmd, capture_output=True, check=True)
+        os.unlink(concat_file)
+        
+        return {"path": output_path}
+        
+    except Exception as e:
+        logger.error(f"Error concatenating audio: {e}")
+        return {"error": str(e)}

agent_recipes/templates/ai-watermark-adder/README.md

@@ -0,0 +1,59 @@
+# Watermark Adder
+
+Batch add watermarks/logos to images
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-watermark-adder <input>
+
+# With output directory
+praison recipes run ai-watermark-adder <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-watermark-adder <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-watermark-adder
+
+# Check dependencies
+praison recipes doctor ai-watermark-adder
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-watermark-adder")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- pillow
+
+### Environment Variables
+- None
+
+### External Tools
+- None
+
+## Tags
+
+`image`, `watermark`, `branding`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-watermark-adder/TEMPLATE.yaml

@@ -0,0 +1,26 @@
+name: ai-watermark-adder
+version: "1.0.0"
+description: Batch add watermarks/logos to images
+author: praison
+license: Apache-2.0
+tags:
+  - image
+  - watermark
+  - branding
+
+requires:
+  tools:
+    - image_tool
+  packages:
+    - pillow
+
+cli:
+  command: praison recipes run ai-watermark-adder
+  examples:
+    - praison recipes run ai-watermark-adder <input>
+    - praison recipes run ai-watermark-adder <input> --output ./output/
+    - praison recipes run ai-watermark-adder <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true

agent_recipes/templates/ai-watermark-remover/README.md

@@ -0,0 +1,60 @@
+# Watermark Remover
+
+Remove watermarks from images (COPYRIGHT WARNING)
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-watermark-remover <input>
+
+# With output directory
+praison recipes run ai-watermark-remover <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-watermark-remover <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-watermark-remover
+
+# Check dependencies
+praison recipes doctor ai-watermark-remover
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-watermark-remover")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+- pillow
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`image`, `watermark`, `removal`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-watermark-remover/TEMPLATE.yaml

@@ -0,0 +1,32 @@
+name: ai-watermark-remover
+version: "1.0.0"
+description: Remove watermarks from images (COPYRIGHT WARNING)
+author: praison
+license: Apache-2.0
+tags:
+  - image
+  - watermark
+  - removal
+
+requires:
+  tools:
+    - vision_tool
+    - image_tool
+  packages:
+    - openai
+    - pillow
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-watermark-remover
+  examples:
+    - praison recipes run ai-watermark-remover <input>
+    - praison recipes run ai-watermark-remover <input> --output ./output/
+    - praison recipes run ai-watermark-remover <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true
+  requires_consent: true
+  consent_message: "Only use on images you have rights to modify."

agent_recipes/templates/data-transformer/README.md

@@ -0,0 +1,75 @@
+# Data Transformer
+
+Transform data between formats with AI-assisted schema mapping.
+
+## Features
+
+- **Multi-format support**: CSV, JSON, XML, Excel
+- **AI schema inference**: Automatic detection of data types and patterns
+- **Smart mapping**: AI-assisted field mapping between schemas
+- **Validation**: Optional output validation
+
+## Requirements
+
+- `OPENAI_API_KEY` environment variable
+- Optional: `pandas` for data processing
+
+## Usage
+
+### CLI
+
+```bash
+# Basic transformation
+praisonai run data-transformer ./data.csv -o ./output.json
+
+# With target schema
+praisonai run data-transformer ./legacy.xml -o ./modern.json --schema ./schema.json
+
+# Natural language schema
+praisonai run data-transformer ./data.csv -o ./output.json --schema "Salesforce Contact format"
+```
+
+### Python API
+
+```python
+from praisonaiagents import Workflow
+
+workflow = Workflow.from_template(
+    "data-transformer",
+    config={
+        "input": "./data.csv",
+        "output": "./output.json",
+        "target_schema": "Salesforce Contact format",
+        "validation": True
+    }
+)
+result = workflow.run()
+```
+
+## Supported Formats
+
+### Input
+- CSV (comma, tab, pipe delimited)
+- JSON (objects, arrays)
+- XML
+- Excel (.xlsx, .xls)
+
+### Output
+- JSON
+- CSV
+- XML
+- Excel
+
+## Configuration
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `input` | string | required | Input file path |
+| `output` | string | required | Output file path |
+| `target_schema` | string | auto | Target schema file or description |
+| `validation` | boolean | true | Validate output against schema |
+| `sample_size` | integer | 100 | Rows to sample for inference |
+
+## License
+
+Apache-2.0

agent_recipes/templates/data-transformer/TEMPLATE.yaml

@@ -0,0 +1,63 @@
+name: data-transformer
+version: "1.0.0"
+description: Transform data between formats with AI-assisted schema mapping
+author: praisonai
+license: Apache-2.0
+tags: [data, etl, transform, csv, json, xml, schema]
+
+requires:
+  tools: [csv_tool, json_tool, file_tool]
+  packages: [pandas]
+  env: [OPENAI_API_KEY]
+
+workflow: workflow.yaml
+agents: agents.yaml
+
+config:
+  input:
+    type: string
+    required: true
+    description: Input file (CSV, JSON, XML, Excel)
+  output:
+    type: string
+    required: true
+    description: Output file path
+  target_schema:
+    type: string
+    description: Target schema file or description
+  validation:
+    type: boolean
+    default: true
+    description: Validate output against schema
+  sample_size:
+    type: integer
+    default: 100
+    description: Rows to sample for schema inference
+
+defaults:
+  validation: true
+  sample_size: 100
+
+cli:
+  command: transform
+  args:
+    - name: input
+      positional: true
+      description: Input file (CSV, JSON, XML, Excel)
+    - name: --output
+      short: -o
+      required: true
+      description: Output file path
+    - name: --schema
+      short: -s
+      description: Target schema file or description
+    - name: --no-validate
+      flag: true
+      description: Skip validation step
+    - name: --sample
+      default: 100
+      description: Sample size for schema inference
+  examples:
+    - praisonai run data-transformer ./data.csv -o ./output.json
+    - praisonai run data-transformer ./legacy.xml -o ./modern.json --schema ./schema.json
+    - praisonai run data-transformer ./data.csv -o ./output.json --schema "Salesforce Contact format"

agent_recipes/templates/data-transformer/agents.yaml

@@ -0,0 +1,70 @@
+agents:
+  schema_inferrer:
+    name: SchemaInferrer
+    role: Data Analyst
+    goal: Infer source data schema
+    backstory: |
+      I am an expert at analyzing data files and understanding their structure.
+      I can detect patterns, data types, and quality issues in any format.
+    instructions: |
+      Analyze the input file and infer its schema:
+      - Detect file format (CSV, JSON, XML, Excel)
+      - Identify column names and data types
+      - Detect patterns (dates, emails, phones, etc.)
+      - Note any data quality issues
+      Return a structured schema definition.
+    tools: [csv_tool, json_tool, file_tool]
+    verbose: true
+
+  mapper:
+    name: SchemaMapper
+    role: Data Engineer
+    goal: Create field mappings between schemas
+    backstory: |
+      I specialize in data integration and schema mapping. I understand
+      how to match fields between different data models and identify
+      the transformations needed.
+    instructions: |
+      Map source fields to target schema:
+      - Match by name similarity
+      - Match by data type compatibility
+      - Match by sample value patterns
+      - Flag ambiguous mappings for review
+      - Suggest transformations needed
+      Return a mapping specification.
+    verbose: true
+
+  transformer:
+    name: DataTransformer
+    role: ETL Engineer
+    goal: Execute data transformation
+    backstory: |
+      I am an ETL specialist who can transform data between any formats.
+      I handle type conversions, formatting, and data quality issues
+      while maintaining data integrity.
+    instructions: |
+      Transform data according to mapping:
+      - Read source data
+      - Apply field mappings
+      - Execute transformations
+      - Handle null values and defaults
+      - Write to output format
+    tools: [csv_tool, json_tool, file_tool]
+    verbose: true
+
+  validator:
+    name: DataValidator
+    role: QA Engineer
+    goal: Validate transformed data
+    backstory: |
+      I am a data quality specialist who ensures transformed data
+      meets all requirements and constraints. I catch issues before
+      they cause problems downstream.
+    instructions: |
+      Validate the transformed data:
+      - Schema compliance check
+      - Data type correctness
+      - Required field presence
+      - Value range constraints
+      Return validation report.
+    verbose: true

agent_recipes/templates/data-transformer/workflow.yaml

@@ -0,0 +1,92 @@
+name: Data Transformer
+description: Transform data between formats with AI-assisted schema mapping
+
+workflow:
+  verbose: true
+  stream: true
+
+variables:
+  input: "{{input}}"
+  output: "{{output}}"
+  target_schema: "{{target_schema}}"
+  validation: "{{validation}}"
+  sample_size: "{{sample_size}}"
+
+agents:
+  schema_inferrer:
+    name: SchemaInferrer
+    role: Data Analyst
+    goal: Infer source data schema
+    instructions: |
+      Analyze the input file and infer its schema:
+      - Detect file format (CSV, JSON, XML, Excel)
+      - Sample {{sample_size}} rows for analysis
+      - Identify column names and data types
+      - Detect patterns (dates, emails, phones, etc.)
+      - Note any data quality issues
+      Return a structured schema definition.
+    tools: [csv_tool, json_tool, file_tool]
+
+  mapper:
+    name: SchemaMapper
+    role: Data Engineer
+    goal: Create field mappings between schemas
+    instructions: |
+      Map source fields to target schema:
+      - Match by name similarity
+      - Match by data type compatibility
+      - Match by sample value patterns
+      - Flag ambiguous mappings for review
+      - Suggest transformations needed
+      Return a mapping specification.
+
+  transformer:
+    name: DataTransformer
+    role: ETL Engineer
+    goal: Execute data transformation
+    instructions: |
+      Transform data according to mapping:
+      - Read source data
+      - Apply field mappings
+      - Execute transformations (type conversion, formatting)
+      - Handle null values and defaults
+      - Write to output format
+    tools: [csv_tool, json_tool, file_tool]
+
+  validator:
+    name: DataValidator
+    role: QA Engineer
+    goal: Validate transformed data
+    instructions: |
+      Validate the transformed data:
+      - Schema compliance check
+      - Data type correctness
+      - Required field presence
+      - Value range constraints
+      - Referential integrity (if applicable)
+      Return validation report.
+
+steps:
+  - name: infer_schema
+    agent: schema_inferrer
+    action: "Analyze source file and infer schema: {{input}}"
+    output_variable: source_schema
+    
+  - name: create_mapping
+    agent: mapper
+    action: "Create mapping to target: {{target_schema}}"
+    context_from: [infer_schema]
+    output_variable: field_mapping
+    
+  - name: transform
+    agent: transformer
+    action: "Transform data and write to: {{output}}"
+    context_from: [create_mapping]
+    output_variable: transform_result
+    
+  - name: validate
+    agent: validator
+    action: "Validate output against schema"
+    context_from: [transform]
+    condition: "{{validation}}"
+    output_variable: validation_report