agent-recipes 0.0.5__py3-none-any.whl

agent_recipes/templates/ai-fact-checker/tools.py

@@ -0,0 +1,279 @@
+"""
+AI Fact Checker Tools
+
+Verify content accuracy with:
+- Claim extraction
+- Source verification
+- Citation linking
+- Confidence scoring
+"""
+
+import logging
+import os
+from typing import Any, Dict, List, Optional
+
+logger = logging.getLogger(__name__)
+
+
+def call_llm(prompt: str, max_tokens: int = 1000) -> 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.3,
+        },
+        timeout=60,
+    )
+    response.raise_for_status()
+    return response.json()["choices"][0]["message"]["content"]
+
+
+def extract_claims(
+    content: str,
+    claim_types: Optional[List[str]] = None,
+) -> Dict[str, Any]:
+    """
+    Extract verifiable claims from content.
+    
+    Args:
+        content: Text content to analyze
+        claim_types: Types of claims to extract
+        
+    Returns:
+        Dictionary with extracted claims
+    """
+    claim_types = claim_types or ["factual", "statistical", "quote", "date"]
+    
+    prompt = f"""Extract all verifiable claims from this content:
+
+{content[:3000]}
+
+For each claim, identify:
+1. The claim text
+2. Claim type (factual, statistical, quote, date, attribution)
+3. Confidence that this is a verifiable claim (HIGH/MEDIUM/LOW)
+
+Format as:
+CLAIM: [claim text]
+TYPE: [type]
+CONFIDENCE: [level]
+---"""
+    
+    result = call_llm(prompt, max_tokens=1500)
+    
+    claims = []
+    current_claim = {}
+    
+    for line in result.split("\n"):
+        line = line.strip()
+        if line.startswith("CLAIM:"):
+            if current_claim:
+                claims.append(current_claim)
+            current_claim = {"claim": line[6:].strip()}
+        elif line.startswith("TYPE:"):
+            current_claim["type"] = line[5:].strip().lower()
+        elif line.startswith("CONFIDENCE:"):
+            current_claim["confidence"] = line[11:].strip().upper()
+        elif line == "---" and current_claim:
+            claims.append(current_claim)
+            current_claim = {}
+    
+    if current_claim and "claim" in current_claim:
+        claims.append(current_claim)
+    
+    return {
+        "claims": claims,
+        "total_claims": len(claims),
+    }
+
+
+def verify_claims(
+    claims: List[Dict[str, Any]],
+) -> Dict[str, Any]:
+    """
+    Verify extracted claims.
+    
+    Args:
+        claims: List of claim dictionaries
+        
+    Returns:
+        Dictionary with verification results
+    """
+    verified = []
+    
+    for claim in claims:
+        claim_text = claim.get("claim", "")
+        
+        prompt = f"""Verify this claim and assess its accuracy:
+
+Claim: {claim_text}
+
+Provide:
+1. VERDICT: TRUE / FALSE / PARTIALLY TRUE / UNVERIFIABLE
+2. EXPLANATION: Brief explanation (1-2 sentences)
+3. SUGGESTED_SOURCE: Type of source that could verify this
+
+Format:
+VERDICT: [verdict]
+EXPLANATION: [explanation]
+SUGGESTED_SOURCE: [source type]"""
+        
+        try:
+            result = call_llm(prompt, max_tokens=300)
+            
+            verification = {
+                **claim,
+                "verdict": "UNVERIFIABLE",
+                "explanation": "",
+                "suggested_source": "",
+            }
+            
+            for line in result.split("\n"):
+                line = line.strip()
+                if line.startswith("VERDICT:"):
+                    verification["verdict"] = line[8:].strip().upper()
+                elif line.startswith("EXPLANATION:"):
+                    verification["explanation"] = line[12:].strip()
+                elif line.startswith("SUGGESTED_SOURCE:"):
+                    verification["suggested_source"] = line[17:].strip()
+            
+            verified.append(verification)
+            
+        except Exception as e:
+            logger.warning(f"Error verifying claim: {e}")
+            verified.append({
+                **claim,
+                "verdict": "ERROR",
+                "explanation": str(e),
+            })
+    
+    # Generate flags for problematic claims
+    flags = []
+    for v in verified:
+        if v.get("verdict") in ["FALSE", "PARTIALLY TRUE"]:
+            flags.append({
+                "claim": v.get("claim", ""),
+                "issue": v.get("verdict"),
+                "explanation": v.get("explanation", ""),
+            })
+    
+    return {
+        "verified_claims": verified,
+        "flags": flags,
+        "stats": {
+            "total": len(verified),
+            "true": sum(1 for v in verified if v.get("verdict") == "TRUE"),
+            "false": sum(1 for v in verified if v.get("verdict") == "FALSE"),
+            "partial": sum(1 for v in verified if v.get("verdict") == "PARTIALLY TRUE"),
+            "unverifiable": sum(1 for v in verified if v.get("verdict") == "UNVERIFIABLE"),
+        }
+    }
+
+
+def find_citations(
+    claims: List[Dict[str, Any]],
+    use_web_search: bool = True,
+) -> Dict[str, Any]:
+    """
+    Find citation sources for claims.
+    
+    Args:
+        claims: List of claim dictionaries
+        use_web_search: Use web search for citations
+        
+    Returns:
+        Dictionary with citations
+    """
+    citations = []
+    
+    # Check for Tavily API
+    tavily_key = os.environ.get("TAVILY_API_KEY")
+    
+    for claim in claims:
+        claim_text = claim.get("claim", "")
+        
+        citation = {
+            "claim": claim_text,
+            "sources": [],
+        }
+        
+        if use_web_search and tavily_key:
+            try:
+                import requests
+                
+                response = requests.post(
+                    "https://api.tavily.com/search",
+                    json={
+                        "api_key": tavily_key,
+                        "query": f"verify: {claim_text}",
+                        "search_depth": "basic",
+                        "max_results": 3,
+                    },
+                    timeout=30,
+                )
+                response.raise_for_status()
+                data = response.json()
+                
+                for result in data.get("results", []):
+                    citation["sources"].append({
+                        "title": result.get("title", ""),
+                        "url": result.get("url", ""),
+                        "snippet": result.get("content", "")[:200],
+                    })
+                    
+            except Exception as e:
+                logger.warning(f"Error searching for citation: {e}")
+        
+        citations.append(citation)
+    
+    return {
+        "citations": citations,
+        "total_sources": sum(len(c["sources"]) for c in citations),
+    }
+
+
+def fact_check_content(
+    content: str,
+    include_citations: bool = True,
+) -> Dict[str, Any]:
+    """
+    Full fact-checking pipeline.
+    
+    Args:
+        content: Content to fact-check
+        include_citations: Include source citations
+        
+    Returns:
+        Complete fact-check report
+    """
+    # Extract claims
+    extraction = extract_claims(content)
+    claims = extraction.get("claims", [])
+    
+    # Verify claims
+    verification = verify_claims(claims)
+    
+    # Find citations if requested
+    citations = {}
+    if include_citations:
+        citations = find_citations(claims)
+    
+    return {
+        "claims": verification.get("verified_claims", []),
+        "flags": verification.get("flags", []),
+        "citations": citations.get("citations", []),
+        "stats": verification.get("stats", {}),
+    }

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

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

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

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

