agent-recipes 0.0.5__py3-none-any.whl

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

@@ -0,0 +1,182 @@
+"""
+AI Angle Generator Tools
+
+Generate multiple content angles:
+- Controversial takes
+- Educational approaches
+- Business/ROI focus
+- Risk analysis
+- Future predictions
+- Personal stories
+- Comparisons
+"""
+
+import logging
+import os
+from typing import Any, Dict, List, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def call_llm(prompt: str, max_tokens: int = 1500) -> str:
+    """Call OpenAI API for text generation."""
+    import requests
+    
+    api_key = os.environ.get("OPENAI_API_KEY")
+    if not api_key:
+        raise ValueError("OPENAI_API_KEY not set")
+    
+    response = requests.post(
+        "https://api.openai.com/v1/chat/completions",
+        headers={
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+        },
+        json={
+            "model": "gpt-4o-mini",
+            "messages": [{"role": "user", "content": prompt}],
+            "max_tokens": max_tokens,
+            "temperature": 0.9,
+        },
+        timeout=60,
+    )
+    response.raise_for_status()
+    return response.json()["choices"][0]["message"]["content"]
+
+
+def generate_angles(
+    topic: str,
+    angle_types: Optional[List[str]] = None,
+    num_angles: int = 5,
+) -> Dict[str, Any]:
+    """
+    Generate multiple content angles for a topic.
+    
+    Args:
+        topic: The topic to generate angles for
+        angle_types: Types of angles to generate
+        num_angles: Number of angles to generate
+        
+    Returns:
+        Dictionary with generated angles
+    """
+    angle_types = angle_types or [
+        "controversial", "educational", "business", 
+        "risk", "future_prediction"
+    ]
+    
+    angle_descriptions = {
+        "controversial": "A bold, contrarian take that challenges conventional wisdom",
+        "educational": "An informative, step-by-step teaching approach",
+        "business": "Focus on ROI, business impact, and practical applications",
+        "risk": "Highlight potential dangers, downsides, or things to watch out for",
+        "future_prediction": "Make predictions about where this is heading",
+        "personal_story": "Frame through personal experience or case study",
+        "comparison": "Compare and contrast with alternatives or competitors",
+    }
+    
+    angles_text = "\n".join(
+        f"- {angle}: {angle_descriptions.get(angle, 'Unique perspective')}"
+        for angle in angle_types[:num_angles]
+    )
+    
+    prompt = f"""Generate {num_angles} different content angles for this topic: {topic}
+
+For each angle type, provide:
+1. A compelling title/headline
+2. The main hook or thesis
+3. 3 key talking points
+4. Target audience
+
+Angle types to generate:
+{angles_text}
+
+Format each angle clearly with the type as a header."""
+    
+    result = call_llm(prompt, max_tokens=2000)
+    
+    # Parse angles from response
+    angles = []
+    current_angle = None
+    
+    for line in result.split("\n"):
+        line = line.strip()
+        if not line:
+            continue
+        
+        # Check if this is a new angle header
+        for angle_type in angle_types:
+            if angle_type.lower() in line.lower() and (":" in line or "#" in line):
+                if current_angle:
+                    angles.append(current_angle)
+                current_angle = {
+                    "type": angle_type,
+                    "content": [],
+                }
+                break
+        
+        if current_angle:
+            current_angle["content"].append(line)
+    
+    if current_angle:
+        angles.append(current_angle)
+    
+    # Format angles
+    formatted_angles = []
+    for angle in angles:
+        formatted_angles.append({
+            "type": angle["type"],
+            "content": "\n".join(angle["content"]),
+        })
+    
+    return {
+        "angles": formatted_angles,
+        "topic": topic,
+        "raw_response": result,
+    }
+
+
+def evaluate_angles(
+    angles: List[Dict[str, Any]],
+    criteria: Optional[List[str]] = None,
+) -> Dict[str, Any]:
+    """
+    Evaluate and rank generated angles.
+    
+    Args:
+        angles: List of angle dictionaries
+        criteria: Evaluation criteria
+        
+    Returns:
+        Ranked angles with scores
+    """
+    criteria = criteria or ["engagement_potential", "uniqueness", "clarity"]
+    
+    evaluated = []
+    for angle in angles:
+        # Simple scoring based on content length and keywords
+        content = angle.get("content", "")
+        score = 0.5
+        
+        # Engagement indicators
+        engagement_words = ["you", "your", "discover", "secret", "truth", "actually"]
+        for word in engagement_words:
+            if word in content.lower():
+                score += 0.1
+        
+        # Uniqueness (longer content often more unique)
+        if len(content) > 200:
+            score += 0.1
+        
+        evaluated.append({
+            **angle,
+            "score": min(1.0, score),
+        })
+    
+    # Sort by score
+    evaluated.sort(key=lambda x: x["score"], reverse=True)
+    
+    return {
+        "ranked_angles": evaluated,
+        "criteria_used": criteria,
+    }

