agent-recipes 0.0.5__py3-none-any.whl

agent_recipes/templates/ai-hashtag-optimizer/tools.py

@@ -0,0 +1,134 @@
+"""
+AI Hashtag Optimizer Tools
+
+Optimize hashtags and keywords for social media reach.
+"""
+
+import logging
+import os
+from typing import Any, Dict, List, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def call_llm(prompt: str, max_tokens: int = 500) -> str:
+    """Call OpenAI API."""
+    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},
+        timeout=60,
+    )
+    response.raise_for_status()
+    return response.json()["choices"][0]["message"]["content"]
+
+
+def generate_hashtags(
+    topic: str,
+    platform: str = "instagram",
+    max_hashtags: int = 30,
+    mix_popularity: bool = True,
+) -> Dict[str, Any]:
+    """
+    Generate optimized hashtags for a topic.
+    
+    Args:
+        topic: Content topic
+        platform: Target platform
+        max_hashtags: Maximum hashtags
+        mix_popularity: Mix popular and niche hashtags
+        
+    Returns:
+        Dictionary with hashtags
+    """
+    platform_limits = {
+        "instagram": 30,
+        "x": 5,
+        "linkedin": 5,
+        "tiktok": 10,
+    }
+    
+    limit = min(max_hashtags, platform_limits.get(platform, 10))
+    
+    prompt = f"""Generate {limit} optimized hashtags for this topic: {topic}
+
+Platform: {platform}
+{"Mix popular (high reach) and niche (high engagement) hashtags" if mix_popularity else "Focus on relevant hashtags"}
+
+Requirements:
+- No spaces in hashtags
+- Relevant to the topic
+- Mix of broad and specific tags
+- Include trending tags if applicable
+
+Format: One hashtag per line, starting with #"""
+    
+    try:
+        result = call_llm(prompt, max_tokens=300)
+        
+        hashtags = []
+        for line in result.split("\n"):
+            line = line.strip()
+            if line.startswith("#"):
+                tag = line.split()[0]  # Get just the hashtag
+                hashtags.append(tag)
+        
+        return {
+            "hashtags": hashtags[:limit],
+            "platform": platform,
+            "count": len(hashtags[:limit]),
+        }
+    except Exception as e:
+        logger.error(f"Error generating hashtags: {e}")
+        return {"error": str(e)}
+
+
+def optimize_keywords(
+    topic: str,
+    content_type: str = "video",
+    max_keywords: int = 20,
+) -> Dict[str, Any]:
+    """
+    Generate optimized keywords for SEO.
+    
+    Args:
+        topic: Content topic
+        content_type: Type of content
+        max_keywords: Maximum keywords
+        
+    Returns:
+        Dictionary with keywords
+    """
+    prompt = f"""Generate {max_keywords} SEO keywords for this topic: {topic}
+
+Content type: {content_type}
+
+Include:
+- Primary keywords (high search volume)
+- Long-tail keywords (specific phrases)
+- Related terms
+- Question-based keywords
+
+Format: One keyword/phrase per line"""
+    
+    try:
+        result = call_llm(prompt, max_tokens=400)
+        
+        keywords = []
+        for line in result.split("\n"):
+            line = line.strip().lstrip("-•").strip()
+            if line and len(line) > 2:
+                keywords.append(line)
+        
+        return {
+            "keywords": keywords[:max_keywords],
+            "topic": topic,
+            "count": len(keywords[:max_keywords]),
+        }
+    except Exception as e:
+        logger.error(f"Error generating keywords: {e}")
+        return {"error": str(e)}

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

@@ -0,0 +1,50 @@
+name: ai-hook-generator
+version: 1.0.0
+description: Generate attention-grabbing hooks for the first 2 seconds of videos with multiple variants
+author: PraisonAI
+tags:
+  - hooks
+  - content
+  - video
+  - engagement
+
+config:
+  num_variants: 5
+  hook_styles:
+    - question
+    - bold_statement
+    - statistic
+    - story_tease
+    - controversy
+  max_length_seconds: 3
+
+input:
+  type: object
+  properties:
+    topic:
+      type: string
+    num_variants:
+      type: integer
+    style:
+      type: string
+
+output:
+  type: object
+  properties:
+    hooks:
+      type: array
+    best_hook:
+      type: string
+
+requires:
+  env:
+    - OPENAI_API_KEY
+
+workflow:
+  agents:
+    - name: hook_generator
+      role: Hook Specialist
+      goal: Create irresistible video hooks
+      tools:
+        - generate_hooks
+        - rank_hooks

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