agent_recipes/templates/ai-file-organizer/README.md

@@ -0,0 +1,59 @@
+# File Organizer
+
+Auto-organize files into folders by content
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-file-organizer <input>
+
+# With output directory
+praison recipes run ai-file-organizer <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-file-organizer <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-file-organizer
+
+# Check dependencies
+praison recipes doctor ai-file-organizer
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-file-organizer")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`productivity`, `files`, `organization`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-file-organizer/TEMPLATE.yaml

@@ -0,0 +1,29 @@
+name: ai-file-organizer
+version: "1.0.0"
+description: Auto-organize files into folders by content
+author: praison
+license: Apache-2.0
+tags:
+  - productivity
+  - files
+  - organization
+
+requires:
+  tools:
+    - llm_tool
+    - vision_tool
+  packages:
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-file-organizer
+  examples:
+    - praison recipes run ai-file-organizer <input>
+    - praison recipes run ai-file-organizer <input> --output ./output/
+    - praison recipes run ai-file-organizer <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true

agent_recipes/templates/ai-folder-packager/README.md

@@ -0,0 +1,15 @@
+# AI Folder Packager
+
+Package folder into distributable archive with manifest and checksums.
+
+## Usage
+```bash
+praison run ai-folder-packager ./my-project
+praison run ai-folder-packager ./my-project --format tar.gz
+```
+
+## Output
+- `package.zip` - Archive file
+- `manifest.json` - File list with hashes
+- `checksums.txt` - SHA256 checksums
+- `README.txt` - Auto-generated description

