agent-recipes 0.0.5__py3-none-any.whl

agent_recipes/templates/ai-post-copy-generator/tools.py

@@ -0,0 +1,105 @@
+"""
+AI Post Copy Generator Tools
+
+Generate platform-specific copy for social media posts.
+"""
+
+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_post_copy(
+    topic: str,
+    platform: str = "x",
+    tone: str = "professional",
+    include_hashtags: bool = True,
+    include_cta: bool = True,
+) -> Dict[str, Any]:
+    """
+    Generate platform-specific post copy.
+    
+    Args:
+        topic: Post topic
+        platform: Target platform
+        tone: Writing tone
+        include_hashtags: Include hashtags
+        include_cta: Include call to action
+        
+    Returns:
+        Dictionary with generated copy
+    """
+    platform_limits = {
+        "x": 280,
+        "linkedin": 3000,
+        "youtube": 5000,
+        "instagram": 2200,
+    }
+    
+    max_length = platform_limits.get(platform, 500)
+    
+    prompt = f"""Write a {platform} post about: {topic}
+
+Requirements:
+- Tone: {tone}
+- Max length: {max_length} characters
+- Platform: {platform}
+{"- Include 3-5 relevant hashtags" if include_hashtags else ""}
+{"- End with a call to action" if include_cta else ""}
+
+Write engaging copy optimized for {platform}:"""
+    
+    try:
+        copy = call_llm(prompt, max_tokens=400)
+        
+        return {
+            "copy": copy.strip(),
+            "platform": platform,
+            "length": len(copy),
+            "within_limit": len(copy) <= max_length,
+        }
+    except Exception as e:
+        logger.error(f"Error generating copy: {e}")
+        return {"error": str(e)}
+
+
+def generate_multi_platform_copy(
+    topic: str,
+    platforms: Optional[List[str]] = None,
+) -> Dict[str, Any]:
+    """
+    Generate copy for multiple platforms.
+    
+    Args:
+        topic: Post topic
+        platforms: Target platforms
+        
+    Returns:
+        Dictionary with copy for each platform
+    """
+    platforms = platforms or ["x", "linkedin", "youtube"]
+    copies = {}
+    
+    for platform in platforms:
+        result = generate_post_copy(topic, platform)
+        copies[platform] = result
+    
+    return {"copies": copies, "topic": topic}

agent_recipes/templates/ai-product-description-generator/README.md

@@ -0,0 +1,59 @@
+# Product Description Generator
+
+Generate e-commerce product descriptions
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-product-description-generator <input>
+
+# With output directory
+praison recipes run ai-product-description-generator <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-product-description-generator <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-product-description-generator
+
+# Check dependencies
+praison recipes doctor ai-product-description-generator
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-product-description-generator")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`web`, `ecommerce`, `product`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-product-description-generator/TEMPLATE.yaml

@@ -0,0 +1,28 @@
+name: ai-product-description-generator
+version: "1.0.0"
+description: Generate e-commerce product descriptions
+author: praison
+license: Apache-2.0
+tags:
+  - web
+  - ecommerce
+  - product
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-product-description-generator
+  examples:
+    - praison recipes run ai-product-description-generator <input>
+    - praison recipes run ai-product-description-generator <input> --output ./output/
+    - praison recipes run ai-product-description-generator <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true

agent_recipes/templates/ai-publisher-pack/recipe.yaml

@@ -0,0 +1,44 @@
+name: ai-publisher-pack
+version: 1.0.0
+description: Generate cross-platform publisher packs with ready-to-upload files and metadata
+author: PraisonAI
+tags:
+  - publishing
+  - distribution
+  - multi-platform
+
+config:
+  platforms:
+    - youtube
+    - x
+    - linkedin
+    - instagram
+    - tiktok
+  include_metadata: true
+  include_thumbnails: true
+
+input:
+  type: object
+  properties:
+    content:
+      type: object
+    platforms:
+      type: array
+
+output:
+  type: object
+  properties:
+    packs:
+      type: array
+
+requires:
+  env:
+    - OPENAI_API_KEY
+
+workflow:
+  agents:
+    - name: publisher
+      role: Content Publisher
+      tools:
+        - create_publisher_pack
+        - generate_platform_assets

agent_recipes/templates/ai-publisher-pack/tools.py