@@ -0,0 +1,177 @@
+"""
+AI Hook Generator Tools
+
+Generate multiple hook variants for video content:
+- Question hooks
+- Bold statement hooks
+- Statistic hooks
+- Story tease hooks
+- Controversy hooks
+"""
+
+import logging
+import os
+from typing import Any, Dict, List, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def call_llm(prompt: str, max_tokens: int = 800) -> 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_hooks(
+    topic: str,
+    num_variants: int = 5,
+    styles: Optional[List[str]] = None,
+    max_words: int = 15,
+) -> Dict[str, Any]:
+    """
+    Generate multiple hook variants for a topic.
+    
+    Args:
+        topic: The video topic
+        num_variants: Number of hook variants to generate
+        styles: Hook styles to use
+        max_words: Maximum words per hook
+        
+    Returns:
+        Dictionary with hook variants
+    """
+    styles = styles or ["question", "bold_statement", "statistic", "story_tease", "controversy"]
+    
+    style_examples = {
+        "question": "Start with a provocative question",
+        "bold_statement": "Make a bold, attention-grabbing claim",
+        "statistic": "Lead with a surprising number or stat",
+        "story_tease": "Tease an interesting story or outcome",
+        "controversy": "Challenge a common belief",
+    }
+    
+    styles_text = "\n".join(
+        f"- {s}: {style_examples.get(s, 'Unique approach')}"
+        for s in styles[:num_variants]
+    )
+    
+    prompt = f"""Generate {num_variants} different video hooks for this topic: {topic}
+
+Each hook must:
+- Be under {max_words} words
+- Grab attention in the first 2 seconds
+- Make viewers want to keep watching
+- Be speakable (sounds natural when said aloud)
+
+Hook styles to use:
+{styles_text}
+
+Format each hook as:
+[STYLE] Hook text here
+
+Generate {num_variants} hooks:"""
+    
+    result = call_llm(prompt, max_tokens=600)
+    
+    # Parse hooks from response
+    hooks = []
+    for line in result.split("\n"):
+        line = line.strip()
+        if not line:
+            continue
+        
+        # Try to extract style and hook
+        if "[" in line and "]" in line:
+            try:
+                style_end = line.index("]")
+                style = line[1:style_end].strip().lower()
+                hook_text = line[style_end + 1:].strip()
+                hooks.append({
+                    "style": style,
+                    "text": hook_text,
+                    "word_count": len(hook_text.split()),
+                })
+            except Exception:
+                hooks.append({
+                    "style": "unknown",
+                    "text": line,
+                    "word_count": len(line.split()),
+                })
+        elif line and not line.startswith("#"):
+            hooks.append({
+                "style": "unknown",
+                "text": line,
+                "word_count": len(line.split()),
+            })
+    
+    return {
+        "hooks": hooks[:num_variants],
+        "topic": topic,
+        "total_generated": len(hooks),
+    }
+
+
+def rank_hooks(
+    hooks: List[Dict[str, Any]],
+) -> Dict[str, Any]:
+    """
+    Rank hooks by predicted engagement.
+    
+    Args:
+        hooks: List of hook dictionaries
+        
+    Returns:
+        Ranked hooks with scores
+    """
+    ranked = []
+    
+    for hook in hooks:
+        text = hook.get("text", "").lower()
+        score = 0.5
+        
+        # Engagement indicators
+        if "?" in text:
+            score += 0.15  # Questions engage
+        if "you" in text:
+            score += 0.1  # Direct address
+        if any(word in text for word in ["secret", "truth", "actually", "never", "always"]):
+            score += 0.1  # Power words
+        if len(text.split()) <= 10:
+            score += 0.1  # Concise is better
+        
+        # Penalize weak starts
+        weak_starts = ["so", "well", "um", "like", "basically"]
+        if any(text.startswith(w) for w in weak_starts):
+            score -= 0.1
+        
+        ranked.append({
+            **hook,
+            "score": round(min(1.0, max(0.0, score)), 2),
+        })
+    
+    ranked.sort(key=lambda x: x["score"], reverse=True)
+    
+    return {
+        "ranked_hooks": ranked,
+        "best_hook": ranked[0] if ranked else None,
+    }

agent_recipes/templates/ai-image-captioner/README.md

@@ -0,0 +1,59 @@
+# Image Captioner
+
+Generate alt-text/captions for images
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-image-captioner <input>
+
+# With output directory
+praison recipes run ai-image-captioner <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-image-captioner <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-image-captioner
+
+# Check dependencies
+praison recipes doctor ai-image-captioner
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-image-captioner")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`image`, `caption`, `accessibility`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-image-captioner/TEMPLATE.yaml