agent_recipes/templates/ai-folder-packager/TEMPLATE.yaml

@@ -0,0 +1,48 @@
+name: ai-folder-packager
+version: "1.0.0"
+description: Package folder into distributable archive with manifest and checksums.
+author: praisonai
+license: Apache-2.0
+tags: [archive, packaging, distribution, checksums]
+
+requires:
+  tools: [shell_tool]
+  packages: [praisonai-tools]
+  env: [OPENAI_API_KEY]
+
+config:
+  input:
+    type: string
+    required: true
+  output:
+    type: string
+  format:
+    type: string
+    default: "zip"
+    enum: [zip, tar.gz, tar.bz2]
+
+cli:
+  command: ai-folder-packager
+  args:
+    - name: input
+      positional: true
+      required: true
+    - name: --output
+      short: -o
+    - name: --format
+      default: "zip"
+  examples:
+    - "praison run ai-folder-packager ./my-project"
+    - "praison run ai-folder-packager ./my-project --format tar.gz"
+
+outputs:
+  - name: package.zip
+    type: file
+  - name: manifest.json
+    type: file
+  - name: checksums.txt
+    type: file
+  - name: README.txt
+    type: file
+  - name: run.json
+    type: file

agent_recipes/templates/ai-form-filler/README.md

@@ -0,0 +1,60 @@
+# Form Filler
+
+Auto-fill PDF forms from data sources
+
+## Installation
+
+```bash
+pip install agent-recipes
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+praison recipes run ai-form-filler <input>
+
+# With output directory
+praison recipes run ai-form-filler <input> --output ./output/
+
+# Dry run (check dependencies only)
+praison recipes run ai-form-filler <input> --dry-run
+
+# Show recipe info
+praison recipes info ai-form-filler
+
+# Check dependencies
+praison recipes doctor ai-form-filler
+```
+
+## Python Usage
+
+```python
+from praisonaiagents import Agent
+from agent_recipes import load_recipe
+
+# Load and run recipe
+recipe = load_recipe("ai-form-filler")
+result = recipe.run(input="<your-input>")
+print(result)
+```
+
+## Requirements
+
+### Packages
+- pypdf
+- openai
+
+### Environment Variables
+- OPENAI_API_KEY
+
+### External Tools
+- None
+
+## Tags
+
+`document`, `pdf`, `forms`
+
+## License
+
+Apache-2.0

agent_recipes/templates/ai-form-filler/TEMPLATE.yaml

@@ -0,0 +1,30 @@
+name: ai-form-filler
+version: "1.0.0"
+description: Auto-fill PDF forms from data sources
+author: praison
+license: Apache-2.0
+tags:
+  - document
+  - pdf
+  - forms
+
+requires:
+  tools:
+    - doc_tool
+    - llm_tool
+  packages:
+    - pypdf
+    - openai
+  env:
+    - OPENAI_API_KEY
+
+cli:
+  command: praison recipes run ai-form-filler
+  examples:
+    - praison recipes run ai-form-filler <input>
+    - praison recipes run ai-form-filler <input> --output ./output/
+    - praison recipes run ai-form-filler <input> --dry-run
+
+safety:
+  dry_run_default: true
+  overwrites_files: true

agent_recipes/templates/ai-hashtag-optimizer/recipe.yaml

@@ -0,0 +1,45 @@
+name: ai-hashtag-optimizer
+version: 1.0.0
+description: Optimize hashtags and keywords for maximum reach
+author: PraisonAI
+tags:
+  - hashtags
+  - keywords
+  - seo
+  - optimization
+
+config:
+  max_hashtags: 30
+  platforms:
+    - instagram
+    - x
+    - linkedin
+    - tiktok
+
+input:
+  type: object
+  properties:
+    topic:
+      type: string
+    platform:
+      type: string
+
+output:
+  type: object
+  properties:
+    hashtags:
+      type: array
+    keywords:
+      type: array
+
+requires:
+  env:
+    - OPENAI_API_KEY
+
+workflow:
+  agents:
+    - name: optimizer
+      role: Hashtag Optimizer
+      tools:
+        - generate_hashtags
+        - optimize_keywords