@@ -0,0 +1,252 @@
+"""
+AI Publisher Pack Tools
+
+Create cross-platform publishing packs:
+- Platform-specific metadata
+- Optimized assets
+- Ready-to-upload bundles
+"""
+
+import json
+import logging
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def create_publisher_pack(
+    content: Dict[str, Any],
+    platforms: Optional[List[str]] = None,
+    output_dir: Optional[str] = None,
+) -> Dict[str, Any]:
+    """
+    Create a publisher pack for multiple platforms.
+    
+    Args:
+        content: Content dictionary with title, description, video, etc.
+        platforms: Target platforms
+        output_dir: Output directory
+        
+    Returns:
+        Dictionary with pack info
+    """
+    platforms = platforms or ["youtube", "x", "linkedin"]
+    output_dir = output_dir or "./publisher_packs"
+    
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    pack_dir = os.path.join(output_dir, f"pack_{timestamp}")
+    Path(pack_dir).mkdir(parents=True, exist_ok=True)
+    
+    packs = []
+    
+    for platform in platforms:
+        platform_dir = os.path.join(pack_dir, platform)
+        Path(platform_dir).mkdir(parents=True, exist_ok=True)
+        
+        # Generate platform-specific metadata
+        metadata = generate_platform_metadata(content, platform)
+        
+        # Save metadata
+        metadata_path = os.path.join(platform_dir, "metadata.json")
+        with open(metadata_path, "w") as f:
+            json.dump(metadata, f, indent=2)
+        
+        # Create upload instructions
+        instructions = generate_upload_instructions(platform, metadata)
+        instructions_path = os.path.join(platform_dir, "UPLOAD_INSTRUCTIONS.md")
+        with open(instructions_path, "w") as f:
+            f.write(instructions)
+        
+        packs.append({
+            "platform": platform,
+            "directory": platform_dir,
+            "metadata": metadata,
+        })
+    
+    # Create master manifest
+    manifest = {
+        "created_at": datetime.now(timezone.utc).isoformat(),
+        "platforms": platforms,
+        "packs": [{
+            "platform": p["platform"],
+            "directory": p["directory"],
+        } for p in packs],
+    }
+    
+    manifest_path = os.path.join(pack_dir, "manifest.json")
+    with open(manifest_path, "w") as f:
+        json.dump(manifest, f, indent=2)
+    
+    return {
+        "pack_dir": pack_dir,
+        "packs": packs,
+        "manifest": manifest_path,
+    }
+
+
+def generate_platform_metadata(
+    content: Dict[str, Any],
+    platform: str,
+) -> Dict[str, Any]:
+    """
+    Generate platform-specific metadata.
+    
+    Args:
+        content: Source content
+        platform: Target platform
+        
+    Returns:
+        Platform-specific metadata
+    """
+    title = content.get("title", "Untitled")
+    description = content.get("description", "")
+    tags = content.get("tags", [])
+    
+    platform_configs = {
+        "youtube": {
+            "title": title[:100],
+            "description": description[:5000],
+            "tags": tags[:500],
+            "category": content.get("category", "22"),  # People & Blogs
+            "privacy": "public",
+            "made_for_kids": False,
+        },
+        "x": {
+            "text": f"{title}\n\n{description[:200]}",
+            "hashtags": [f"#{t}" for t in tags[:5]],
+            "max_length": 280,
+        },
+        "linkedin": {
+            "title": title[:200],
+            "text": description[:3000],
+            "hashtags": [f"#{t}" for t in tags[:5]],
+        },
+        "instagram": {
+            "caption": f"{title}\n\n{description[:2000]}",
+            "hashtags": [f"#{t}" for t in tags[:30]],
+        },
+        "tiktok": {
+            "caption": f"{title} {' '.join([f'#{t}' for t in tags[:5]])}",
+            "max_length": 150,
+        },
+    }
+    
+    return platform_configs.get(platform, {"title": title, "description": description})
+
+
+def generate_upload_instructions(
+    platform: str,
+    metadata: Dict[str, Any],
+) -> str:
+    """
+    Generate upload instructions for a platform.
+    
+    Args:
+        platform: Target platform
+        metadata: Platform metadata
+        
+    Returns:
+        Markdown instructions
+    """
+    instructions = {
+        "youtube": f"""# YouTube Upload Instructions
+
+1. Go to YouTube Studio: https://studio.youtube.com
+2. Click "Create" > "Upload videos"
+3. Select your video file
+4. Fill in the following:
+
+**Title:** {metadata.get('title', '')}
+
+**Description:**
+{metadata.get('description', '')}
+
+**Tags:** {', '.join(metadata.get('tags', [])[:10])}
+
+5. Set visibility to: {metadata.get('privacy', 'public')}
+6. Click "Publish"
+""",
+        "x": f"""# X (Twitter) Post Instructions
+
+1. Go to X: https://x.com/compose/tweet
+2. Paste the following text:
+
+{metadata.get('text', '')}
+
+3. Attach your media file
+4. Click "Post"
+""",
+        "linkedin": f"""# LinkedIn Post Instructions
+
+1. Go to LinkedIn: https://www.linkedin.com/feed/
+2. Click "Start a post"
+3. Paste the following:
+
+{metadata.get('title', '')}
+
+{metadata.get('text', '')}
+
+{' '.join(metadata.get('hashtags', []))}
+
+4. Add your media
+5. Click "Post"
+""",
+    }
+    
+    return instructions.get(platform, f"# {platform.title()} Upload\n\nUpload your content to {platform}.")
+
+
+def generate_platform_assets(
+    video_path: str,
+    platforms: List[str],
+    output_dir: str,
+) -> Dict[str, Any]:
+    """
+    Generate platform-optimized video assets.
+    
+    Args:
+        video_path: Source video path
+        platforms: Target platforms
+        output_dir: Output directory
+        
+    Returns:
+        Dictionary with generated assets
+    """
+    import subprocess
+    
+    assets = []
+    
+    platform_specs = {
+        "youtube": {"resolution": "1920x1080", "aspect": "16:9"},
+        "instagram": {"resolution": "1080x1080", "aspect": "1:1"},
+        "tiktok": {"resolution": "1080x1920", "aspect": "9:16"},
+        "x": {"resolution": "1280x720", "aspect": "16:9"},
+    }
+    
+    for platform in platforms:
+        spec = platform_specs.get(platform, platform_specs["youtube"])
+        output_path = os.path.join(output_dir, f"{platform}_video.mp4")
+        
+        try:
+            cmd = [
+                "ffmpeg", "-y",
+                "-i", video_path,
+                "-vf", f"scale={spec['resolution'].replace('x', ':')}:force_original_aspect_ratio=decrease,pad={spec['resolution'].replace('x', ':')}:(ow-iw)/2:(oh-ih)/2",
+                "-c:v", "libx264",
+                "-c:a", "aac",
+                output_path
+            ]
+            subprocess.run(cmd, capture_output=True, check=True)
+            
+            assets.append({
+                "platform": platform,
+                "path": output_path,
+                "spec": spec,
+            })
+        except Exception as e:
+            logger.warning(f"Error creating {platform} asset: {e}")
+    
+    return {"assets": assets}