@@ -0,0 +1,28 @@
+name: ai-image-captioner
+version: "1.0.0"
+description: Generate alt-text/captions for images
+author: praison
+license: Apache-2.0
+tags:
+  - image
+  - caption
+  - accessibility
+
+requires:
+  tools:
+    - vision_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-image-captioner
+  examples:
+    - praison recipes run ai-image-captioner <input>
+    - praison recipes run ai-image-captioner <input> --output ./output/
+    - praison recipes run ai-image-captioner <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true

agent_recipes/templates/ai-image-cataloger/README.md

@@ -0,0 +1,13 @@
+# AI Image Cataloger
+
+Catalog images with AI-generated captions and tags.
+
+## Usage
+```bash
+praison run ai-image-cataloger ./photos/
+```
+
+## Output
+- `catalog.json` - Image metadata with captions
+- `contact-sheet.pdf` - Visual grid
+- `thumbnails/` - Generated thumbnails

agent_recipes/templates/ai-image-cataloger/TEMPLATE.yaml

@@ -0,0 +1,39 @@
+name: ai-image-cataloger
+version: "1.0.0"
+description: Catalog images with AI-generated captions and tags.
+author: praisonai
+license: Apache-2.0
+tags: [image, catalog, captions, tags, vision]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools, Pillow]
+  env: [OPENAI_API_KEY]
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+
+cli:
+  command: ai-image-cataloger
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+  examples:
+    - "praison run ai-image-cataloger ./photos/"
+
+outputs:
+  - name: catalog.json
+    type: file
+  - name: contact-sheet.pdf
+    type: file
+  - name: thumbnails/
+    type: directory
+  - name: run.json
+    type: file

agent_recipes/templates/ai-image-optimizer/README.md

@@ -0,0 +1,13 @@
+# AI Image Optimizer
+
+Optimize images for web with compression and format conversion.
+
+## Usage
+```bash
+praison run ai-image-optimizer ./images/
+praison run ai-image-optimizer photo.jpg --quality 80
+```
+
+## Output
+- `optimized/` - Optimized images
+- `size-report.json` - Size comparison report

agent_recipes/templates/ai-image-optimizer/TEMPLATE.yaml

@@ -0,0 +1,43 @@
+name: ai-image-optimizer
+version: "1.0.0"
+description: Optimize images for web with compression and format conversion.
+author: praisonai
+license: Apache-2.0
+tags: [image, optimization, compression, web]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools, Pillow]
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  quality:
+    type: integer
+    default: 85
+  max_width:
+    type: integer
+
+cli:
+  command: ai-image-optimizer
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --quality
+      default: "85"
+  examples:
+    - "praison run ai-image-optimizer ./images/"
+
+outputs:
+  - name: optimized/
+    type: directory
+  - name: size-report.json
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-image-resizer/README.md

@@ -0,0 +1,12 @@
+# AI Image Resizer
+
+Batch resize images to multiple sizes for web/mobile.
+
+## Usage
+```bash
+praison run ai-image-resizer ./images/
+praison run ai-image-resizer ./images/ --sizes "1920,1280,640"
+```
+
+## Output
+- `resized/` - Resized images in subdirectories

agent_recipes/templates/ai-image-resizer/TEMPLATE.yaml

@@ -0,0 +1,39 @@
+name: ai-image-resizer
+version: "1.0.0"
+description: Batch resize images to multiple sizes for web/mobile.
+author: praisonai
+license: Apache-2.0
+tags: [image, resize, batch, responsive]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools, Pillow]
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  sizes:
+    type: string
+    default: "1920,1280,640,320"
+
+cli:
+  command: ai-image-resizer
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --sizes
+      default: "1920,1280,640,320"
+  examples:
+    - "praison run ai-image-resizer ./images/"
+
+outputs:
+  - name: resized/
+    type: directory
+  - name: run.json
+    type: file

agent_recipes/templates/ai-image-tagger/README.md

@@ -0,0 +1,59 @@
+# Image Tagger
+
+Auto-tag images with keywords/categories
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-image-tagger <input>
+
+# With output directory
+praison recipes run ai-image-tagger <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-image-tagger <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-image-tagger
+
+# Check dependencies
+praison recipes doctor ai-image-tagger
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-image-tagger")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`image`, `tagging`, `classification`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-image-tagger/TEMPLATE.yaml

@@ -0,0 +1,28 @@
+name: ai-image-tagger
+version: "1.0.0"
+description: Auto-tag images with keywords/categories
+author: praison
+license: Apache-2.0
+tags:
+  - image
+  - tagging
+  - classification
+
+requires:
+  tools:
+    - vision_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-image-tagger
+  examples:
+    - praison recipes run ai-image-tagger <input>
+    - praison recipes run ai-image-tagger <input> --output ./output/
+    - praison recipes run ai-image-tagger <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true