agent_recipes/templates/ai-api-doc-generator/README.md

@@ -0,0 +1,59 @@
+# Api Doc Generator
+
+Generate OpenAPI/Swagger docs from code
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-api-doc-generator <input>
+
+# With output directory
+praison recipes run ai-api-doc-generator <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-api-doc-generator <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-api-doc-generator
+
+# Check dependencies
+praison recipes doctor ai-api-doc-generator
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-api-doc-generator")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`code`, `api`, `documentation`, `openapi`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-api-doc-generator/TEMPLATE.yaml

@@ -0,0 +1,29 @@
+name: ai-api-doc-generator
+version: "1.0.0"
+description: Generate OpenAPI/Swagger docs from code
+author: praison
+license: Apache-2.0
+tags:
+  - code
+  - api
+  - documentation
+  - openapi
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-api-doc-generator
+  examples:
+    - praison recipes run ai-api-doc-generator <input>
+    - praison recipes run ai-api-doc-generator <input> --output ./output/
+    - praison recipes run ai-api-doc-generator <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true

agent_recipes/templates/ai-api-tester/README.md

@@ -0,0 +1,60 @@
+# Api Tester
+
+Auto-generate and run API endpoint tests
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-api-tester <input>
+
+# With output directory
+praison recipes run ai-api-tester <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-api-tester <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-api-tester
+
+# Check dependencies
+praison recipes doctor ai-api-tester
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-api-tester")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+- requests
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`code`, `api`, `testing`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-api-tester/TEMPLATE.yaml

@@ -0,0 +1,29 @@
+name: ai-api-tester
+version: "1.0.0"
+description: Auto-generate and run API endpoint tests
+author: praison
+license: Apache-2.0
+tags:
+  - code
+  - api
+  - testing
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+    - requests
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-api-tester
+  examples:
+    - praison recipes run ai-api-tester <input>
+    - praison recipes run ai-api-tester <input> --output ./output/
+    - praison recipes run ai-api-tester <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true

agent_recipes/templates/ai-audio-enhancer/README.md

@@ -0,0 +1,59 @@
+# Audio Enhancer
+
+Noise removal, EQ, and loudness normalization for audio
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-audio-enhancer <input>
+
+# With output directory
+praison recipes run ai-audio-enhancer <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-audio-enhancer <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-audio-enhancer
+
+# Check dependencies
+praison recipes doctor ai-audio-enhancer
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-audio-enhancer")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- ffmpeg-python
+
+### Environment Variables
+- None
+
+### External Tools
+- ffmpeg
+
+## Tags
+
+`audio`, `enhancement`, `noise-removal`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-audio-enhancer/TEMPLATE.yaml