agent_recipes/templates/ai-qr-code-generator/README.md

@@ -0,0 +1,60 @@
+# Qr Code Generator
+
+Generate QR codes from data
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-qr-code-generator <input>
+
+# With output directory
+praison recipes run ai-qr-code-generator <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-qr-code-generator <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-qr-code-generator
+
+# Check dependencies
+praison recipes doctor ai-qr-code-generator
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-qr-code-generator")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- qrcode
+- pillow
+
+### Environment Variables
+- None
+
+### External Tools
+- None
+
+## Tags
+
+`productivity`, `qr-code`, `generation`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-qr-code-generator/TEMPLATE.yaml

@@ -0,0 +1,26 @@
+name: ai-qr-code-generator
+version: "1.0.0"
+description: Generate QR codes from data
+author: praison
+license: Apache-2.0
+tags:
+  - productivity
+  - qr-code
+  - generation
+
+requires:
+  tools:
+  packages:
+    - qrcode
+    - pillow
+
+cli:
+  command: praison recipes run ai-qr-code-generator
+  examples:
+    - praison recipes run ai-qr-code-generator <input>
+    - praison recipes run ai-qr-code-generator <input> --output ./output/
+    - praison recipes run ai-qr-code-generator <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true

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

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

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

@@ -0,0 +1,28 @@
+name: ai-regex-generator
+version: "1.0.0"
+description: Generate regex patterns from descriptions
+author: praison
+license: Apache-2.0
+tags:
+  - code
+  - regex
+  - patterns
+
+requires:
+  tools:
+    - llm_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-regex-generator
+  examples:
+    - praison recipes run ai-regex-generator <input>
+    - praison recipes run ai-regex-generator <input> --output ./output/
+    - praison recipes run ai-regex-generator <input> --dry-run
+
+safety:
+  dry_run_default: false
+  overwrites_files: true

agent_recipes/templates/ai-repo-readme/README.md

@@ -0,0 +1,13 @@
+# AI Repo README
+
+Generate or update README.md for a git repository.
+
+## Usage
+```bash
+praison run ai-repo-readme ./my-project
+praison run ai-repo-readme ./my-project --update
+```
+
+## Output
+- `README.md` - Generated/updated README
+- `structure.json` - Repository structure analysis