@@ -0,0 +1,28 @@
+name: ai-audio-enhancer
+version: "1.0.0"
+description: Noise removal, EQ, and loudness normalization for audio
+author: praison
+license: Apache-2.0
+tags:
+  - audio
+  - enhancement
+  - noise-removal
+
+requires:
+  tools:
+    - media_tool
+  packages:
+    - ffmpeg-python
+  external:
+    - ffmpeg
+
+cli:
+  command: praison recipes run ai-audio-enhancer
+  examples:
+    - praison recipes run ai-audio-enhancer <input>
+    - praison recipes run ai-audio-enhancer <input> --output ./output/
+    - praison recipes run ai-audio-enhancer <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true

agent_recipes/templates/ai-audio-normalizer/README.md

@@ -0,0 +1,13 @@
+# AI Audio Normalizer
+
+Normalize audio loudness using EBU R128 standard.
+
+## Usage
+```bash
+praison run ai-audio-normalizer audio.mp3
+praison run ai-audio-normalizer audio.wav --target-lufs -14
+```
+
+## Output
+- `normalized.mp3` - Normalized audio
+- `loudness-report.json` - Loudness analysis

agent_recipes/templates/ai-audio-normalizer/TEMPLATE.yaml

@@ -0,0 +1,44 @@
+name: ai-audio-normalizer
+version: "1.0.0"
+description: Normalize audio loudness using EBU R128 standard.
+author: praisonai
+license: Apache-2.0
+tags: [audio, normalization, loudness, ebu-r128]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools]
+  external:
+    - name: ffmpeg
+      check: "ffmpeg -version"
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  target_lufs:
+    type: number
+    default: -16.0
+
+cli:
+  command: ai-audio-normalizer
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --target-lufs
+      default: "-16"
+  examples:
+    - "praison run ai-audio-normalizer audio.mp3"
+
+outputs:
+  - name: normalized.mp3
+    type: file
+  - name: loudness-report.json
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-audio-splitter/README.md

@@ -0,0 +1,14 @@
+# AI Audio Splitter
+
+Split long audio files by silence detection or chapter markers.
+
+## Usage
+```bash
+praison run ai-audio-splitter long_audio.mp3
+praison run ai-audio-splitter podcast.wav --min-silence 2.0
+```
+
+## Output
+- `tracks/` - Split audio tracks
+- `manifest.json` - Track metadata
+- `run.json` - Execution metadata

agent_recipes/templates/ai-audio-splitter/TEMPLATE.yaml

@@ -0,0 +1,47 @@
+name: ai-audio-splitter
+version: "1.0.0"
+description: Split long audio files by silence detection or chapter markers.
+author: praisonai
+license: Apache-2.0
+tags: [audio, split, chapters, silence-detection]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools]
+  external:
+    - name: ffmpeg
+      check: "ffmpeg -version"
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  min_silence_duration:
+    type: number
+    default: 1.0
+  silence_threshold:
+    type: string
+    default: "-40dB"
+
+cli:
+  command: ai-audio-splitter
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --min-silence
+      default: "1.0"
+  examples:
+    - "praison run ai-audio-splitter long_audio.mp3"
+
+outputs:
+  - name: tracks/
+    type: directory
+  - name: manifest.json
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-background-music-generator/README.md

@@ -0,0 +1,59 @@
+# Background Music Generator
+
+Generate royalty-free background music for videos
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-background-music-generator <input>
+
+# With output directory
+praison recipes run ai-background-music-generator <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-background-music-generator <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-background-music-generator
+
+# Check dependencies
+praison recipes doctor ai-background-music-generator
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-background-music-generator")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`audio`, `music`, `generation`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-background-music-generator/TEMPLATE.yaml

@@ -0,0 +1,28 @@
+name: ai-background-music-generator
+version: "1.0.0"
+description: Generate royalty-free background music for videos
+author: praison
+license: Apache-2.0
+tags:
+  - audio
+  - music
+  - generation
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-background-music-generator
+  examples:
+    - praison recipes run ai-background-music-generator <input>
+    - praison recipes run ai-background-music-generator <input> --output ./output/
+    - praison recipes run ai-background-music-generator <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true