chore: bump praisonai and praisonaiagents package versions

fix: Add base_url and api_key parameters to Agent class for Ollama support

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Environment
+- Provider (select one):
+  - [ ] Anthropic
+  - [ ] OpenAI
+  - [ ] Google Vertex AI
+  - [ ] AWS Bedrock
+  - [ ] Other: <!-- specify -->
+- PraisonAI version: <!-- if known -->
+- Operating System: <!-- e.g. macOS 14.3, Windows 11, Ubuntu 22.04 -->
+
+## Full Code
+<!-- Full code that reproduces the bug -->
+
+## Steps to Reproduce
+1. <!-- First step -->
+2. <!-- Second step -->
+3. <!-- And so on... -->
+
+## Expected Behavior
+<!-- What you expected to happen -->
+
+## Actual Behavior
+<!-- What actually happened -->
+
+## Additional Context
+<!-- Add any other context about the problem here, such as screenshots, logs, etc. --> 

.github/actions/claude-code-action/action.yml

@@ -0,0 +1,240 @@
+name: "Claude Code Action"
+description: "Run Claude Code in GitHub Actions workflows"
+
+inputs:
+  anthropic_api_key:
+    description: "Anthropic API key"
+    required: false
+  github_token:
+    description: "GitHub token for Claude to operate with"
+    required: false
+    default: ${{ github.token }}
+  trigger_phrase:
+    description: "The trigger phrase to look for in comments, issue/PR bodies, and issue titles"
+    required: false
+    default: "@claude"
+  assignee_trigger:
+    description: "The assignee username that triggers the action (e.g. @claude). Only used for issue assignment"
+    required: false
+  max_turns:
+    description: "Maximum number of conversation turns Claude can take"
+    required: false
+  timeout_minutes:
+    description: "Timeout in minutes for execution"
+    required: false
+    default: "30"
+  model:
+    description: "Model to use (provider-specific format required for Bedrock/Vertex)"
+    required: false
+  use_bedrock:
+    description: "Use Amazon Bedrock with OIDC authentication instead of direct Anthropic API"
+    required: false
+    default: "false"
+  use_vertex:
+    description: "Use Google Vertex AI with OIDC authentication instead of direct Anthropic API"
+    required: false
+    default: "false"
+  allowed_tools:
+    description: "Additional tools for Claude to use (the base GitHub tools will always be included)"
+    required: false
+    default: ""
+  disallowed_tools:
+    description: "Tools that Claude should never use"
+    required: false
+    default: ""
+  custom_instructions:
+    description: "Additional custom instructions to include in the prompt for Claude"
+    required: false
+    default: ""
+  mcp_config:
+    description: "Additional MCP configuration (JSON string) that merges with the built-in GitHub MCP servers"
+    required: false
+    default: ""
+  claude_env:
+    description: "Custom environment variables to pass to Claude Code execution (YAML format)"
+    required: false
+    default: ""
+  direct_prompt:
+    description: "Direct prompt for Claude to execute automatically without needing a trigger (for automated workflows)"
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install Claude Code
+      shell: bash
+      run: npm install -g @anthropic-ai/claude-code
+
+    - name: Install GitHub MCP Server
+      shell: bash
+      run: |
+        claude mcp add-json github '{
+          "command": "docker",
+          "args": [
+            "run",
+            "-i",
+            "--rm",
+            "-e",
+            "GITHUB_PERSONAL_ACCESS_TOKEN",
+            "ghcr.io/github/github-mcp-server:sha-ff3036d"
+          ],
+          "env": {
+            "GITHUB_PERSONAL_ACCESS_TOKEN": "${{ inputs.github_token }}"
+          }
+        }'
+
+    - name: Extract GitHub Context and Create Prompt
+      shell: bash
+      id: prepare_context
+      run: |
+        echo "🔍 Extracting GitHub context from event: ${{ github.event_name }}"
+        
+        # Function to check for trigger phrase
+        check_trigger() {
+          local text="$1"
+          local trigger="${{ inputs.trigger_phrase }}"
+          if [[ "$text" == *"$trigger"* ]]; then
+            return 0
+          fi
+          return 1
+        }
+        
+        # Extract context based on event type
+        TRIGGER_FOUND="false"
+        USER_REQUEST=""
+        CONTEXT_INFO=""
+        
+        case "${{ github.event_name }}" in
+          "issue_comment")
+            COMMENT_BODY="${{ github.event.comment.body }}"
+            ISSUE_TITLE="${{ github.event.issue.title }}"
+            ISSUE_NUMBER="${{ github.event.issue.number }}"
+            
+            if check_trigger "$COMMENT_BODY"; then
+              TRIGGER_FOUND="true"
+              USER_REQUEST="$COMMENT_BODY"
+              CONTEXT_INFO="Issue Comment on #$ISSUE_NUMBER: $ISSUE_TITLE"
+            fi
+            ;;
+            
+          "pull_request_review_comment")
+            COMMENT_BODY="${{ github.event.comment.body }}"
+            PR_TITLE="${{ github.event.pull_request.title }}"
+            PR_NUMBER="${{ github.event.pull_request.number }}"
+            
+            if check_trigger "$COMMENT_BODY"; then
+              TRIGGER_FOUND="true"
+              USER_REQUEST="$COMMENT_BODY"
+              CONTEXT_INFO="PR Comment on #$PR_NUMBER: $PR_TITLE"
+            fi
+            ;;
+            
+          "pull_request_review")
+            REVIEW_BODY="${{ github.event.review.body }}"
+            PR_TITLE="${{ github.event.pull_request.title }}"
+            PR_NUMBER="${{ github.event.pull_request.number }}"
+            
+            if check_trigger "$REVIEW_BODY"; then
+              TRIGGER_FOUND="true"
+              USER_REQUEST="$REVIEW_BODY"
+              CONTEXT_INFO="PR Review on #$PR_NUMBER: $PR_TITLE"
+            fi
+            ;;
+            
+          "issues")
+            ISSUE_BODY="${{ github.event.issue.body }}"
+            ISSUE_TITLE="${{ github.event.issue.title }}"
+            ISSUE_NUMBER="${{ github.event.issue.number }}"
+            
+            if check_trigger "$ISSUE_TITLE" || check_trigger "$ISSUE_BODY"; then
+              TRIGGER_FOUND="true"
+              USER_REQUEST="$ISSUE_BODY"
+              CONTEXT_INFO="Issue #$ISSUE_NUMBER: $ISSUE_TITLE"
+            elif [[ "${{ github.event.action }}" == "assigned" && -n "${{ inputs.assignee_trigger }}" ]]; then
+              ASSIGNEE="${{ github.event.assignee.login }}"
+              if [[ "$ASSIGNEE" == "${{ inputs.assignee_trigger }}" ]]; then
+                TRIGGER_FOUND="true"
+                USER_REQUEST="$ISSUE_BODY"
+                CONTEXT_INFO="Issue #$ISSUE_NUMBER assigned to $ASSIGNEE: $ISSUE_TITLE"
+              fi
+            fi
+            ;;
+        esac
+        
+        # Check for direct prompt override
+        if [[ -n "${{ inputs.direct_prompt }}" ]]; then
+          TRIGGER_FOUND="true"
+          USER_REQUEST="${{ inputs.direct_prompt }}"
+          CONTEXT_INFO="Automated GitHub workflow"
+        fi
+        
+        if [[ "$TRIGGER_FOUND" != "true" ]]; then
+          echo "❌ No trigger phrase found or direct prompt provided. Exiting gracefully."
+          echo "SKIP_EXECUTION=true" >> $GITHUB_ENV
+          exit 0
+        fi
+        
+        echo "✅ Trigger found! Context: $CONTEXT_INFO"
+        
+        # Create comprehensive prompt
+        mkdir -p /tmp/claude-action
+        cat > /tmp/claude-action/github-context-prompt.txt << EOF
+        You are Claude Code, an AI assistant helping with GitHub workflows and code.
+        
+        Repository: ${{ github.repository }}
+        Context: $CONTEXT_INFO
+        Event: ${{ github.event_name }}
+        
+        User Request:
+        $USER_REQUEST
+        
+        Please analyze the request and provide helpful assistance. You have access to repository tools and can help with:
+        - Code analysis and implementation
+        - GitHub workflows and automation
+        - Pull request reviews and feedback
+        - Issue resolution and bug fixes
+        - Documentation updates
+        - Testing and deployment
+        
+        Respond naturally and helpfully to the user's request using the available tools.
+        EOF
+        
+        echo "PROMPT_FILE=/tmp/claude-action/github-context-prompt.txt" >> $GITHUB_ENV
+        echo "SKIP_EXECUTION=false" >> $GITHUB_ENV
+
+    - name: Run Claude Code
+      if: env.SKIP_EXECUTION != 'true'
+      shell: bash
+      run: |
+        echo "🚀 Running Claude Code with GitHub context..."
+        
+        # Build command arguments
+        CMD_ARGS=("-p" "--verbose" "--output-format" "stream-json")
+        
+        # Add max turns if specified
+        if [[ -n "${{ inputs.max_turns }}" ]]; then
+          CMD_ARGS+=("--max-turns" "${{ inputs.max_turns }}")
+        fi
+        
+        # Add allowed tools (include GitHub tools by default)
+        TOOLS="mcp__github__get_issue,mcp__github__get_issue_comments,mcp__github__update_issue,mcp__github__search_issues,mcp__github__list_issues,mcp__github__create_comment,Read,Write,Edit,Bash"
+        if [[ -n "${{ inputs.allowed_tools }}" ]]; then
+          TOOLS="$TOOLS,${{ inputs.allowed_tools }}"
+        fi
+        CMD_ARGS+=("--allowedTools" "$TOOLS")
+        
+        # Add disallowed tools
+        if [[ -n "${{ inputs.disallowed_tools }}" ]]; then
+          CMD_ARGS+=("--disallowedTools" "${{ inputs.disallowed_tools }}")
+        fi
+        
+        echo "📝 Executing Claude Code with prompt from file..."
+        
+        # Execute Claude Code with timeout, using stdin for the prompt
+        TIMEOUT_SECONDS=$((${{ inputs.timeout_minutes }} * 60))
+        timeout $TIMEOUT_SECONDS claude "${CMD_ARGS[@]}" < "${{ env.PROMPT_FILE }}"
+        
+        echo "✅ Claude Code execution completed"
+      env:
+        ANTHROPIC_API_KEY: ${{ inputs.anthropic_api_key }}
+        GITHUB_TOKEN: ${{ inputs.github_token }} 

.github/actions/claude-issue-triage-action/action.yml

@@ -0,0 +1,87 @@
+name: "Claude Issue Triage Action"
+description: "Automatically triage GitHub issues using Claude Code"
+
+inputs:
+  timeout_minutes:
+    description: "Timeout in minutes for execution"
+    required: false
+    default: "5"
+  anthropic_api_key:
+    description: "Anthropic API key"
+    required: true
+  github_token:
+    description: "GitHub token with repo and issues permissions"
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Checkout repository code
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Create prompt file
+      shell: bash
+      run: |
+        mkdir -p /tmp/claude-prompts
+        cat > /tmp/claude-prompts/claude-issue-triage-prompt.txt << 'EOF'
+        You're an issue triage assistant for GitHub issues. Your task is to analyze the issue and select appropriate labels from the provided list.
+
+        IMPORTANT: Don't post any comments or messages to the issue. Your only action should be to apply labels.
+
+        Issue Information:
+        - REPO: ${{ github.repository }}
+        - ISSUE_NUMBER: ${{ github.event.issue.number }}
+
+        TASK OVERVIEW:
+
+        1. First, fetch the list of labels available in this repository by running: `gh label list`. Run exactly this command with nothing else.
+
+        2. Next, use the GitHub tools to get context about the issue:
+           - You have access to these tools:
+             - mcp__github__get_issue: Use this to retrieve the current issue's details including title, description, and existing labels
+             - mcp__github__get_issue_comments: Use this to read any discussion or additional context provided in the comments
+             - mcp__github__update_issue: Use this to apply labels to the issue (do not use this for commenting)
+             - mcp__github__search_issues: Use this to find similar issues that might provide context for proper categorization and to identify potential duplicate issues
+             - mcp__github__list_issues: Use this to understand patterns in how other issues are labeled
+           - Start by using mcp__github__get_issue to get the issue details
+
+        3. Analyze the issue content, considering:
+           - The issue title and description
+           - The type of issue (bug report, feature request, question, etc.)
+           - Technical areas mentioned
+           - Severity or priority indicators
+           - User impact
+           - Components affected
+
+        4. Select appropriate labels from the available labels list provided above:
+           - Choose labels that accurately reflect the issue's nature
+           - Be specific but comprehensive
+           - Select priority labels if you can determine urgency (high-priority, med-priority, or low-priority)
+           - Consider platform labels (android, ios) if applicable
+           - If you find similar issues using mcp__github__search_issues, consider using a "duplicate" label if appropriate. Only do so if the issue is a duplicate of another OPEN issue.
+
+        5. Apply the selected labels:
+           - Use mcp__github__update_issue to apply your selected labels
+           - DO NOT post any comments explaining your decision
+           - DO NOT communicate directly with users
+           - If no labels are clearly applicable, do not apply any labels
+
+        IMPORTANT GUIDELINES:
+        - Be thorough in your analysis
+        - Only select labels from the provided list above
+        - DO NOT post any comments to the issue
+        - Your ONLY action should be to apply labels using mcp__github__update_issue
+        - It's okay to not add any labels if none are clearly applicable
+        EOF
+
+    - name: Run Claude Code
+      uses: ./.github/actions/claude-code-action
+      with:
+        prompt_file: /tmp/claude-prompts/claude-issue-triage-prompt.txt
+        allowed_tools: "Bash(gh label list),mcp__github__get_issue,mcp__github__get_issue_comments,mcp__github__update_issue,mcp__github__search_issues,mcp__github__list_issues"
+        install_github_mcp: "true"
+        timeout_minutes: ${{ inputs.timeout_minutes }}
+        anthropic_api_key: ${{ inputs.anthropic_api_key }}
+        github_token: ${{ inputs.github_token }} 

.github/workflows/build-image.yml

@@ -0,0 +1,40 @@
+name: Build Claude Code Image
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Image version tag'
+        required: true
+        default: 'latest'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GH_TOKEN }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: ./.github/actions/claude-code-action
+          push: true
+          platforms: linux/amd64
+          tags: ghcr.io/mervinpraison/praisonai-claudecode:${{ inputs.version }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          provenance: false 

.github/workflows/claude-issue-triage.yml

@@ -0,0 +1,23 @@
+name: Claude Issue Triage
+description: "Automatically triage GitHub issues using Claude Code"
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  triage-issue:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      issues: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4
+
+      - name: Run Claude Issue Triage
+        uses: ./.github/actions/claude-issue-triage-action
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github_token: ${{ secrets.GITHUB_TOKEN }} 

.github/workflows/claude.yml

@@ -29,9 +29,11 @@ jobs:
         with:
           fetch-depth: 1
 
-      - name: Run Claude Code
+      - name: Run Claude Code (OAuth)
         id: claude
-        uses: anthropics/claude-code-action@beta
+        uses: grll/claude-code-action@beta
         with:
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-
+          use_oauth: true
+          claude_access_token: ${{ secrets.CLAUDE_ACCESS_TOKEN }}
+          claude_refresh_token: ${{ secrets.CLAUDE_REFRESH_TOKEN }}
+          claude_expires_at: ${{ secrets.CLAUDE_EXPIRES_AT }}

.github/workflows/coverage.yml

@@ -0,0 +1,60 @@
+name: Run tests and upload coverage
+
+on: 
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    name: Run tests and collect coverage
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.11
+
+      - name: Install UV
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        run: |
+          cd src/praisonai
+          uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
+          uv pip install --system duckduckgo_search
+          uv pip install --system pytest pytest-cov pytest-asyncio
+          # Install knowledge dependencies from praisonai-agents
+          uv pip install --system "praisonaiagents[knowledge]"
+
+      - name: Set environment variables
+        run: |
+          echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
+          echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
+          echo "OPENAI_MODEL_NAME=${{ secrets.OPENAI_MODEL_NAME || 'gpt-4o-mini' }}" >> $GITHUB_ENV
+          echo "LOGLEVEL=DEBUG" >> $GITHUB_ENV
+          echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
+
+      - name: Run tests
+        run: |
+          cd src/praisonai
+          pytest --cov=praisonai --cov-branch --cov-report=xml tests/unit/
+
+      - name: Upload results to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          file: src/praisonai/coverage.xml
+          flags: unit-tests
+          name: unit-tests-coverage
+          fail_ci_if_error: false
+          verbose: true 

.github/workflows/python-package.yml

@@ -65,4 +65,4 @@ jobs:
     #     flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
     - name: Test with pytest
       run: |
-        cd src/praisonai && python -m pytest
+        cd src/praisonai && python tests/test_runner.py --pattern fast

.github/workflows/test-comprehensive.yml

@@ -69,10 +69,10 @@ jobs:
         
         case $TEST_TYPE in
           "unit")
-            cd src/praisonai && python tests/test_runner.py --pattern unit
+            cd src/praisonai && python -m pytest tests/unit/ -v --tb=short --disable-warnings --cov=praisonai --cov-report=xml --cov-branch
             ;;
           "integration")
-            cd src/praisonai && python tests/test_runner.py --pattern integration
+            cd src/praisonai && python -m pytest tests/integration/ -v --tb=short --disable-warnings --cov=praisonai --cov-report=xml --cov-branch
             ;;
           "fast")
             cd src/praisonai && python tests/test_runner.py --pattern fast
@@ -139,6 +139,16 @@ jobs:
         echo "- 🔌 MCP server connections" >> comprehensive_report.md
         echo "- 💬 LLM integrations (OpenAI, Anthropic, etc.)" >> comprehensive_report.md
 
+    - name: Upload coverage reports to Codecov
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: src/praisonai/coverage.xml
+        flags: comprehensive-tests
+        name: comprehensive-tests-coverage
+        fail_ci_if_error: false
+        verbose: true
+
     - name: Upload Comprehensive Test Results
       uses: actions/upload-artifact@v4
       if: always()
@@ -146,9 +156,9 @@ jobs:
         name: comprehensive-test-results-python-${{ matrix.python-version }}
         path: |
           comprehensive_report.md
-          htmlcov/
-          coverage.xml
-          .coverage
+          src/praisonai/htmlcov/
+          src/praisonai/coverage.xml
+          src/praisonai/.coverage
         retention-days: 30
 
   test-matrix-summary:

.github/workflows/test-core.yml

@@ -195,7 +195,7 @@ jobs:
 
     - name: Run Unit Tests
       run: |
-        cd src/praisonai && python -m pytest tests/unit/ -v --tb=short --disable-warnings --cov=praisonai --cov-report=term-missing
+        cd src/praisonai && python -m pytest tests/unit/ -v --tb=short --disable-warnings --cov=praisonai --cov-report=term-missing --cov-report=xml --cov-branch
 
     - name: Run Integration Tests  
       run: |
@@ -263,12 +263,24 @@ jobs:
         export OPENAI_MODEL_NAME="$OPENAI_MODEL_NAME"
         cd src/praisonai && python -m pytest tests/test.py -v --tb=short --disable-warnings
 
-    - name: Upload Coverage Reports
+    - name: Upload coverage reports to Codecov
+      if: matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: src/praisonai/coverage.xml
+        flags: core-tests
+        name: core-tests-coverage
+        fail_ci_if_error: false
+        verbose: true
+
+    - name: Upload Coverage Reports (Artifacts)
       if: matrix.python-version == '3.11'
       uses: actions/upload-artifact@v4
       with:
         name: coverage-reports
         path: |
-          .coverage
-          htmlcov/
+          src/praisonai/.coverage
+          src/praisonai/htmlcov/
+          src/praisonai/coverage.xml
         retention-days: 7

.github/workflows/unittest.yml

@@ -471,8 +471,8 @@ jobs:
 
     - name: Run Fast Tests
       run: |
-        # Run the fastest, most essential tests
-        cd src/praisonai && python tests/test_runner.py --pattern fast
+        # Run the fastest, most essential tests with coverage
+        cd src/praisonai && python -m pytest tests/unit/test_core_agents.py -v --tb=short --disable-warnings --cov=praisonai --cov-report=xml --cov-branch
 
     - name: Run Real API Tests
       run: |
@@ -491,6 +491,16 @@ jobs:
         cd src/praisonai && python -m pytest tests/test.py -v --tb=short --disable-warnings
       continue-on-error: true
 
+    - name: Upload coverage reports to Codecov
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: src/praisonai/coverage.xml
+        flags: quick-validation
+        name: quick-validation-coverage
+        fail_ci_if_error: false
+        verbose: true
+
     - name: Restore Root Config Files
       run: |
         echo "🔄 Restoring root configuration files..."

.gitignore

@@ -74,4 +74,5 @@ agents/praisonaiagents/praisonaiagents.egg-info
 .praison
 # Local Netlify folder
 .netlify
-.qodo
+.qodo
+CopilotKit*

docker/Dockerfile

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     flask \
-    "praisonai>=2.2.26" \
+    "praisonai>=2.2.36" \
     "praisonai[api]" \
     gunicorn \
     markdown

docker/Dockerfile.chat

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=2.2.26" \
+    "praisonai>=2.2.36" \
     "praisonai[chat]" \
     "embedchain[github,youtube]"
 

docker/Dockerfile.dev

@@ -20,7 +20,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=2.2.26" \
+    "praisonai>=2.2.36" \
     "praisonai[ui]" \
     "praisonai[chat]" \
     "praisonai[realtime]" \

docker/Dockerfile.ui

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=2.2.26" \
+    "praisonai>=2.2.36" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

docker/README.md

@@ -121,7 +121,7 @@ healthcheck:
 ## 📦 Package Versions
 
 All Docker images use consistent, up-to-date versions:
-- PraisonAI: `>=2.2.26`
+- PraisonAI: `>=2.2.36`
 - PraisonAI Agents: `>=0.0.92`
 - Python: `3.11-slim`
 
@@ -218,7 +218,7 @@ docker-compose up -d
 ### Version Pinning
 To use specific versions, update the Dockerfile:
 ```dockerfile
-RUN pip install "praisonai==2.2.26" "praisonaiagents==0.0.92"
+RUN pip install "praisonai==2.2.36" "praisonaiagents==0.0.92"
 ```
 
 ## 🌐 Production Deployment

examples/cookbooks/Code_Analysis_Agent.ipynb

@@ -0,0 +1,467 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "bLeMxwWimvzX"
+      },
+      "source": [
+        "# Code Analysis Agent\n",
+        "Learn how to create AI agents for comprehensive code analysis and quality assessment."
+      ],
+      "id": "bLeMxwWimvzX"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Code_Analysis_Agent.ipynb)\n"
+=======
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/code_analysis_agent.ipynb)\n"
+
+      ],
+      "metadata": {
+        "id": "P3X8PXPyojnL"
+      },
+      "id": "P3X8PXPyojnL"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "xEs8bwWfmvza"
+      },
+      "source": [
+        "## Dependencies\n",
+        "Install the required packages."
+      ],
+      "id": "xEs8bwWfmvza"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "_RPiU3j6mvzb"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install praisonaiagents gitingest"
+      ],
+      "id": "_RPiU3j6mvzb"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "81-orTkzmvzc"
+      },
+      "source": [
+        "## Set API Key\n",
+        "Set your OpenAI API key as an environment variable in your terminal:"
+      ],
+      "id": "81-orTkzmvzc"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "84iL7rGimvzc"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "os.environ['OPENAI_API_KEY'] = 'your_api_key_here'"
+      ],
+      "id": "84iL7rGimvzc"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "TV15GFsRmvzc"
+      },
+      "source": [
+        "## Tools and Data Models\n",
+        "Define the agent, task, and output schema."
+      ],
+      "id": "TV15GFsRmvzc"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "0Wq_g0pNmvzd"
+      },
+      "outputs": [],
+      "source": [
+        "from praisonaiagents import Agent, Task, PraisonAIAgents\n",
+        "from pydantic import BaseModel\n",
+        "from typing import List, Dict\n",
+        "from gitingest import ingest\n",
+        "\n",
+        "class CodeMetrics(BaseModel):\n",
+        "    category: str\n",
+        "    score: int\n",
+        "    findings: List[str]\n",
+        "\n",
+        "class CodeAnalysisReport(BaseModel):\n",
+        "    overall_quality: int\n",
+        "    code_metrics: List[CodeMetrics]\n",
+        "    architecture_score: int\n",
+        "    maintainability_score: int\n",
+        "    performance_score: int\n",
+        "    security_score: int\n",
+        "    test_coverage: int\n",
+        "    key_strengths: List[str]\n",
+        "    improvement_areas: List[str]\n",
+        "    tech_stack: List[str]\n",
+        "    recommendations: List[str]\n",
+        "    complexity_metrics: Dict[str, int]\n",
+        "    best_practices: List[Dict[str, str]]\n",
+        "    potential_risks: List[str]\n",
+        "    documentation_quality: int"
+      ],
+      "id": "0Wq_g0pNmvzd"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "EatrK7-wmvzd"
+      },
+      "source": [
+        "## YAML Prompt Setup\n",
+        "Define the agent and task with expectations."
+      ],
+      "id": "EatrK7-wmvzd"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "EdZNSOy-mvze"
+      },
+      "outputs": [],
+      "source": [
+        "code_analyzer = Agent(\n",
+        "    role=\"Code Analysis Expert\",\n",
+        "    goal=\"Provide comprehensive code evaluation and recommendations\",\n",
+        "    backstory=\"\"\"Expert code analyst specializing in architecture review,\n",
+        "    best practices, and technical debt assessment.\"\"\",\n",
+        "    verbose=True\n",
+        ")\n",
+        "\n",
+        "code_analysis_task = Task(\n",
+        "    description=\"\"\"Analyze code repository and provide structured evaluation:\n",
+        "\n",
+        "    1. Overall Quality (0-100)\n",
+        "    2. Core Metrics Analysis:\n",
+        "       - Architecture and Design\n",
+        "       - Code Maintainability\n",
+        "       - Performance Optimization\n",
+        "       - Security Practices\n",
+        "       - Test Coverage\n",
+        "    3. Technical Assessment:\n",
+        "       - Technology Stack Review\n",
+        "       - Code Complexity Analysis\n",
+        "       - Best Practices Adherence\n",
+        "       - Risk Assessment\n",
+        "    4. Recommendations:\n",
+        "       - Key Improvements\n",
+        "       - Architecture Suggestions\n",
+        "       - Security Enhancements\"\"\",\n",
+        "    expected_output=\"Detailed code analysis report with metrics and recommendations\",\n",
+        "    agent=code_analyzer,\n",
+        "    output_pydantic=CodeAnalysisReport\n",
+        ")"
+      ],
+      "id": "EdZNSOy-mvze"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "CeLS55ROmvzf"
+      },
+      "source": [
+        "## Main Function\n",
+        "Function to analyze code from GitHub URL or local path."
+      ],
+      "id": "CeLS55ROmvzf"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "3Eo6LEOxmvzf"
+      },
+      "outputs": [],
+      "source": [
+        "def analyze_code(code_source: str) -> CodeAnalysisReport:\n",
+        "    \"\"\"\n",
+        "    Analyze code from directory path or GitHub URL\n",
+        "    \"\"\"\n",
+        "    # Ingest code content\n",
+        "    summary, tree, content = ingest(code_source)\n",
+        "\n",
+        "    # Concatenate context into structured format\n",
+        "    context_text = f\"\"\"\n",
+        "    CODE REPOSITORY ANALYSIS\n",
+        "    =======================\n",
+        "\n",
+        "    SUMMARY\n",
+        "    -------\n",
+        "    {summary}\n",
+        "\n",
+        "    REPOSITORY STRUCTURE\n",
+        "    -------------------\n",
+        "    {tree}\n",
+        "\n",
+        "    SOURCE CODE\n",
+        "    -----------\n",
+        "    {content}\n",
+        "    \"\"\"\n",
+        "\n",
+        "    # Initialize and run analysis\n",
+        "    agents = PraisonAIAgents(\n",
+        "        agents=[code_analyzer],\n",
+        "        tasks=[code_analysis_task]\n",
+        "    )\n",
+        "\n",
+        "    return agents.start(context_text)"
+      ],
+      "id": "3Eo6LEOxmvzf"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "v25nLA0pmvzf"
+      },
+      "source": [
+        "## Output\n",
+        "Example usage to run the analysis and view results."
+      ],
+      "id": "v25nLA0pmvzf"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 3,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 1000
+        },
+        "id": "5BzccaeFmvzg",
+        "outputId": "8b4cddae-b6b3-4a92-8a13-30694cd09c52"
+      },
+      "outputs": [
+        {
+          "output_type": "display_data",
+          "data": {
+            "text/plain": [
+              "<IPython.core.display.Markdown object>"
+            ],
+            "text/markdown": "\n### 👤 Agent: Code Analysis Expert\n\n**Role**: Provides comprehensive code evaluation and recommendations  \n**Backstory**: Expert in architecture, best practices, and technical assessment  \n"
+          },
+          "metadata": {}
+        },
+        {
+          "output_type": "stream",
+          "name": "stdout",
+          "text": [
+            "─── 📊 AGENT CODE ANALYSIS REPORT ───\n",
+            "{\n",
+            "    \"overall_quality\": 85,\n",
+            "    \"code_metrics\": [\n",
+            "        {\n",
+            "            \"category\": \"Architecture and Design\",\n",
+            "            \"score\": 80,\n",
+            "            \"findings\": [\n",
+            "                \"Modular structure with clear separation of concerns.\",\n",
+            "                \"Use of type annotations improves code readability and maintainability.\"\n",
+            "            ]\n",
+            "        },\n",
+            "        {\n",
+            "            \"category\": \"Code Maintainability\",\n",
+            "            \"score\": 85,\n",
+            "            \"findings\": [\n",
+            "                \"Consistent use of type hints and NamedTuple for structured data.\",\n",
+            "                \"Logical organization of functions and classes.\"\n",
+            "            ]\n",
+            "        },\n",
+            "        {\n",
+            "            \"category\": \"Performance Optimization\",\n",
+            "            \"score\": 75,\n",
+            "            \"findings\": [\n",
+            "                \"Potential performance overhead due to repeated sys.stdout.write calls.\",\n",
+            "                \"Efficient use of optional parameters to control execution flow.\"\n",
+            "            ]\n",
+            "        },\n",
+            "        {\n",
+            "            \"category\": \"Security Practices\",\n",
+            "            \"score\": 80,\n",
+            "            \"findings\": [\n",
+            "                \"No obvious security vulnerabilities in the code.\",\n",
+            "                \"Proper encapsulation of functionality.\"\n",
+            "            ]\n",
+            "        },\n",
+            "        {\n",
+            "            \"category\": \"Test Coverage\",\n",
+            "            \"score\": 70,\n",
+            "            \"findings\": [\n",
+            "                \"Lack of explicit test cases in the provided code.\",\n",
+            "                \"Use of type checking suggests some level of validation.\"\n",
+            "            ]\n",
+            "        }\n",
+            "    ],\n",
+            "    \"architecture_score\": 80,\n",
+            "    \"maintainability_score\": 85,\n",
+            "    \"performance_score\": 75,\n",
+            "    \"security_score\": 80,\n",
+            "    \"test_coverage\": 70,\n",
+            "    \"key_strengths\": [\n",
+            "        \"Strong use of type annotations and typing extensions.\",\n",
+            "        \"Clear separation of CLI argument parsing and business logic.\"\n",
+            "    ],\n",
+            "    \"improvement_areas\": [\n",
+            "        \"Increase test coverage to ensure robustness.\",\n",
+            "        \"Optimize I/O operations to improve performance.\"\n",
+            "    ],\n",
+            "    \"tech_stack\": [\n",
+            "        \"Python\",\n",
+            "        \"argparse\",\n",
+            "        \"typing_extensions\"\n",
+            "    ],\n",
+            "    \"recommendations\": [\n",
+            "        \"Add unit tests to improve reliability.\",\n",
+            "        \"Consider async I/O for improved performance in CLI tools.\"\n",
+            "    ]\n",
+            "}\n"
+          ]
+        }
+      ],
+      "source": [
+        "import json\n",
+        "from IPython.display import display, Markdown\n",
+        "\n",
+        "# Optional: Define agent info\n",
+        "agent_info = \"\"\"\n",
+        "### 👤 Agent: Code Analysis Expert\n",
+        "\n",
+        "**Role**: Provides comprehensive code evaluation and recommendations\n",
+        "**Backstory**: Expert in architecture, best practices, and technical assessment\n",
+        "\"\"\"\n",
+        "\n",
+        "# Analysis Result Data\n",
+        "analysis_result = {\n",
+        "    \"overall_quality\": 85,\n",
+        "    \"code_metrics\": [\n",
+        "        {\n",
+        "            \"category\": \"Architecture and Design\",\n",
+        "            \"score\": 80,\n",
+        "            \"findings\": [\n",
+        "                \"Modular structure with clear separation of concerns.\",\n",
+        "                \"Use of type annotations improves code readability and maintainability.\"\n",
+        "            ]\n",
+        "        },\n",
+        "        {\n",
+        "            \"category\": \"Code Maintainability\",\n",
+        "            \"score\": 85,\n",
+        "            \"findings\": [\n",
+        "                \"Consistent use of type hints and NamedTuple for structured data.\",\n",
+        "                \"Logical organization of functions and classes.\"\n",
+        "            ]\n",
+        "        },\n",
+        "        {\n",
+        "            \"category\": \"Performance Optimization\",\n",
+        "            \"score\": 75,\n",
+        "            \"findings\": [\n",
+        "                \"Potential performance overhead due to repeated sys.stdout.write calls.\",\n",
+        "                \"Efficient use of optional parameters to control execution flow.\"\n",
+        "            ]\n",
+        "        },\n",
+        "        {\n",
+        "            \"category\": \"Security Practices\",\n",
+        "            \"score\": 80,\n",
+        "            \"findings\": [\n",
+        "                \"No obvious security vulnerabilities in the code.\",\n",
+        "                \"Proper encapsulation of functionality.\"\n",
+        "            ]\n",
+        "        },\n",
+        "        {\n",
+        "            \"category\": \"Test Coverage\",\n",
+        "            \"score\": 70,\n",
+        "            \"findings\": [\n",
+        "                \"Lack of explicit test cases in the provided code.\",\n",
+        "                \"Use of type checking suggests some level of validation.\"\n",
+        "            ]\n",
+        "        }\n",
+        "    ],\n",
+        "    \"architecture_score\": 80,\n",
+        "    \"maintainability_score\": 85,\n",
+        "    \"performance_score\": 75,\n",
+        "    \"security_score\": 80,\n",
+        "    \"test_coverage\": 70,\n",
+        "    \"key_strengths\": [\n",
+        "        \"Strong use of type annotations and typing extensions.\",\n",
+        "        \"Clear separation of CLI argument parsing and business logic.\"\n",
+        "    ],\n",
+        "    \"improvement_areas\": [\n",
+        "        \"Increase test coverage to ensure robustness.\",\n",
+        "        \"Optimize I/O operations to improve performance.\"\n",
+        "    ],\n",
+        "    \"tech_stack\": [\"Python\", \"argparse\", \"typing_extensions\"],\n",
+        "    \"recommendations\": [\n",
+        "        \"Add unit tests to improve reliability.\",\n",
+        "        \"Consider async I/O for improved performance in CLI tools.\"\n",
+        "    ]\n",
+        "}\n",
+        "\n",
+        "# Display Agent Info and Analysis Report\n",
+        "display(Markdown(agent_info))\n",
+        "print(\"─── 📊 AGENT CODE ANALYSIS REPORT ───\")\n",
+        "print(json.dumps(analysis_result, indent=4))\n"
+      ],
+      "id": "5BzccaeFmvzg"
+    },
+    {
+      "cell_type": "code",
+      "source": [
+        "%cd PraisonAI"
+      ],
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "mNZjZLedorlu",
+        "outputId": "82c96cdf-e2e5-4a9c-e633-f0fc225ad973"
+      },
+      "id": "mNZjZLedorlu",
+      "execution_count": 5,
+      "outputs": [
+        {
+          "output_type": "stream",
+          "name": "stdout",
+          "text": [
+            "/content/PraisonAI\n"
+          ]
+        }
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.10"
+    },
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+
+}
+=======
+}
+

examples/cookbooks/Cognitive_Assistant_Agent_Team.ipynb

@@ -0,0 +1,970 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "51623c09",
+   "metadata": {
+    "id": "51623c09"
+   },
+   "source": [
+    "# Cognitive Assistant Agent Team\n",
+    "\n",
+    "A team of sub-agents working collaboratively to solve complex user requests."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "YymTE1zgX9y2",
+   "metadata": {
+    "id": "YymTE1zgX9y2"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Cognitive_Assistant_Agent_Team.ipynb)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "tEF0aobxXgm5",
+   "metadata": {
+    "id": "tEF0aobxXgm5"
+   },
+   "source": [
+    "# Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "9ce5977e",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "9ce5977e",
+    "outputId": "92f0a4b2-fbb8-4141-f385-d827ece08704"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[?25l     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/497.7 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m163.8/497.7 kB\u001b[0m \u001b[31m4.7 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m \u001b[32m491.5/497.7 kB\u001b[0m \u001b[31m9.6 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m497.7/497.7 kB\u001b[0m \u001b[31m6.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h  Installing build dependencies ... \u001b[?25l\u001b[?25hdone\n",
+      "  Getting requirements to build wheel ... \u001b[?25l\u001b[?25hdone\n",
+      "  Preparing metadata (pyproject.toml) ... \u001b[?25l\u001b[?25hdone\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m44.3/44.3 kB\u001b[0m \u001b[31m1.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m94.7/94.7 kB\u001b[0m \u001b[31m4.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m130.2/130.2 kB\u001b[0m \u001b[31m8.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m176.8/176.8 kB\u001b[0m \u001b[31m10.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m3.9/3.9 MB\u001b[0m \u001b[31m43.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m8.7/8.7 MB\u001b[0m \u001b[31m63.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m105.4/105.4 kB\u001b[0m \u001b[31m6.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m220.7/220.7 kB\u001b[0m \u001b[31m13.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m45.2/45.2 kB\u001b[0m \u001b[31m2.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m392.1/392.1 kB\u001b[0m \u001b[31m18.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m99.1/99.1 kB\u001b[0m \u001b[31m4.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m266.1/266.1 kB\u001b[0m \u001b[31m18.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m6.1/6.1 MB\u001b[0m \u001b[31m76.9 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m79.1/79.1 kB\u001b[0m \u001b[31m5.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m469.0/469.0 kB\u001b[0m \u001b[31m31.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h  Building wheel for praisonai (pyproject.toml) ... \u001b[?25l\u001b[?25hdone\n"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q praisonai openai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "S1JhxGZ9XlBj",
+   "metadata": {
+    "id": "S1JhxGZ9XlBj"
+   },
+   "source": [
+    "# set your OpenAI API key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "95f683e0",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "95f683e0",
+    "outputId": "a9153e56-07af-4902-e23a-7567240c302b"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Enter your OpenAI API key: ··········\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "from getpass import getpass\n",
+    "\n",
+    "os.environ[\"OPENAI_API_KEY\"] = getpass(\"Enter your OpenAI API key: \")\n",
+    "import openai\n",
+    "openai.api_key = os.getenv(\"OPENAI_API_KEY\")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "WOzIiAI5Xo8L",
+   "metadata": {
+    "id": "WOzIiAI5Xo8L"
+   },
+   "source": [
+    "# Import PraisonAI Agents"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "45c7dda2",
+   "metadata": {
+    "id": "45c7dda2"
+   },
+   "outputs": [],
+   "source": [
+    "from praisonaiagents import Agent, Task, PraisonAIAgents"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "br09CepoXthm",
+   "metadata": {
+    "id": "br09CepoXthm"
+   },
+   "source": [
+    "# Define agents"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "7183ec1d",
+   "metadata": {
+    "id": "7183ec1d"
+   },
+   "outputs": [],
+   "source": [
+    "planner = Agent(\n",
+    "    name=\"PlannerAgent\",\n",
+    "    instructions=\"You are a planning expert. Your job is to break down complex tasks into actionable steps.\",\n",
+    ")\n",
+    "\n",
+    "researcher = Agent(\n",
+    "    name=\"ResearchAgent\",\n",
+    "    instructions=\"You are a research specialist. Find relevant information to support the task at hand.\",\n",
+    ")\n",
+    "\n",
+    "writer = Agent(\n",
+    "    name=\"WritingAgent\",\n",
+    "    instructions=\"You are a professional writer. Create a well-written and structured response based on provided research.\",\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "77YEFKaGXxSX",
+   "metadata": {
+    "id": "77YEFKaGXxSX"
+   },
+   "source": [
+    "# Define tasks"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "408c39e9",
+   "metadata": {
+    "id": "408c39e9"
+   },
+   "outputs": [],
+   "source": [
+    "planning_task = Task(\n",
+    "    name=\"PlanningTask\",\n",
+    "    description=\"Break down the request into subtasks\",\n",
+    "    expected_output=\"A list of clear, actionable substeps\",\n",
+    "    agent=planner\n",
+    ")\n",
+    "\n",
+    "research_task = Task(\n",
+    "    name=\"ResearchTask\",\n",
+    "    description=\"Research background information on the topic\",\n",
+    "    expected_output=\"Summarized findings and context\",\n",
+    "    agent=researcher\n",
+    ")\n",
+    "\n",
+    "writing_task = Task(\n",
+    "    name=\"WritingTask\",\n",
+    "    description=\"Write a final report based on research and planning\",\n",
+    "    expected_output=\"A coherent and professional report or response\",\n",
+    "    agent=writer\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "g8aPj_EmX0bm",
+   "metadata": {
+    "id": "g8aPj_EmX0bm"
+   },
+   "source": [
+    "# Build cognitive team system"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "3JMauPEXXVhS",
+   "metadata": {
+    "id": "3JMauPEXXVhS"
+   },
+   "outputs": [],
+   "source": [
+    "cognitive_team = PraisonAIAgents(\n",
+    "    agents=[planner, researcher, writer],\n",
+    "    tasks=[planning_task, research_task, writing_task],\n",
+    "    process=\"sequential\",  # one task after another\n",
+    "    verbose=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "o1O0vQGyX32z",
+   "metadata": {
+    "id": "o1O0vQGyX32z"
+   },
+   "source": [
+    "# Run the agent system"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "wusL6r6HXX0f",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 1000,
+     "referenced_widgets": [
+      "4a7945abafd844c299b71c77fcc340a0",
+      "9b57ee1234734563bc35932ac9bfec18",
+      "02a56f032fdd408d9fcf327d4e5d4bd3",
+      "78733159c35941809466edd8f229f9f3"
+     ]
+    },
+    "id": "wusL6r6HXX0f",
+    "outputId": "11bf9532-1bd1-40f3-db3d-cd35da2a512e"
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">PlannerAgent</span>                                                                                         <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mPlannerAgent\u001b[0m                                                                                         \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 1.6s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 1.6s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Break down the request into subtasks. Expected Output: A list of clear,      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> actionable substeps. Please provide only the final result of your work. Do not add any conversation or extra    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> explanation.                                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Break down the request into subtasks. Expected Output: A list of clear,      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m actionable substeps. Please provide only the final result of your work. Do not add any conversation or extra    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m explanation.                                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Certainly! Please provide the task you need broken down into subtasks.                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Certainly! Please provide the task you need broken down into subtasks.                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">ResearchAgent</span>                                                                                        <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mResearchAgent\u001b[0m                                                                                        \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "4a7945abafd844c299b71c77fcc340a0",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 7.7s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 7.7s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Research background information on the topic. Expected Output: Summarized    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> findings and context.                                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Context:                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Result of previous task PlanningTask: Certainly! Please provide the task you need broken down into subtasks.    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Please provide only the final result of your work. Do not add any conversation or extra explanation.            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Research background information on the topic. Expected Output: Summarized    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m findings and context.                                                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Context:                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Result of previous task PlanningTask: Certainly! Please provide the task you need broken down into subtasks.    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Please provide only the final result of your work. Do not add any conversation or extra explanation.            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Topic: Climate Change and Its Impact on Global Agriculture                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Overview of Climate Change</span>:                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Climate change refers to significant changes in global temperatures and weather patterns over time. While <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>climate change is a natural phenomenon, scientific evidence indicates that human activities, particularly <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>the burning of fossil fuels and deforestation, have accelerated these changes since the Industrial        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>Revolution.                                                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Impact on Agriculture</span>:                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Temperature Changes</span>: Rising temperatures can lead to heat stress on crops, reducing yields. Some regions  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>may experience longer growing seasons, while others may face shortened ones due to extreme heat.          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Water Availability</span>: Changes in precipitation patterns can lead to droughts or floods, affecting water     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>availability for irrigation. This can impact crop productivity and lead to water scarcity in some         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>regions.                                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Soil Health</span>: Increased temperatures and altered precipitation can affect soil moisture and fertility,     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>leading to soil degradation and erosion.                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Pests and Diseases</span>: Warmer temperatures can expand the range and increase the lifecycle of pests and      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>diseases, posing new challenges for crop protection.                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Crop Viability</span>: Certain crops may no longer be viable in traditional growing areas, necessitating shifts  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>in agricultural practices and crop selection.                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">Regional Variability</span>:                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>The impact of climate change on agriculture varies by region. For example, temperate regions might        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>benefit from longer growing seasons, while tropical and subtropical regions could suffer from increased   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>heat and water stress.                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Developing countries are particularly vulnerable due to limited resources and adaptive capacity.          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">Adaptation Strategies</span>:                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Crop Diversification</span>: Introducing a variety of crops to reduce dependency on a single type and increase   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>resilience to climate variability.                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Improved Irrigation</span>: Developing efficient irrigation systems to optimize water use.                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Genetic Modification</span>: Breeding or genetically modifying crops to withstand extreme weather conditions,    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>pests, and diseases.                                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Sustainable Practices</span>: Implementing sustainable agricultural practices such as conservation tillage,      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>agroforestry, and integrated pest management.                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 5 </span><span style=\"font-weight: bold\">Policy and Global Efforts</span>:                                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>International agreements like the Paris Agreement aim to limit global warming and support adaptation      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>efforts.                                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Governments and organizations are investing in research and development to create climate-resilient       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>agricultural systems.                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 6 </span><span style=\"font-weight: bold\">Future Outlook</span>:                                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Continued research and innovation are crucial to developing adaptive strategies.                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Collaboration between governments, scientists, and farmers is essential to address the challenges posed   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>by climate change on agriculture.                                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> This summary provides a foundational understanding of how climate change affects global agriculture and         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> highlights the importance of adaptive strategies to mitigate these impacts.                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Topic: Climate Change and Its Impact on Global Agriculture                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mOverview of Climate Change\u001b[0m:                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mClimate change refers to significant changes in global temperatures and weather patterns over time. While \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mclimate change is a natural phenomenon, scientific evidence indicates that human activities, particularly \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mthe burning of fossil fuels and deforestation, have accelerated these changes since the Industrial        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mRevolution.                                                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mImpact on Agriculture\u001b[0m:                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mTemperature Changes\u001b[0m: Rising temperatures can lead to heat stress on crops, reducing yields. Some regions  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mmay experience longer growing seasons, while others may face shortened ones due to extreme heat.          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mWater Availability\u001b[0m: Changes in precipitation patterns can lead to droughts or floods, affecting water     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mavailability for irrigation. This can impact crop productivity and lead to water scarcity in some         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mregions.                                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mSoil Health\u001b[0m: Increased temperatures and altered precipitation can affect soil moisture and fertility,     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mleading to soil degradation and erosion.                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mPests and Diseases\u001b[0m: Warmer temperatures can expand the range and increase the lifecycle of pests and      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mdiseases, posing new challenges for crop protection.                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mCrop Viability\u001b[0m: Certain crops may no longer be viable in traditional growing areas, necessitating shifts  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0min agricultural practices and crop selection.                                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mRegional Variability\u001b[0m:                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThe impact of climate change on agriculture varies by region. For example, temperate regions might        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mbenefit from longer growing seasons, while tropical and subtropical regions could suffer from increased   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mheat and water stress.                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mDeveloping countries are particularly vulnerable due to limited resources and adaptive capacity.          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mAdaptation Strategies\u001b[0m:                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mCrop Diversification\u001b[0m: Introducing a variety of crops to reduce dependency on a single type and increase   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mresilience to climate variability.                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mImproved Irrigation\u001b[0m: Developing efficient irrigation systems to optimize water use.                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mGenetic Modification\u001b[0m: Breeding or genetically modifying crops to withstand extreme weather conditions,    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mpests, and diseases.                                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mSustainable Practices\u001b[0m: Implementing sustainable agricultural practices such as conservation tillage,      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0magroforestry, and integrated pest management.                                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 5 \u001b[0m\u001b[1mPolicy and Global Efforts\u001b[0m:                                                                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mInternational agreements like the Paris Agreement aim to limit global warming and support adaptation      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mefforts.                                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGovernments and organizations are investing in research and development to create climate-resilient       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0magricultural systems.                                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 6 \u001b[0m\u001b[1mFuture Outlook\u001b[0m:                                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mContinued research and innovation are crucial to developing adaptive strategies.                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mCollaboration between governments, scientists, and farmers is essential to address the challenges posed   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mby climate change on agriculture.                                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m This summary provides a foundational understanding of how climate change affects global agriculture and         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m highlights the importance of adaptive strategies to mitigate these impacts.                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">WritingAgent</span>                                                                                         <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mWritingAgent\u001b[0m                                                                                         \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "02a56f032fdd408d9fcf327d4e5d4bd3",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 10.7s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 10.7s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Write a final report based on research and planning. Expected Output: A      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> coherent and professional report or response.                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Context:                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Result of previous task ResearchTask: Topic: Climate Change and Its Impact on Global Agriculture                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Overview of Climate Change</span>:                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Climate change refers to significant changes in global temperatures and weather patterns over time. While <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>climate change is a natural phenomenon, scientific evidence indicates that human activities, particularly <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>the burning of fossil fuels and deforestation, have accelerated these changes since the Industrial        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>Revolution.                                                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Impact on Agriculture</span>:                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Temperature Changes</span>: Rising temperatures can lead to heat stress on crops, reducing yields. Some regions  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>may experience longer growing seasons, while others may face shortened ones due to extreme heat.          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Water Availability</span>: Changes in precipitation patterns can lead to droughts or floods, affecting water     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>availability for irrigation. This can impact crop productivity and lead to water scarcity in some         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>regions.                                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Soil Health</span>: Increased temperatures and altered precipitation can affect soil moisture and fertility,     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>leading to soil degradation and erosion.                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Pests and Diseases</span>: Warmer temperatures can expand the range and increase the lifecycle of pests and      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>diseases, posing new challenges for crop protection.                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Crop Viability</span>: Certain crops may no longer be viable in traditional growing areas, necessitating shifts  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>in agricultural practices and crop selection.                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">Regional Variability</span>:                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>The impact of climate change on agriculture varies by region. For example, temperate regions might        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>benefit from longer growing seasons, while tropical and subtropical regions could suffer from increased   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>heat and water stress.                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Developing countries are particularly vulnerable due to limited resources and adaptive capacity.          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">Adaptation Strategies</span>:                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Crop Diversification</span>: Introducing a variety of crops to reduce dependency on a single type and increase   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>resilience to climate variability.                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Improved Irrigation</span>: Developing efficient irrigation systems to optimize water use.                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Genetic Modification</span>: Breeding or genetically modifying crops to withstand extreme weather conditions,    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>pests, and diseases.                                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span><span style=\"font-weight: bold\">Sustainable Practices</span>: Implementing sustainable agricultural practices such as conservation tillage,      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>agroforestry, and integrated pest management.                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 5 </span><span style=\"font-weight: bold\">Policy and Global Efforts</span>:                                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>International agreements like the Paris Agreement aim to limit global warming and support adaptation      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>efforts.                                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Governments and organizations are investing in research and development to create climate-resilient       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>agricultural systems.                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 6 </span><span style=\"font-weight: bold\">Future Outlook</span>:                                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Continued research and innovation are crucial to developing adaptive strategies.                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Collaboration between governments, scientists, and farmers is essential to address the challenges posed   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>by climate change on agriculture.                                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> This summary provides a foundational understanding of how climate change affects global agriculture and         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> highlights the importance of adaptive strategies to mitigate these impacts. Please provide only the final       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> result of your work. Do not add any conversation or extra explanation.                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Write a final report based on research and planning. Expected Output: A      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m coherent and professional report or response.                                                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Context:                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Result of previous task ResearchTask: Topic: Climate Change and Its Impact on Global Agriculture                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mOverview of Climate Change\u001b[0m:                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mClimate change refers to significant changes in global temperatures and weather patterns over time. While \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mclimate change is a natural phenomenon, scientific evidence indicates that human activities, particularly \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mthe burning of fossil fuels and deforestation, have accelerated these changes since the Industrial        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mRevolution.                                                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mImpact on Agriculture\u001b[0m:                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mTemperature Changes\u001b[0m: Rising temperatures can lead to heat stress on crops, reducing yields. Some regions  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mmay experience longer growing seasons, while others may face shortened ones due to extreme heat.          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mWater Availability\u001b[0m: Changes in precipitation patterns can lead to droughts or floods, affecting water     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mavailability for irrigation. This can impact crop productivity and lead to water scarcity in some         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mregions.                                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mSoil Health\u001b[0m: Increased temperatures and altered precipitation can affect soil moisture and fertility,     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mleading to soil degradation and erosion.                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mPests and Diseases\u001b[0m: Warmer temperatures can expand the range and increase the lifecycle of pests and      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mdiseases, posing new challenges for crop protection.                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mCrop Viability\u001b[0m: Certain crops may no longer be viable in traditional growing areas, necessitating shifts  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0min agricultural practices and crop selection.                                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mRegional Variability\u001b[0m:                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThe impact of climate change on agriculture varies by region. For example, temperate regions might        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mbenefit from longer growing seasons, while tropical and subtropical regions could suffer from increased   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mheat and water stress.                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mDeveloping countries are particularly vulnerable due to limited resources and adaptive capacity.          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mAdaptation Strategies\u001b[0m:                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mCrop Diversification\u001b[0m: Introducing a variety of crops to reduce dependency on a single type and increase   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mresilience to climate variability.                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mImproved Irrigation\u001b[0m: Developing efficient irrigation systems to optimize water use.                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mGenetic Modification\u001b[0m: Breeding or genetically modifying crops to withstand extreme weather conditions,    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mpests, and diseases.                                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0m\u001b[1mSustainable Practices\u001b[0m: Implementing sustainable agricultural practices such as conservation tillage,      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0magroforestry, and integrated pest management.                                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 5 \u001b[0m\u001b[1mPolicy and Global Efforts\u001b[0m:                                                                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mInternational agreements like the Paris Agreement aim to limit global warming and support adaptation      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mefforts.                                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGovernments and organizations are investing in research and development to create climate-resilient       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0magricultural systems.                                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 6 \u001b[0m\u001b[1mFuture Outlook\u001b[0m:                                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mContinued research and innovation are crucial to developing adaptive strategies.                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mCollaboration between governments, scientists, and farmers is essential to address the challenges posed   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mby climate change on agriculture.                                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m This summary provides a foundational understanding of how climate change affects global agriculture and         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m highlights the importance of adaptive strategies to mitigate these impacts. Please provide only the final       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m result of your work. Do not add any conversation or extra explanation.                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Final Report: Climate Change and Its Impact on Global Agriculture</span>                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Introduction</span>                                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Climate change, characterized by significant alterations in global temperatures and weather patterns, poses a   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> profound threat to global agriculture. While naturally occurring, the acceleration of climate change due to     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> human activities such as fossil fuel combustion and deforestation has exacerbated its impacts on agricultural   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> systems worldwide. This report examines the multifaceted effects of climate change on agriculture, regional     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> variability, adaptation strategies, policy efforts, and future outlooks.                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Impact on Agriculture</span>                                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Temperature Changes</span>: The rise in global temperatures induces heat stress in crops, potentially reducing      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>yields. While some regions may benefit from extended growing seasons, others face shortened periods due to   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>extreme heat, adversely affecting crop productivity.                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Water Availability</span>: Altered precipitation patterns result in droughts and floods, disrupting water           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>availability for irrigation. This variability threatens crop productivity and exacerbates water scarcity in  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>vulnerable regions.                                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">Soil Health</span>: Climate change affects soil moisture and fertility, leading to degradation and erosion. These   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>changes compromise soil health, essential for sustaining agricultural productivity.                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">Pests and Diseases</span>: Warmer climates expand the range and lifecycle of pests and diseases, presenting new     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>challenges for crop protection and necessitating innovative pest management strategies.                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 5 </span><span style=\"font-weight: bold\">Crop Viability</span>: Traditional growing areas may no longer support certain crops, prompting shifts in           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>agricultural practices and crop selection to adapt to changing conditions.                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Regional Variability</span>                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> The impact of climate change on agriculture is not uniform across the globe. Temperate regions might experience <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> benefits such as longer growing seasons, while tropical and subtropical areas could suffer from increased heat  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> and water stress. Developing countries, with limited resources and adaptive capacity, are particularly          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> vulnerable to these changes.                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Adaptation Strategies</span>                                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Crop Diversification</span>: Introducing a variety of crops can reduce dependency on a single type, enhancing       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>resilience to climate variability.                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Improved Irrigation</span>: Developing efficient irrigation systems is crucial for optimizing water use and         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>ensuring crop survival during periods of water scarcity.                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">Genetic Modification</span>: Breeding or genetically modifying crops to withstand extreme weather conditions,       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>pests, and diseases is a promising adaptation strategy.                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">Sustainable Practices</span>: Implementing sustainable agricultural practices, such as conservation tillage,        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>agroforestry, and integrated pest management, can mitigate the adverse effects of climate change.            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Policy and Global Efforts</span>                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> International agreements, such as the Paris Agreement, aim to limit global warming and support adaptation       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> efforts. Governments and organizations are investing in research and development to create climate-resilient    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> agricultural systems, emphasizing the importance of global cooperation in addressing these challenges.          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Future Outlook</span>                                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Continued research and innovation are vital for developing adaptive strategies to combat the impacts of climate <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> change on agriculture. Collaboration among governments, scientists, and farmers is essential to ensure the      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> sustainability of agricultural systems and food security in the face of climate change.                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Conclusion</span>                                                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Climate change presents significant challenges to global agriculture, necessitating adaptive strategies and     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> international cooperation. By understanding the impacts and implementing effective adaptation measures, the     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> agricultural sector can enhance its resilience and continue to provide for the growing global population.       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mFinal Report: Climate Change and Its Impact on Global Agriculture\u001b[0m                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mIntroduction\u001b[0m                                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Climate change, characterized by significant alterations in global temperatures and weather patterns, poses a   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m profound threat to global agriculture. While naturally occurring, the acceleration of climate change due to     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m human activities such as fossil fuel combustion and deforestation has exacerbated its impacts on agricultural   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m systems worldwide. This report examines the multifaceted effects of climate change on agriculture, regional     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m variability, adaptation strategies, policy efforts, and future outlooks.                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mImpact on Agriculture\u001b[0m                                                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mTemperature Changes\u001b[0m: The rise in global temperatures induces heat stress in crops, potentially reducing      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0myields. While some regions may benefit from extended growing seasons, others face shortened periods due to   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mextreme heat, adversely affecting crop productivity.                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mWater Availability\u001b[0m: Altered precipitation patterns result in droughts and floods, disrupting water           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mavailability for irrigation. This variability threatens crop productivity and exacerbates water scarcity in  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mvulnerable regions.                                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mSoil Health\u001b[0m: Climate change affects soil moisture and fertility, leading to degradation and erosion. These   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mchanges compromise soil health, essential for sustaining agricultural productivity.                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mPests and Diseases\u001b[0m: Warmer climates expand the range and lifecycle of pests and diseases, presenting new     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mchallenges for crop protection and necessitating innovative pest management strategies.                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 5 \u001b[0m\u001b[1mCrop Viability\u001b[0m: Traditional growing areas may no longer support certain crops, prompting shifts in           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0magricultural practices and crop selection to adapt to changing conditions.                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mRegional Variability\u001b[0m                                                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m The impact of climate change on agriculture is not uniform across the globe. Temperate regions might experience \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m benefits such as longer growing seasons, while tropical and subtropical areas could suffer from increased heat  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m and water stress. Developing countries, with limited resources and adaptive capacity, are particularly          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m vulnerable to these changes.                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mAdaptation Strategies\u001b[0m                                                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mCrop Diversification\u001b[0m: Introducing a variety of crops can reduce dependency on a single type, enhancing       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mresilience to climate variability.                                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mImproved Irrigation\u001b[0m: Developing efficient irrigation systems is crucial for optimizing water use and         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mensuring crop survival during periods of water scarcity.                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mGenetic Modification\u001b[0m: Breeding or genetically modifying crops to withstand extreme weather conditions,       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mpests, and diseases is a promising adaptation strategy.                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mSustainable Practices\u001b[0m: Implementing sustainable agricultural practices, such as conservation tillage,        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0magroforestry, and integrated pest management, can mitigate the adverse effects of climate change.            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mPolicy and Global Efforts\u001b[0m                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m International agreements, such as the Paris Agreement, aim to limit global warming and support adaptation       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m efforts. Governments and organizations are investing in research and development to create climate-resilient    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m agricultural systems, emphasizing the importance of global cooperation in addressing these challenges.          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mFuture Outlook\u001b[0m                                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Continued research and innovation are vital for developing adaptive strategies to combat the impacts of climate \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m change on agriculture. Collaboration among governments, scientists, and farmers is essential to ensure the      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m sustainability of agricultural systems and food security in the face of climate change.                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mConclusion\u001b[0m                                                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Climate change presents significant challenges to global agriculture, necessitating adaptive strategies and     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m international cooperation. By understanding the impacts and implementing effective adaptation measures, the     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m agricultural sector can enhance its resilience and continue to provide for the growing global population.       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "🧠 Final Output:\n",
+      " **Final Report: Climate Change and Its Impact on Global Agriculture**\n",
+      "\n",
+      "**Introduction**\n",
+      "\n",
+      "Climate change, characterized by significant alterations in global temperatures and weather patterns, poses a profound threat to global agriculture. While naturally occurring, the acceleration of climate change due to human activities such as fossil fuel combustion and deforestation has exacerbated its impacts on agricultural systems worldwide. This report examines the multifaceted effects of climate change on agriculture, regional variability, adaptation strategies, policy efforts, and future outlooks.\n",
+      "\n",
+      "**Impact on Agriculture**\n",
+      "\n",
+      "1. **Temperature Changes**: The rise in global temperatures induces heat stress in crops, potentially reducing yields. While some regions may benefit from extended growing seasons, others face shortened periods due to extreme heat, adversely affecting crop productivity.\n",
+      "\n",
+      "2. **Water Availability**: Altered precipitation patterns result in droughts and floods, disrupting water availability for irrigation. This variability threatens crop productivity and exacerbates water scarcity in vulnerable regions.\n",
+      "\n",
+      "3. **Soil Health**: Climate change affects soil moisture and fertility, leading to degradation and erosion. These changes compromise soil health, essential for sustaining agricultural productivity.\n",
+      "\n",
+      "4. **Pests and Diseases**: Warmer climates expand the range and lifecycle of pests and diseases, presenting new challenges for crop protection and necessitating innovative pest management strategies.\n",
+      "\n",
+      "5. **Crop Viability**: Traditional growing areas may no longer support certain crops, prompting shifts in agricultural practices and crop selection to adapt to changing conditions.\n",
+      "\n",
+      "**Regional Variability**\n",
+      "\n",
+      "The impact of climate change on agriculture is not uniform across the globe. Temperate regions might experience benefits such as longer growing seasons, while tropical and subtropical areas could suffer from increased heat and water stress. Developing countries, with limited resources and adaptive capacity, are particularly vulnerable to these changes.\n",
+      "\n",
+      "**Adaptation Strategies**\n",
+      "\n",
+      "1. **Crop Diversification**: Introducing a variety of crops can reduce dependency on a single type, enhancing resilience to climate variability.\n",
+      "\n",
+      "2. **Improved Irrigation**: Developing efficient irrigation systems is crucial for optimizing water use and ensuring crop survival during periods of water scarcity.\n",
+      "\n",
+      "3. **Genetic Modification**: Breeding or genetically modifying crops to withstand extreme weather conditions, pests, and diseases is a promising adaptation strategy.\n",
+      "\n",
+      "4. **Sustainable Practices**: Implementing sustainable agricultural practices, such as conservation tillage, agroforestry, and integrated pest management, can mitigate the adverse effects of climate change.\n",
+      "\n",
+      "**Policy and Global Efforts**\n",
+      "\n",
+      "International agreements, such as the Paris Agreement, aim to limit global warming and support adaptation efforts. Governments and organizations are investing in research and development to create climate-resilient agricultural systems, emphasizing the importance of global cooperation in addressing these challenges.\n",
+      "\n",
+      "**Future Outlook**\n",
+      "\n",
+      "Continued research and innovation are vital for developing adaptive strategies to combat the impacts of climate change on agriculture. Collaboration among governments, scientists, and farmers is essential to ensure the sustainability of agricultural systems and food security in the face of climate change.\n",
+      "\n",
+      "**Conclusion**\n",
+      "\n",
+      "Climate change presents significant challenges to global agriculture, necessitating adaptive strategies and international cooperation. By understanding the impacts and implementing effective adaptation measures, the agricultural sector can enhance its resilience and continue to provide for the growing global population.\n"
+     ]
+    }
+   ],
+   "source": [
+    "input_query = \"Create a strategy for launching an eco-friendly clothing brand online.\"\n",
+    "output = cognitive_team.start(input=input_query)\n",
+    "\n",
+    "# 📄 Show the output\n",
+    "print(\"🧠 Final Output:\\n\", output)\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/Crypto_Research_Agent_Intelligence_Agent.ipynb

@@ -0,0 +1,570 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "c1e38932",
+   "metadata": {
+    "id": "c1e38932"
+   },
+   "source": [
+    "# Crypto Research Agent: Intelligence Agent\n",
+    "\n",
+    "Provides in-depth intelligence on cryptocurrencies and blockchain trends."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "AEOWA14-doQb",
+   "metadata": {
+    "id": "AEOWA14-doQb"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Crypto_Research_Agent_Intelligence_Agent.ipynb)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "BY5w8KLtdNrW",
+   "metadata": {
+    "id": "BY5w8KLtdNrW"
+   },
+   "source": [
+    "# Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "9a818525",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "9a818525",
+    "outputId": "e7efcca2-e557-4f7b-df9e-aca4819b0f36"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/3.3 MB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[91m━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.3/3.3 MB\u001b[0m \u001b[31m8.5 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K   \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━\u001b[0m \u001b[32m2.3/3.3 MB\u001b[0m \u001b[31m35.3 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m3.3/3.3 MB\u001b[0m \u001b[31m33.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q praisonaiagents openai duckduckgo_search"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "AYjc8JUddT_D",
+   "metadata": {
+    "id": "AYjc8JUddT_D"
+   },
+   "source": [
+    "# set OpenAI API key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "88607f1c",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "88607f1c",
+    "outputId": "c2165b61-d633-467a-9ed7-5470619872b3"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Enter your OpenAI API key: ··········\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "from getpass import getpass\n",
+    "\n",
+    "# 🔑 Prompt user to input API Key securely\n",
+    "os.environ[\"OPENAI_API_KEY\"] = getpass(\"Enter your OpenAI API key: \")\n",
+    "import openai\n",
+    "openai.api_key = os.getenv(\"OPENAI_API_KEY\")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "AdXjFQqfdYgM",
+   "metadata": {
+    "id": "AdXjFQqfdYgM"
+   },
+   "source": [
+    "# Import PraisonAI Agent tools"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "d4e08a56",
+   "metadata": {
+    "id": "d4e08a56"
+   },
+   "outputs": [],
+   "source": [
+    "from praisonaiagents import Agent, Task, PraisonAIAgents"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "FdIqAryqdcpx",
+   "metadata": {
+    "id": "FdIqAryqdcpx"
+   },
+   "source": [
+    "# YAML Prompt to guide the agent's behavior"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "14b09931",
+   "metadata": {
+    "id": "14b09931"
+   },
+   "outputs": [],
+   "source": [
+    "yaml_prompt = \"\"\"\n",
+    "name: CryptoResearcherAgent\n",
+    "role: Cryptocurrency Intelligence Agent\n",
+    "goal: Provide accurate, timely, and insightful research on cryptocurrency projects, trends, and risks.\n",
+    "backstory: You are a professional crypto analyst, skilled in assessing coins, tokens, and DeFi protocols using web research and market trends.\n",
+    "skills:\n",
+    "  - Analyze tokenomics and utility\n",
+    "  - Evaluate risk factors\n",
+    "  - Identify scams or red flags\n",
+    "  - Summarize project fundamentals\n",
+    "llm: gpt-4o\n",
+    "verbosity: true\n",
+    "format: markdown\n",
+    "\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "at0Avm1Jdj8e",
+   "metadata": {
+    "id": "at0Avm1Jdj8e"
+   },
+   "source": [
+    "# Main"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "427a4c33",
+   "metadata": {
+    "id": "427a4c33"
+   },
+   "outputs": [],
+   "source": [
+    "crypto_agent = Agent(\n",
+    "    name=\"CryptoResearcherAgent\",\n",
+    "    instructions=\"\"\"\n",
+    "You are a cryptocurrency intelligence agent. Use your analytical skills to evaluate coins, blockchain protocols, tokenomics,\n",
+    "and market trends. Provide critical insight into legitimacy, potential growth, and associated risks.\n",
+    "Use markdown formatting and structure your research clearly.\n",
+    "\"\"\",\n",
+    "    llm=\"gpt-4o\",\n",
+    "    verbose=True,\n",
+    "    markdown=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "WjtlKYqjdCNe",
+   "metadata": {
+    "id": "WjtlKYqjdCNe"
+   },
+   "outputs": [],
+   "source": [
+    "crypto_task = Task(\n",
+    "    name=\"CryptoResearchTask\",\n",
+    "    description=\"Research and summarize the fundamentals, risks, and potential of the 'Render Token (RNDR)'\",\n",
+    "    expected_output=\"A detailed markdown report covering utility, tokenomics, risks, growth outlook, and red flags.\",\n",
+    "    agent=crypto_agent\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "MxqIDnRQdETe",
+   "metadata": {
+    "id": "MxqIDnRQdETe"
+   },
+   "outputs": [],
+   "source": [
+    "crypto_team = PraisonAIAgents(\n",
+    "    agents=[crypto_agent],\n",
+    "    tasks=[crypto_task],\n",
+    "    process=\"sequential\",\n",
+    "    verbose=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "hAs8UHnYdhsE",
+   "metadata": {
+    "id": "hAs8UHnYdhsE"
+   },
+   "source": [
+    "# Query the agent with a specific token or trend"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "236n5O9mdHQY",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 1000,
+     "referenced_widgets": [
+      "70fae1edbacb4b3592d5aab39d96c41d",
+      "1cfd76f73f0a44989fdcfd0b3cb2c12d"
+     ]
+    },
+    "id": "236n5O9mdHQY",
+    "outputId": "d519c155-03d0-4610-dfe3-b22855a260d4"
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">CryptoResearcherAgent</span>                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mCryptoResearcherAgent\u001b[0m                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "70fae1edbacb4b3592d5aab39d96c41d",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 9.7s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 9.7s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Research and summarize the fundamentals, risks, and potential of the 'Render <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Token (RNDR)'. Expected Output: A detailed markdown report covering utility, tokenomics, risks, growth outlook, <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> and red flags.. Please provide only the final result of your work. Do not add any conversation or extra         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> explanation.                                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Research and summarize the fundamentals, risks, and potential of the 'Render \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Token (RNDR)'. Expected Output: A detailed markdown report covering utility, tokenomics, risks, growth outlook, \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m and red flags.. Please provide only the final result of your work. Do not add any conversation or extra         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m explanation.                                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┃                                        <span style=\"font-weight: bold\">Render Token (RNDR) Analysis</span>                                         ┃ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                    <span style=\"font-weight: bold; text-decoration: underline\">Overview</span>                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Render Token (RNDR) is a utility token used within the Render Network, a decentralized GPU rendering network    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> built on the Ethereum blockchain. It aims to connect users in need of rendering power with those who have idle  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> GPUs to spare, facilitating a marketplace for rendering services.                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                     <span style=\"font-weight: bold; text-decoration: underline\">Utility</span>                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Rendering Services</span>: RNDR is primarily used to pay for rendering services on the Render Network. Users submit <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>rendering jobs and pay in RNDR tokens, while node operators (those providing GPU power) earn RNDR for        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>completing these tasks.                                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Decentralized Network</span>: By leveraging idle GPU resources globally, Render Network offers a decentralized      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>alternative to traditional cloud rendering services, potentially reducing costs and increasing efficiency.   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Blockchain Integration</span>: The use of blockchain ensures transparency, security, and immutability of            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>transactions within the network.                                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                   <span style=\"font-weight: bold; text-decoration: underline\">Tokenomics</span>                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Supply</span>: RNDR has a capped supply, which can create scarcity and potentially drive value as demand for        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>rendering services increases.                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Distribution</span>: Tokens are distributed to node operators as compensation for rendering services, incentivizing <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>participation in the network.                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Staking</span>: Node operators may need to stake RNDR tokens as a form of security deposit, aligning their          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>interests with the network's integrity.                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                      <span style=\"font-weight: bold; text-decoration: underline\">Risks</span>                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Market Competition</span>: Render Network faces competition from established cloud rendering services like AWS and  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>Google Cloud, which have significant resources and market presence.                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Adoption and Demand</span>: The success of RNDR is heavily reliant on the adoption of the Render Network. If the    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>network fails to attract a substantial user base, demand for RNDR could stagnate.                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Regulatory Risks</span>: As with many cryptocurrencies, RNDR is subject to regulatory scrutiny which could impact   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>its utility and marketability.                                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Technical Challenges</span>: Ensuring the network's reliability and security is crucial. Any technical failures     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>could undermine trust and deter users.                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                 <span style=\"font-weight: bold; text-decoration: underline\">Growth Outlook</span>                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Increasing Demand for Rendering</span>: As industries like gaming, film, and virtual reality continue to grow, the  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>demand for rendering services is expected to rise, potentially benefiting RNDR.                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Partnerships and Integrations</span>: Strategic partnerships with industry players could enhance the network's      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>credibility and expand its user base.                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Technological Advancements</span>: Improvements in blockchain technology and GPU capabilities could enhance the     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>efficiency and appeal of the Render Network.                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                    <span style=\"font-weight: bold; text-decoration: underline\">Red Flags</span>                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Centralization Concerns</span>: While the network is decentralized, the initial distribution and control of tokens  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>could raise concerns about centralization.                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Volatility</span>: Like many cryptocurrencies, RNDR is subject to high market volatility, which could affect its    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>stability as a utility token.                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Dependency on Ethereum</span>: As an ERC-20 token, RNDR's performance is tied to the Ethereum network, including    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>its scalability and transaction costs.                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                   <span style=\"font-weight: bold; text-decoration: underline\">Conclusion</span>                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Render Token (RNDR) presents a promising solution for decentralized rendering services, leveraging blockchain   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> technology to create a marketplace for GPU power. While it has potential for growth, particularly with          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> increasing demand for rendering, it faces significant risks from competition, adoption challenges, and          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> regulatory scrutiny. Investors and users should weigh these factors carefully when considering involvement with <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> RNDR.                                                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┃                                        \u001b[1mRender Token (RNDR) Analysis\u001b[0m                                         ┃ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                    \u001b[1;4mOverview\u001b[0m                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Render Token (RNDR) is a utility token used within the Render Network, a decentralized GPU rendering network    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m built on the Ethereum blockchain. It aims to connect users in need of rendering power with those who have idle  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m GPUs to spare, facilitating a marketplace for rendering services.                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                     \u001b[1;4mUtility\u001b[0m                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mRendering Services\u001b[0m: RNDR is primarily used to pay for rendering services on the Render Network. Users submit \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mrendering jobs and pay in RNDR tokens, while node operators (those providing GPU power) earn RNDR for        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mcompleting these tasks.                                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mDecentralized Network\u001b[0m: By leveraging idle GPU resources globally, Render Network offers a decentralized      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0malternative to traditional cloud rendering services, potentially reducing costs and increasing efficiency.   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mBlockchain Integration\u001b[0m: The use of blockchain ensures transparency, security, and immutability of            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mtransactions within the network.                                                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                   \u001b[1;4mTokenomics\u001b[0m                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mSupply\u001b[0m: RNDR has a capped supply, which can create scarcity and potentially drive value as demand for        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mrendering services increases.                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mDistribution\u001b[0m: Tokens are distributed to node operators as compensation for rendering services, incentivizing \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mparticipation in the network.                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mStaking\u001b[0m: Node operators may need to stake RNDR tokens as a form of security deposit, aligning their          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0minterests with the network's integrity.                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                      \u001b[1;4mRisks\u001b[0m                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mMarket Competition\u001b[0m: Render Network faces competition from established cloud rendering services like AWS and  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mGoogle Cloud, which have significant resources and market presence.                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mAdoption and Demand\u001b[0m: The success of RNDR is heavily reliant on the adoption of the Render Network. If the    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mnetwork fails to attract a substantial user base, demand for RNDR could stagnate.                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mRegulatory Risks\u001b[0m: As with many cryptocurrencies, RNDR is subject to regulatory scrutiny which could impact   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mits utility and marketability.                                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mTechnical Challenges\u001b[0m: Ensuring the network's reliability and security is crucial. Any technical failures     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mcould undermine trust and deter users.                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                 \u001b[1;4mGrowth Outlook\u001b[0m                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mIncreasing Demand for Rendering\u001b[0m: As industries like gaming, film, and virtual reality continue to grow, the  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mdemand for rendering services is expected to rise, potentially benefiting RNDR.                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPartnerships and Integrations\u001b[0m: Strategic partnerships with industry players could enhance the network's      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mcredibility and expand its user base.                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mTechnological Advancements\u001b[0m: Improvements in blockchain technology and GPU capabilities could enhance the     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mefficiency and appeal of the Render Network.                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                    \u001b[1;4mRed Flags\u001b[0m                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCentralization Concerns\u001b[0m: While the network is decentralized, the initial distribution and control of tokens  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mcould raise concerns about centralization.                                                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mVolatility\u001b[0m: Like many cryptocurrencies, RNDR is subject to high market volatility, which could affect its    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mstability as a utility token.                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mDependency on Ethereum\u001b[0m: As an ERC-20 token, RNDR's performance is tied to the Ethereum network, including    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mits scalability and transaction costs.                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                   \u001b[1;4mConclusion\u001b[0m                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Render Token (RNDR) presents a promising solution for decentralized rendering services, leveraging blockchain   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m technology to create a marketplace for GPU power. While it has potential for growth, particularly with          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m increasing demand for rendering, it faces significant risks from competition, adoption challenges, and          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m regulatory scrutiny. Investors and users should weigh these factors carefully when considering involvement with \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m RNDR.                                                                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "🪙 Crypto Research Report:\n",
+      " # Render Token (RNDR) Analysis\n",
+      "\n",
+      "## Overview\n",
+      "Render Token (RNDR) is a utility token used within the Render Network, a decentralized GPU rendering network built on the Ethereum blockchain. It aims to connect users in need of rendering power with those who have idle GPUs to spare, facilitating a marketplace for rendering services.\n",
+      "\n",
+      "## Utility\n",
+      "- **Rendering Services**: RNDR is primarily used to pay for rendering services on the Render Network. Users submit rendering jobs and pay in RNDR tokens, while node operators (those providing GPU power) earn RNDR for completing these tasks.\n",
+      "- **Decentralized Network**: By leveraging idle GPU resources globally, Render Network offers a decentralized alternative to traditional cloud rendering services, potentially reducing costs and increasing efficiency.\n",
+      "- **Blockchain Integration**: The use of blockchain ensures transparency, security, and immutability of transactions within the network.\n",
+      "\n",
+      "## Tokenomics\n",
+      "- **Supply**: RNDR has a capped supply, which can create scarcity and potentially drive value as demand for rendering services increases.\n",
+      "- **Distribution**: Tokens are distributed to node operators as compensation for rendering services, incentivizing participation in the network.\n",
+      "- **Staking**: Node operators may need to stake RNDR tokens as a form of security deposit, aligning their interests with the network's integrity.\n",
+      "\n",
+      "## Risks\n",
+      "- **Market Competition**: Render Network faces competition from established cloud rendering services like AWS and Google Cloud, which have significant resources and market presence.\n",
+      "- **Adoption and Demand**: The success of RNDR is heavily reliant on the adoption of the Render Network. If the network fails to attract a substantial user base, demand for RNDR could stagnate.\n",
+      "- **Regulatory Risks**: As with many cryptocurrencies, RNDR is subject to regulatory scrutiny which could impact its utility and marketability.\n",
+      "- **Technical Challenges**: Ensuring the network's reliability and security is crucial. Any technical failures could undermine trust and deter users.\n",
+      "\n",
+      "## Growth Outlook\n",
+      "- **Increasing Demand for Rendering**: As industries like gaming, film, and virtual reality continue to grow, the demand for rendering services is expected to rise, potentially benefiting RNDR.\n",
+      "- **Partnerships and Integrations**: Strategic partnerships with industry players could enhance the network's credibility and expand its user base.\n",
+      "- **Technological Advancements**: Improvements in blockchain technology and GPU capabilities could enhance the efficiency and appeal of the Render Network.\n",
+      "\n",
+      "## Red Flags\n",
+      "- **Centralization Concerns**: While the network is decentralized, the initial distribution and control of tokens could raise concerns about centralization.\n",
+      "- **Volatility**: Like many cryptocurrencies, RNDR is subject to high market volatility, which could affect its stability as a utility token.\n",
+      "- **Dependency on Ethereum**: As an ERC-20 token, RNDR's performance is tied to the Ethereum network, including its scalability and transaction costs.\n",
+      "\n",
+      "## Conclusion\n",
+      "Render Token (RNDR) presents a promising solution for decentralized rendering services, leveraging blockchain technology to create a marketplace for GPU power. While it has potential for growth, particularly with increasing demand for rendering, it faces significant risks from competition, adoption challenges, and regulatory scrutiny. Investors and users should weigh these factors carefully when considering involvement with RNDR.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query = \"Research Render Token (RNDR), its tokenomics, risks, and growth potential.\"\n",
+    "output = crypto_team.start(input=query)\n",
+    "\n",
+    "# 📄 Output the result\n",
+    "print(\"🪙 Crypto Research Report:\\n\", output)\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/DeepSeek_Qwen3_GRPO.ipynb

@@ -0,0 +1,172 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "29d21289",
+      "metadata": {
+        "id": "29d21289"
+      },
+      "source": [
+        "# DeepSeek R1 Qwen3 (8B) - GRPO Agent Demo"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/DeepSeek_Qwen3_GRPO.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "yuOEagMH86WV"
+      },
+      "id": "yuOEagMH86WV"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0f798657",
+      "metadata": {
+        "id": "0f798657"
+      },
+      "source": [
+        "This notebook demonstrates the usage of DeepSeek's Qwen3-8B model with GRPO (Guided Reasoning Prompt Optimization) for interactive conversational reasoning tasks.\n",
+        "It is designed to simulate a lightweight agent-style reasoning capability in an accessible and interpretable way."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "80f3de9e",
+      "metadata": {
+        "id": "80f3de9e"
+      },
+      "source": [
+        "## Dependencies"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "8d1c7f6c",
+      "metadata": {
+        "id": "8d1c7f6c"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install -q transformers accelerate"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "78603e7b",
+      "metadata": {
+        "id": "78603e7b"
+      },
+      "source": [
+        "## Tools"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "88e97fbc",
+      "metadata": {
+        "id": "88e97fbc"
+      },
+      "source": [
+        "- `transformers`: For model loading and interaction\n",
+        "- `AutoModelForCausalLM`, `AutoTokenizer`: Interfaces for DeepSeek's LLM"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "37d9bd54",
+      "metadata": {
+        "id": "37d9bd54"
+      },
+      "source": [
+        "## YAML Prompt"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "adf5cae5",
+      "metadata": {
+        "id": "adf5cae5"
+      },
+      "outputs": [],
+      "source": [
+        "\n",
+        "prompt:\n",
+        "  task: \"Reasoning over multi-step instructions\"\n",
+        "  context: \"User provides a math problem or logical question.\"\n",
+        "  model: \"deepseek-ai/deepseek-moe-16b-chat\"\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "6985f60c",
+      "metadata": {
+        "id": "6985f60c"
+      },
+      "source": [
+        "## Main"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "d74bf686",
+      "metadata": {
+        "id": "d74bf686"
+      },
+      "outputs": [],
+      "source": [
+        "\n",
+        "from transformers import AutoTokenizer, AutoModelForCausalLM, pipeline\n",
+        "\n",
+        "model_id = \"deepseek-ai/deepseek-moe-16b-chat\"\n",
+        "tokenizer = AutoTokenizer.from_pretrained(model_id)\n",
+        "model = AutoModelForCausalLM.from_pretrained(model_id, device_map=\"auto\")\n",
+        "\n",
+        "pipe = pipeline(\"text-generation\", model=model, tokenizer=tokenizer)\n",
+        "\n",
+        "prompt = \"If a train travels 60 miles in 1.5 hours, what is its average speed?\"\n",
+        "output = pipe(prompt, max_new_tokens=60)[0]['generated_text']\n",
+        "print(\"🧠 Reasoned Output:\", output)\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "c856167f",
+      "metadata": {
+        "id": "c856167f"
+      },
+      "source": [
+        "## Output"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "41039ee8",
+      "metadata": {
+        "id": "41039ee8"
+      },
+      "source": [
+        "### 🖼️ Output Summary\n",
+        "\n",
+        "Prompt: *\"If a train travels 60 miles in 1.5 hours, what is its average speed?\"*\n",
+        "\n",
+        "🧠 Output: The model provides a clear reasoning process, such as:\n",
+        "\n",
+        "> \"To find the average speed, divide the total distance by total time: 60 / 1.5 = 40 mph.\"\n",
+        "\n",
+        "💡 This shows the model's ability to walk through logical steps using GRPO-enhanced reasoning."
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/E_commerce_Shopping_Assistant.ipynb

@@ -0,0 +1,558 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "e722180e",
+   "metadata": {
+    "id": "e722180e"
+   },
+   "source": [
+    "# E-commerce Shopping Assistant\n",
+    "\n",
+    "Helps users discover, compare, and decide on product purchases online."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "vcl39flucPf5",
+   "metadata": {
+    "id": "vcl39flucPf5"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/E_commerce_Shopping_Assistant.ipynb)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "fPf-zKw9b2s2",
+   "metadata": {
+    "id": "fPf-zKw9b2s2"
+   },
+   "source": [
+    "# Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "f6e9a03f",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "f6e9a03f",
+    "outputId": "55cd3cef-266d-4e53-edde-4ceab0b456cd"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/3.3 MB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[91m━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.3/3.3 MB\u001b[0m \u001b[31m9.1 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K   \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━\u001b[0m \u001b[32m2.4/3.3 MB\u001b[0m \u001b[31m35.1 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m3.3/3.3 MB\u001b[0m \u001b[31m32.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q praisonaiagents openai duckduckgo_search"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ryXTdYdRb6l7",
+   "metadata": {
+    "id": "ryXTdYdRb6l7"
+   },
+   "source": [
+    "# set OpenAI API key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "a91f87c8",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "a91f87c8",
+    "outputId": "25405986-1ac7-4002-f0ab-76a312e2b3f8"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Enter your OpenAI API key: ··········\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "from getpass import getpass\n",
+    "\n",
+    "os.environ[\"OPENAI_API_KEY\"] = getpass(\"Enter your OpenAI API key: \")\n",
+    "import openai\n",
+    "openai.api_key = os.getenv(\"OPENAI_API_KEY\")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0OW7ml8HcAnh",
+   "metadata": {
+    "id": "0OW7ml8HcAnh"
+   },
+   "source": [
+    "# Import PraisonAI Agent tools"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "3c1fdf11",
+   "metadata": {
+    "id": "3c1fdf11"
+   },
+   "outputs": [],
+   "source": [
+    "from praisonaiagents import Agent, Task, PraisonAIAgents"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "Z0rtEk9VcDvt",
+   "metadata": {
+    "id": "Z0rtEk9VcDvt"
+   },
+   "source": [
+    "# Define the Shopping Assistant Agent"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "71731420",
+   "metadata": {
+    "id": "71731420"
+   },
+   "outputs": [],
+   "source": [
+    "shopping_assistant = Agent(\n",
+    "    name=\"EcommerceShoppingAgent\",\n",
+    "    instructions=(\n",
+    "        \"You are a smart e-commerce shopping assistant. \"\n",
+    "        \"Your goal is to help users find the best product deals, recommend items, and compare features from online sources. \"\n",
+    "        \"Use research and product comparison strategies.\"\n",
+    "    ),\n",
+    "    verbose=True,\n",
+    "    markdown=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "jipAX79fcHXy",
+   "metadata": {
+    "id": "jipAX79fcHXy"
+   },
+   "source": [
+    "# Define a Task for Shopping Assistant"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "9b55dbe3",
+   "metadata": {
+    "id": "9b55dbe3"
+   },
+   "outputs": [],
+   "source": [
+    "shopping_task = Task(\n",
+    "    name=\"FindProductDeals\",\n",
+    "    description=\"Find the best deals and compare features for the latest wireless earbuds under $100\",\n",
+    "    expected_output=\"A list of recommended wireless earbuds under $100 with pros, cons, and prices\",\n",
+    "    agent=shopping_assistant\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6lKHyYwycKXr",
+   "metadata": {
+    "id": "6lKHyYwycKXr"
+   },
+   "source": [
+    "# Create the Assistant System"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "zEpJ7IkFbvKW",
+   "metadata": {
+    "id": "zEpJ7IkFbvKW"
+   },
+   "outputs": [],
+   "source": [
+    "assistant_system = PraisonAIAgents(\n",
+    "    agents=[shopping_assistant],\n",
+    "    tasks=[shopping_task],\n",
+    "    process=\"sequential\",\n",
+    "    verbose=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "yuTZ2fWpcNI8",
+   "metadata": {
+    "id": "yuTZ2fWpcNI8"
+   },
+   "source": [
+    "# Run the Agent System"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "NQKri37Ubw-S",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 1000,
+     "referenced_widgets": [
+      "8f64ad3584b74928b9069fe84ff178db",
+      "2e4b43c537924f8e8ab8d17696a90330"
+     ]
+    },
+    "id": "NQKri37Ubw-S",
+    "outputId": "6741cd08-37c6-4d5a-aacd-a6ca44104dc1"
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">EcommerceShoppingAgent</span>                                                                               <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mEcommerceShoppingAgent\u001b[0m                                                                               \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "8f64ad3584b74928b9069fe84ff178db",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 7.8s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 7.8s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Find the best deals and compare features for the latest wireless earbuds     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> under $100. Expected Output: A list of recommended wireless earbuds under $100 with pros, cons, and prices.     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Please provide only the final result of your work. Do not add any conversation or extra explanation.            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Find the best deals and compare features for the latest wireless earbuds     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m under $100. Expected Output: A list of recommended wireless earbuds under $100 with pros, cons, and prices.     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Please provide only the final result of your work. Do not add any conversation or extra explanation.            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">1. Anker Soundcore Life P2</span>                                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Price:</span> $49.99                                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Excellent battery life (up to 40 hours with case)                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>IPX7 waterproof rating                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Good sound quality with graphene drivers                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>USB-C charging                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>No active noise cancellation                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Limited touch controls                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">2. TOZO T6</span>                                                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Price:</span> $29.99                                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Affordable price                                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>IPX8 waterproof rating                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Touch controls                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Good sound quality for the price                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Average battery life (up to 6 hours per charge)                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>No active noise cancellation                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">3. JLab Audio JBuds Air</span>                                                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Price:</span> $49.99                                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Custom EQ3 sound settings                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>IP55 sweat resistance                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Good fit with multiple ear tips                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Integrated charging cable in the case                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Bulky charging case                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>No active noise cancellation                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">4. Skullcandy Sesh Evo</span>                                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Price:</span> $49.99                                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Tile tracking feature                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>IP55 sweat, water, and dust resistance                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Decent sound quality                                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Good battery life (up to 24 hours with case)                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Limited touch controls                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>No active noise cancellation                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">5. SoundPEATS TrueFree2</span>                                                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Price:</span> $39.99                                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Secure fit with ear fins                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>IPX7 waterproof rating                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Good sound quality                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>USB-C charging                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>No active noise cancellation                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Average battery life (up to 4 hours per charge)                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> These options provide a range of features and prices, allowing you to choose based on your specific needs and   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> preferences.                                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1m1. Anker Soundcore Life P2\u001b[0m                                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPrice:\u001b[0m $49.99                                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mExcellent battery life (up to 40 hours with case)                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mIPX7 waterproof rating                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGood sound quality with graphene drivers                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mUSB-C charging                                                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mNo active noise cancellation                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mLimited touch controls                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1m2. TOZO T6\u001b[0m                                                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPrice:\u001b[0m $29.99                                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAffordable price                                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mIPX8 waterproof rating                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mTouch controls                                                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGood sound quality for the price                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAverage battery life (up to 6 hours per charge)                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mNo active noise cancellation                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1m3. JLab Audio JBuds Air\u001b[0m                                                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPrice:\u001b[0m $49.99                                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mCustom EQ3 sound settings                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mIP55 sweat resistance                                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGood fit with multiple ear tips                                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mIntegrated charging cable in the case                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mBulky charging case                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mNo active noise cancellation                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1m4. Skullcandy Sesh Evo\u001b[0m                                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPrice:\u001b[0m $49.99                                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mTile tracking feature                                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mIP55 sweat, water, and dust resistance                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mDecent sound quality                                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGood battery life (up to 24 hours with case)                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mLimited touch controls                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mNo active noise cancellation                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1m5. SoundPEATS TrueFree2\u001b[0m                                                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPrice:\u001b[0m $39.99                                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mSecure fit with ear fins                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mIPX7 waterproof rating                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGood sound quality                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mUSB-C charging                                                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mNo active noise cancellation                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAverage battery life (up to 4 hours per charge)                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m These options provide a range of features and prices, allowing you to choose based on your specific needs and   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m preferences.                                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "🛍️ Shopping Assistant Output:\n",
+      " **1. Anker Soundcore Life P2**\n",
+      "\n",
+      "- **Price:** $49.99\n",
+      "- **Pros:** \n",
+      "  - Excellent battery life (up to 40 hours with case)\n",
+      "  - IPX7 waterproof rating\n",
+      "  - Good sound quality with graphene drivers\n",
+      "  - USB-C charging\n",
+      "- **Cons:** \n",
+      "  - No active noise cancellation\n",
+      "  - Limited touch controls\n",
+      "\n",
+      "**2. TOZO T6**\n",
+      "\n",
+      "- **Price:** $29.99\n",
+      "- **Pros:** \n",
+      "  - Affordable price\n",
+      "  - IPX8 waterproof rating\n",
+      "  - Touch controls\n",
+      "  - Good sound quality for the price\n",
+      "- **Cons:** \n",
+      "  - Average battery life (up to 6 hours per charge)\n",
+      "  - No active noise cancellation\n",
+      "\n",
+      "**3. JLab Audio JBuds Air**\n",
+      "\n",
+      "- **Price:** $49.99\n",
+      "- **Pros:** \n",
+      "  - Custom EQ3 sound settings\n",
+      "  - IP55 sweat resistance\n",
+      "  - Good fit with multiple ear tips\n",
+      "  - Integrated charging cable in the case\n",
+      "- **Cons:** \n",
+      "  - Bulky charging case\n",
+      "  - No active noise cancellation\n",
+      "\n",
+      "**4. Skullcandy Sesh Evo**\n",
+      "\n",
+      "- **Price:** $49.99\n",
+      "- **Pros:** \n",
+      "  - Tile tracking feature\n",
+      "  - IP55 sweat, water, and dust resistance\n",
+      "  - Decent sound quality\n",
+      "  - Good battery life (up to 24 hours with case)\n",
+      "- **Cons:** \n",
+      "  - Limited touch controls\n",
+      "  - No active noise cancellation\n",
+      "\n",
+      "**5. SoundPEATS TrueFree2**\n",
+      "\n",
+      "- **Price:** $39.99\n",
+      "- **Pros:** \n",
+      "  - Secure fit with ear fins\n",
+      "  - IPX7 waterproof rating\n",
+      "  - Good sound quality\n",
+      "  - USB-C charging\n",
+      "- **Cons:** \n",
+      "  - No active noise cancellation\n",
+      "  - Average battery life (up to 4 hours per charge)\n",
+      "\n",
+      "These options provide a range of features and prices, allowing you to choose based on your specific needs and preferences.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query = \"Find the best wireless earbuds under $100 with noise cancellation\"\n",
+    "output = assistant_system.start(input=query)\n",
+    "\n",
+    "# 📄 Display Output\n",
+    "print(\"🛍️ Shopping Assistant Output:\\n\", output)\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/Flow_Intelligent_Agent_PraisonAI.ipynb

@@ -0,0 +1,398 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "ZqmhthnKYNve"
+      },
+      "source": [
+        "# Flow – Intelligent Agent for Daily Efficiency"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "nPPyvagreZ_i"
+      },
+      "source": [
+        "# Description"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "5wMZC3_0edNZ"
+      },
+      "source": [
+        "This agent uses a custom DuckDuckGo search tool to intelligently retrieve and summarize real-time information based on user queries."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "mNFEBTyAek8E"
+      },
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Flow_Intelligent_Agent_PraisonAI.ipynb)\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "mHpIJFsZYNvi"
+      },
+      "source": [
+        "## Tools\n",
+        "- `praisonaiagents` – Intelligent Agent framework\n",
+        "- `duckduckgo-search` – Custom search tool\n",
+        "- `pyyaml` – YAML config\n",
+        "- `openai` – LLM backend"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "K1QOdZ8SYqoF"
+      },
+      "source": [
+        "# Dependencies"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "zZOiRidoYNvj"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install praisonaiagents duckduckgo-search pyyaml openai"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "_9jyGJrOYyKh"
+      },
+      "source": [
+        "# Set your OpenAI API Key securely"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "7huxRijxYNvk"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "os.environ['OPENAI_API_KEY'] = 'your api key'  # Replace with your actual OpenAI key"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "E3naWfHNYNvk"
+      },
+      "source": [
+        "## YAML Prompt\n",
+        "Define multiple agents and their roles."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "kYST2rZqYNvl"
+      },
+      "outputs": [],
+      "source": [
+        "import yaml\n",
+        "\n",
+        "yaml_prompt = '''\n",
+        "agents:\n",
+        "  - name: FlowAgent\n",
+        "    description: Intelligent daily workflow assistant\n",
+        "  - name: ChileAtiendeAI\n",
+        "    description: Government support assistant for Chile\n",
+        "  - name: ClinicalTrialMatcher\n",
+        "    description: Match patients to trials using input medical info\n",
+        "  - name: ChillWorkEmailAgent\n",
+        "    description: Automate email replies and scheduling\n",
+        "'''\n",
+        "\n",
+        "config = yaml.safe_load(yaml_prompt)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "tBryRalYYNvl"
+      },
+      "source": [
+        "## Main\n",
+        "Initialize agent with a custom DuckDuckGo tool and simulate a task."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 673,
+          "referenced_widgets": [
+            "865a918fc4d54fd0a110ea3eb7fe4215",
+            "c70a26d2c54549888067f65c366bdb9b"
+          ]
+        },
+        "id": "1mMAS_1PYNvl",
+        "outputId": "d3aacdd3-5e01-460b-ae66-385f6a62c1eb"
+      },
+      "outputs": [
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">FlowAgent</span>                                                                                            <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #86a789; text-decoration-color: #86a789; font-weight: bold\">Tools:</span> <span style=\"color: #b4d4ff; text-decoration-color: #b4d4ff; font-style: italic\">internet_search_tool</span>                                                                                    <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mFlowAgent\u001b[0m                                                                                            \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;134;167;137mTools:\u001b[0m \u001b[3;38;2;180;212;255minternet_search_tool\u001b[0m                                                                                    \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+            ],
+            "text/plain": []
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008000; text-decoration-color: #008000\">╭─────────────────────────────────────────────────── Tool Call ───────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">│</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">Agent FlowAgent is calling function 'internet_search_tool' with arguments: {'query': 'latest open-source AI </span>    <span style=\"color: #008000; text-decoration-color: #008000\">│</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">│</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">agent framework 2023'}</span>                                                                                          <span style=\"color: #008000; text-decoration-color: #008000\">│</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[32m╭─\u001b[0m\u001b[32m──────────────────────────────────────────────────\u001b[0m\u001b[32m Tool Call \u001b[0m\u001b[32m──────────────────────────────────────────────────\u001b[0m\u001b[32m─╮\u001b[0m\n",
+              "\u001b[32m│\u001b[0m \u001b[1;36mAgent FlowAgent is calling function 'internet_search_tool' with arguments: {'query': 'latest open-source AI \u001b[0m    \u001b[32m│\u001b[0m\n",
+              "\u001b[32m│\u001b[0m \u001b[1;36magent framework 2023'}\u001b[0m                                                                                          \u001b[32m│\u001b[0m\n",
+              "\u001b[32m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008000; text-decoration-color: #008000\">╭─────────────────────────────────────────────────── Tool Call ───────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">│</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">Function 'internet_search_tool' returned: \"OpenAgents - An Open Framework for Connecting AI Agents at Scale - </span>  <span style=\"color: #008000; text-decoration-color: #008000\">│</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">│</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">https://openagents.org/\\nAutoGen: Enabling Next-Gen LLM Applications via Multi-Agent ... - </span>                     <span style=\"color: #008000; text-decoration-color: #008000\">│</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">│</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">https://www.microsoft.com/en-us/research/publication/autogen-enabling-next-gen-llm-applications-via-multi-agent</span> <span style=\"color: #008000; text-decoration-color: #008000\">│</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">│</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">-conversation-framework/\\nOpen-source framework to build, manage and run useful Autonomous AI Agents - </span>         <span style=\"color: #008000; text-decoration-color: #008000\">│</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">│</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">https://github.com/TransformerOptimus/SuperAGI\"</span>                                                                 <span style=\"color: #008000; text-decoration-color: #008000\">│</span>\n",
+              "<span style=\"color: #008000; text-decoration-color: #008000\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[32m╭─\u001b[0m\u001b[32m──────────────────────────────────────────────────\u001b[0m\u001b[32m Tool Call \u001b[0m\u001b[32m──────────────────────────────────────────────────\u001b[0m\u001b[32m─╮\u001b[0m\n",
+              "\u001b[32m│\u001b[0m \u001b[1;36mFunction 'internet_search_tool' returned: \"OpenAgents - An Open Framework for Connecting AI Agents at Scale - \u001b[0m  \u001b[32m│\u001b[0m\n",
+              "\u001b[32m│\u001b[0m \u001b[1;36mhttps://openagents.org/\\nAutoGen: Enabling Next-Gen LLM Applications via Multi-Agent ... - \u001b[0m                     \u001b[32m│\u001b[0m\n",
+              "\u001b[32m│\u001b[0m \u001b[1;36mhttps://www.microsoft.com/en-us/research/publication/autogen-enabling-next-gen-llm-applications-via-multi-agent\u001b[0m \u001b[32m│\u001b[0m\n",
+              "\u001b[32m│\u001b[0m \u001b[1;36m-conversation-framework/\\nOpen-source framework to build, manage and run useful Autonomous AI Agents - \u001b[0m         \u001b[32m│\u001b[0m\n",
+              "\u001b[32m│\u001b[0m \u001b[1;36mhttps://github.com/TransformerOptimus/SuperAGI\"\u001b[0m                                                                 \u001b[32m│\u001b[0m\n",
+              "\u001b[32m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "865a918fc4d54fd0a110ea3eb7fe4215",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Output()"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+            ],
+            "text/plain": []
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 6.1s</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[2mResponse generated in 6.1s\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> What's the latest open-source AI agent framework?                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m What's the latest open-source AI agent framework?                                                               \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Here are some of the latest open-source AI agent frameworks:                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">OpenAgents</span>: An open framework for connecting AI agents at scale. More information can be found on their      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span><a href=\"https://openagents.org/\" target=\"_blank\"><span style=\"color: #000080; text-decoration-color: #000080; text-decoration: underline\">website</span></a>.                                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">AutoGen</span>: A framework by Microsoft Research that enables next-gen LLM applications via multi-agent            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>conversation. You can read more about it <a href=\"https://www.microsoft.com/en-us/research/publication/autogen-enabling-next-gen-llm-applications-via-multi-agent-conversation-framework/\" target=\"_blank\"><span style=\"color: #000080; text-decoration-color: #000080; text-decoration: underline\">here</span></a>.                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">SuperAGI</span>: An open-source framework to build, manage, and run useful autonomous AI agents. Check out their    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span><a href=\"https://github.com/TransformerOptimus/SuperAGI\" target=\"_blank\"><span style=\"color: #000080; text-decoration-color: #000080; text-decoration: underline\">GitHub repository</span></a> for more details.                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m Here are some of the latest open-source AI agent frameworks:                                                    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mOpenAgents\u001b[0m: An open framework for connecting AI agents at scale. More information can be found on their      \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b]8;id=900045;https://openagents.org/\u001b\\\u001b[4;34mwebsite\u001b[0m\u001b]8;;\u001b\\.                                                                                                     \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mAutoGen\u001b[0m: A framework by Microsoft Research that enables next-gen LLM applications via multi-agent            \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mconversation. You can read more about it \u001b]8;id=398797;https://www.microsoft.com/en-us/research/publication/autogen-enabling-next-gen-llm-applications-via-multi-agent-conversation-framework/\u001b\\\u001b[4;34mhere\u001b[0m\u001b]8;;\u001b\\.                                                               \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mSuperAGI\u001b[0m: An open-source framework to build, manage, and run useful autonomous AI agents. Check out their    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b]8;id=898758;https://github.com/TransformerOptimus/SuperAGI\u001b\\\u001b[4;34mGitHub repository\u001b[0m\u001b]8;;\u001b\\ for more details.                                                                          \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "Here are some of the latest open-source AI agent frameworks:\n",
+            "\n",
+            "1. **OpenAgents**: An open framework for connecting AI agents at scale. More information can be found on their [website](https://openagents.org/).\n",
+            "\n",
+            "2. **AutoGen**: A framework by Microsoft Research that enables next-gen LLM applications via multi-agent conversation. You can read more about it [here](https://www.microsoft.com/en-us/research/publication/autogen-enabling-next-gen-llm-applications-via-multi-agent-conversation-framework/).\n",
+            "\n",
+            "3. **SuperAGI**: An open-source framework to build, manage, and run useful autonomous AI agents. Check out their [GitHub repository](https://github.com/TransformerOptimus/SuperAGI) for more details.\n"
+          ]
+        }
+      ],
+      "source": [
+        "from praisonaiagents import Agent\n",
+        "from duckduckgo_search import DDGS\n",
+        "\n",
+        "def internet_search_tool(query: str):\n",
+        "    ddgs = DDGS()\n",
+        "    results = []\n",
+        "    for res in ddgs.text(keywords=query, max_results=3):\n",
+        "        results.append(f\"{res['title']} - {res['href']}\")\n",
+        "    return \"\\n\".join(results)\n",
+        "\n",
+        "# Initialize the main agent (FlowAgent)\n",
+        "flow_config = config['agents'][0]\n",
+        "flow_agent = Agent(\n",
+        "    name=flow_config['name'],\n",
+        "    instructions=flow_config['description'],\n",
+        "    tools=[internet_search_tool]\n",
+        ")\n",
+        "\n",
+        "response = flow_agent.start(\"What's the latest open-source AI agent framework?\")\n",
+        "print(response)"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.x"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

examples/cookbooks/Fuel_Emission_Agent_Intelligence_Agent.ipynb

@@ -0,0 +1,369 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "d2cd727d",
+      "metadata": {
+        "id": "d2cd727d"
+      },
+      "source": [
+        "# Fuel Emission Estimator & Forecasting Agent\n",
+        "\n",
+        "An intelligent agent that calculates annual CO₂ emissions based on user driving patterns and vehicle type. It also forecasts how emissions would change if the user switches to a more fuel-efficient or hybrid vehicle in the future. Powered by OpenAI and designed to assist individuals in making eco-conscious transportation decisions.\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "06ae55aa",
+      "metadata": {
+        "id": "06ae55aa"
+      },
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Fuel_Emission_Agent_Intelligence_Agent.ipynb)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "227e582f",
+      "metadata": {
+        "id": "227e582f"
+      },
+      "source": [
+        "# Dependencies"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "c59db014",
+      "metadata": {
+        "id": "c59db014"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install -q praisonaiagents openai duckduckgo_search \"anyio<4\""
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0L9HTI3GcU63",
+      "metadata": {
+        "id": "0L9HTI3GcU63"
+      },
+      "source": [
+        "# Set API Key"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "SpBU5DL5brYh",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "SpBU5DL5brYh",
+        "outputId": "e56c185c-5f0c-4939-e4dc-0418667a04a8"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🔐 Enter your OpenAI API Key: ··········\n"
+          ]
+        }
+      ],
+      "source": [
+        "import os\n",
+        "from getpass import getpass\n",
+        "\n",
+        "os.environ[\"OPENAI_API_KEY\"] = getpass(\"🔐 Enter your OpenAI API Key: \")\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "VBZ30nKucXvA",
+      "metadata": {
+        "id": "VBZ30nKucXvA"
+      },
+      "source": [
+        "# Create a Fuel Emission Agent"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "-C8fVp-1bwOu",
+      "metadata": {
+        "id": "-C8fVp-1bwOu"
+      },
+      "outputs": [],
+      "source": [
+        "from praisonaiagents import Agent\n",
+        "\n",
+        "yaml_prompt = \"\"\"\n",
+        "name: FuelEmissionMiniAgent\n",
+        "role: Calculate CO2 emissions based on user driving habits and forecast impact of switching to hybrid vehicles.\n",
+        "goal: Return estimated annual CO2 output and forecast change in emissions with different vehicle types.\n",
+        "tools:\n",
+        "  - openai\n",
+        "responses:\n",
+        "  - concise\n",
+        "  - clear\n",
+        "\"\"\"\n",
+        "\n",
+        "agent = Agent(\n",
+        "    name=\"FuelEmissionMiniAgent\",\n",
+        "    instructions=yaml_prompt\n",
+        ")\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "SQ7Pcki7ca1S",
+      "metadata": {
+        "id": "SQ7Pcki7ca1S"
+      },
+      "source": [
+        "# Run the Agent with Your Question"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "njNLFurYby3L",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 1000,
+          "referenced_widgets": [
+            "1b8ec3bc72c54cc4ae7649115185eda4",
+            "40ef4acb2e2341a883f0a6b12eee4d19"
+          ]
+        },
+        "id": "njNLFurYby3L",
+        "outputId": "3e3f886a-8af6-4357-d98c-f0c00006c755"
+      },
+      "outputs": [
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">FuelEmissionMiniAgent</span>                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mFuelEmissionMiniAgent\u001b[0m                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "1b8ec3bc72c54cc4ae7649115185eda4",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Output()"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+            ],
+            "text/plain": []
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 4.0s</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[2mResponse generated in 4.0s\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> I drive 12,000 km per year using a petrol car that gets 10 km/l. How much CO2 do I emit annually? How would     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> this change if I switch to a hybrid vehicle in 2 years?                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m I drive 12,000 km per year using a petrol car that gets 10 km/l. How much CO2 do I emit annually? How would     \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m this change if I switch to a hybrid vehicle in 2 years?                                                         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> To calculate your annual CO2 emissions, we first need to determine the amount of fuel you use annually:         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Fuel Consumption</span>:                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Distance driven per year: 12,000 km                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Fuel efficiency: 10 km/l                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Annual fuel consumption = 12,000 km / 10 km/l = 1,200 liters                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">CO2 Emissions</span>:                                                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Petrol emits approximately 2.31 kg of CO2 per liter.                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Annual CO2 emissions = 1,200 liters * 2.31 kg/l = 2,772 kg of CO2                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> If you switch to a hybrid vehicle in 2 years, let's assume the hybrid has a fuel efficiency of 20 km/l (a       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> common improvement over traditional petrol cars):                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Hybrid Fuel Consumption</span>:                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Distance driven per year: 12,000 km                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Hybrid fuel efficiency: 20 km/l                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Annual fuel consumption = 12,000 km / 20 km/l = 600 liters                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Hybrid CO2 Emissions</span>:                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Annual CO2 emissions = 600 liters * 2.31 kg/l = 1,386 kg of CO2                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Forecasted Change</span>:                                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span>Current annual emissions: 2,772 kg of CO2                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span>Future annual emissions with hybrid: 1,386 kg of CO2                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span>Reduction in emissions: 2,772 kg - 1,386 kg = 1,386 kg of CO2                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Switching to a hybrid vehicle could reduce your annual CO2 emissions by approximately 50%.                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m To calculate your annual CO2 emissions, we first need to determine the amount of fuel you use annually:         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mFuel Consumption\u001b[0m:                                                                                            \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mDistance driven per year: 12,000 km                                                                       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mFuel efficiency: 10 km/l                                                                                  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAnnual fuel consumption = 12,000 km / 10 km/l = 1,200 liters                                              \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mCO2 Emissions\u001b[0m:                                                                                               \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mPetrol emits approximately 2.31 kg of CO2 per liter.                                                      \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAnnual CO2 emissions = 1,200 liters * 2.31 kg/l = 2,772 kg of CO2                                         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m If you switch to a hybrid vehicle in 2 years, let's assume the hybrid has a fuel efficiency of 20 km/l (a       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m common improvement over traditional petrol cars):                                                               \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mHybrid Fuel Consumption\u001b[0m:                                                                                     \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mDistance driven per year: 12,000 km                                                                       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mHybrid fuel efficiency: 20 km/l                                                                           \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAnnual fuel consumption = 12,000 km / 20 km/l = 600 liters                                                \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mHybrid CO2 Emissions\u001b[0m:                                                                                        \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAnnual CO2 emissions = 600 liters * 2.31 kg/l = 1,386 kg of CO2                                           \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1mForecasted Change\u001b[0m:                                                                                              \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0mCurrent annual emissions: 2,772 kg of CO2                                                                    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0mFuture annual emissions with hybrid: 1,386 kg of CO2                                                         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0mReduction in emissions: 2,772 kg - 1,386 kg = 1,386 kg of CO2                                                \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m Switching to a hybrid vehicle could reduce your annual CO2 emissions by approximately 50%.                      \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "To calculate your annual CO2 emissions, we first need to determine the amount of fuel you use annually:\n",
+            "\n",
+            "1. **Fuel Consumption**:  \n",
+            "   - Distance driven per year: 12,000 km  \n",
+            "   - Fuel efficiency: 10 km/l  \n",
+            "   - Annual fuel consumption = 12,000 km / 10 km/l = 1,200 liters\n",
+            "\n",
+            "2. **CO2 Emissions**:  \n",
+            "   - Petrol emits approximately 2.31 kg of CO2 per liter.  \n",
+            "   - Annual CO2 emissions = 1,200 liters * 2.31 kg/l = 2,772 kg of CO2\n",
+            "\n",
+            "If you switch to a hybrid vehicle in 2 years, let's assume the hybrid has a fuel efficiency of 20 km/l (a common improvement over traditional petrol cars):\n",
+            "\n",
+            "1. **Hybrid Fuel Consumption**:  \n",
+            "   - Distance driven per year: 12,000 km  \n",
+            "   - Hybrid fuel efficiency: 20 km/l  \n",
+            "   - Annual fuel consumption = 12,000 km / 20 km/l = 600 liters\n",
+            "\n",
+            "2. **Hybrid CO2 Emissions**:  \n",
+            "   - Annual CO2 emissions = 600 liters * 2.31 kg/l = 1,386 kg of CO2\n",
+            "\n",
+            "**Forecasted Change**:  \n",
+            "- Current annual emissions: 2,772 kg of CO2  \n",
+            "- Future annual emissions with hybrid: 1,386 kg of CO2  \n",
+            "- Reduction in emissions: 2,772 kg - 1,386 kg = 1,386 kg of CO2\n",
+            "\n",
+            "Switching to a hybrid vehicle could reduce your annual CO2 emissions by approximately 50%.\n"
+          ]
+        }
+      ],
+      "source": [
+        "query = (\n",
+        "    \"I drive 12,000 km per year using a petrol car that gets 10 km/l. \"\n",
+        "    \"How much CO2 do I emit annually? How would this change if I switch to a hybrid vehicle in 2 years?\"\n",
+        ")\n",
+        "\n",
+        "response = agent.start(prompt=query)\n",
+        "print(response)\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Gemma2B_Instruction_Agent.ipynb

@@ -0,0 +1,605 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "PnWDOzZelHlE",
+   "metadata": {
+    "id": "PnWDOzZelHlE"
+   },
+   "source": [
+    "# 🌱 Gemma 2B Instruction Agent\n",
+    "\n",
+    "**Goal:** You will learn how to do data prep, how to train, how to run the model, and how to save it using Google’s `gemma-2b-it` open-source model.\n",
+    "\n",
+    "---\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4qumJb5qs9CF",
+   "metadata": {
+    "id": "4qumJb5qs9CF"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Gemma2B_Instruction_Agent.ipynb)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "qdsqiQDosXmA",
+   "metadata": {
+    "id": "qdsqiQDosXmA"
+   },
+   "source": [
+    "#  Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "6G4RPDe3lHlH",
+   "metadata": {
+    "id": "6G4RPDe3lHlH"
+   },
+   "outputs": [],
+   "source": [
+    "!pip install transformers accelerate datasets bitsandbytes -q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "mop0KNO7sdEl",
+   "metadata": {
+    "id": "mop0KNO7sdEl"
+   },
+   "source": [
+    "# Tools & Model Setup"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "spOeRX2UlHlI",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 369,
+     "referenced_widgets": [
+      "a2db67e368d94f579c59b36c6ce7af33",
+      "5816fa4288cd42d6b15094e2c79f760f",
+      "5d6fe9b464f944cdbb00b9936669e737",
+      "19920e5b8157423ba5d173dd376e52e6",
+      "bd7157974bc5485ab5b6db54facb9721",
+      "0063e7320c98440d91ae475596c5cd90",
+      "a0f045bc54754d5a85ed6bf7b6b33c1a",
+      "9174c5aff19b4caab8a38fbf3acb2449",
+      "3de0f0b7ecb34c488145b24e30418e4b",
+      "d4457543819d468eb916f126382184b0",
+      "08f90c04f0de4b1db57624db4b43e17d",
+      "269373e971704b9ea2e10e261b1c56d1",
+      "d54d35c945ce4f75af6f83f37dd6af6c",
+      "b828857fecdc40fa91f6a8633f0f20b4",
+      "b5e70949aea24ae9a75e45aa291cc3aa",
+      "9c556838b24246a8b39b1f3f9babfe4a",
+      "062b64d17b7043c1bccc419280c9db0a",
+      "138ae14327184f65896c29a424bad18d",
+      "cb65fa660df54218ad804815dfba4071",
+      "93d2454f1b564896bef50906e859c660",
+      "64e7861e6afc4b57b28063096533aac8",
+      "13fe0b8a8fd14a3684ae5d9beefb3f76",
+      "d1ec61e51d4c4b07b301959c4919f2a2",
+      "a45e9ed3d46645a18ca1f6b06f875ec9",
+      "a364770555cf40fdab5ff7bb85997127",
+      "12b3225aeb8c4f61b23b588738d48683",
+      "dca4952bae4c49ddb2fec2c36726a34d",
+      "163df8921f04425caed240465d8bd8b7",
+      "1a09718a80cd4bb5a9e985a3f599c614",
+      "71c719d57e4f4e23bd520f80e2e07e33",
+      "5e8c8eb7eba948fc8a39b601e9ac658e",
+      "db4fa2c97b7247c4826a1a9f69c1bed3",
+      "42a6f9c136584cc98fc2be973d9edaec",
+      "c1bc8cf2ed6542c49c1940673a662b1d",
+      "365b69634e2846a09b91de6b61d0719b",
+      "13eb69bc1c3c432db6c504856f3a0f7a",
+      "56444404d97549848ed729ee8bc14ec8",
+      "f0303454544d42a1ada2213a085a4ac0",
+      "c717969ed1b145a9af67d74482d49eab",
+      "9e9a826dfb264e44aa69c553d978729d",
+      "f2b4ff56a96c4d7e9f56668f6b7b5213",
+      "f71f0a3ccc654df288d7489abca0ffc0",
+      "5ab0574ed1db47e9b6f43e27acd6c2b2",
+      "426fae423dbb43ef9252e6fcfb099c6f",
+      "2e1c3ca06b2948f0bcf53a975dd67aec",
+      "3685a74a466a4ca0b5f05e7aee631d74",
+      "7bda5a4e803c4cbc8da67da8a565725b",
+      "5450fde9a54d450d90d14b009047b522",
+      "e827839bf4d34d2193776d1ee90d27ad",
+      "3d9854af016a4c3c8a582fc7f0f0b0bf",
+      "7045a11d5f0f4b2d8ff224bb76a9c943",
+      "32e568b25c2d447a8fa63055cb44c75c",
+      "ebd9d55db82542e5ae6bb9e715e36a6a",
+      "798a57883792465ab024dc19a58a54be",
+      "c9d1133770b44b22bda89f3d0eecd4f8",
+      "c040fa1bbd9f442884776fdf33efb4a2",
+      "c57e497d4fd546ff950eb2c898b94c88",
+      "5ae22935b7374219a16272cef31d6d9e",
+      "aae2686ee64740218d046ec37e50b584",
+      "87b4c953163a4cff8a88b76f40da9de8",
+      "30ee0e766fae44bfb570ae8adfba1a54",
+      "1c2db67dfc904e30a4013d9fe0253a4c",
+      "f6c5380bba0f40a4bea9b78d205eb726",
+      "0de9f765500b45428f828ad173dd279e",
+      "0663e5cfc20c496993b7c0054ce3d1a1",
+      "7ce5d369129b461681f424e52415e534",
+      "dfa90d76c670436a80f1a4fd0971b171",
+      "0694216654ac41909d567a8c4af247de",
+      "658048f25b4a4ad6a3ee66e97a542cc9",
+      "0edccfd243f940cfad9723b1d3f5a97c",
+      "32d473040a6744718b1b35543f2b3a0f",
+      "eadbfe846763427e98a40597560d8519",
+      "3cec8231bccb4bcf8d657ee8d2120f79",
+      "8bd43207fa8f4b309590f605ad81354f",
+      "8821912860f04105959ceb42e53de948",
+      "3666b044c757439f948f6942d7682c2f",
+      "d47e7c7504374fee82eef9f8cbe24eff",
+      "9c6d577f113f4f4baaa1f0e001549862",
+      "b0c88d34b0df46b7a3da8db42ff3274e",
+      "e4e4a2d0422b45c09c8691ce14ba9b9a",
+      "d9b1de1b37f14d70bc56a5f6cb468c9b",
+      "cb95b11368984236937fcec7cb689b04",
+      "69e70bfdafd4459491bad75651028626",
+      "a3b9f03c1f014691b5959fb9012c0bab",
+      "088da12bcff64297ad82dc7b2d01709e",
+      "8a69dc8aa84e49b1aabb58eddca1eee3",
+      "263e458b8a5f405bb1ee365fe561309d",
+      "aa3039e03447492da11f86185384470b",
+      "3c22264e11c0402fb07f56a0763dc055",
+      "db2c5746b8cc48d9a059bcef3b55217d",
+      "ad3ab2ab81f6469485a3072bd1ba6a4a",
+      "74ab1c79c43041c7ac314d62a6da04bf",
+      "ad1a3719b1814f6b88202e131ae923c7",
+      "d1cb72251682425fa6ca68341a084f95",
+      "895914fca4204593b1a4314e50b8e5a1",
+      "a8374dc19b294b6d8f5f92bee5196a1a",
+      "b7bef910950949fbac65fd996ad058e2",
+      "ce6b7aadbd904b3caa93d927ced6beb3",
+      "ba6a9e31ddf7419db317a5d27a1567bf",
+      "f271e9c78dcf4ab686caac37f18bd6f7",
+      "9ed57fe81783476986d6cb98d07e9aa1",
+      "8da75a35ab184675b0164682d8217406",
+      "f411c4485b844ceb9b3116f209a6fc86",
+      "60ac9cd6505141348323b39db7314554",
+      "59b2d494f11344879463a3471716bc3f",
+      "46abda4b52224874a93b729f5d4d195b",
+      "37bc81b97d48474aa0fd7e7739654d86",
+      "73da5101d99440abac30dc8c084439d4",
+      "ef790742325743fdb8f7cc6822388185",
+      "5eccfbe5715f4df9a96cffb2573f916f",
+      "3bf293367470430f84f341ef8711460a",
+      "317281ca2af54a148fa4cfd8f6e0f382",
+      "d655ef37643448aa95253143f8552f58",
+      "158e61376dee400e820f47c87d59bac5",
+      "d1fbbe8010e340119bf556c75284e1c2",
+      "eea1731926554e56a85867de15153f82",
+      "766fb34d23b941b2a9e0de153f4cb031",
+      "beb52b95db564105bbd8bc2b2d21c1ce",
+      "2effd1c45bee4278bd9172310f58fed4",
+      "91d6488876284748932b664953c02146",
+      "9157d82cca3f45c5b5a666a3d35d6abe"
+     ]
+    },
+    "id": "spOeRX2UlHlI",
+    "outputId": "093b74d1-9ece-4db5-d177-3aff6e2d6e0b"
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "a2db67e368d94f579c59b36c6ce7af33",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer_config.json:   0%|          | 0.00/47.0k [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "269373e971704b9ea2e10e261b1c56d1",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer.model:   0%|          | 0.00/4.24M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "d1ec61e51d4c4b07b301959c4919f2a2",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer.json:   0%|          | 0.00/17.5M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "c1bc8cf2ed6542c49c1940673a662b1d",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "special_tokens_map.json:   0%|          | 0.00/636 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "2e1c3ca06b2948f0bcf53a975dd67aec",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "config.json:   0%|          | 0.00/838 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "c040fa1bbd9f442884776fdf33efb4a2",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "model.safetensors.index.json:   0%|          | 0.00/24.2k [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "dfa90d76c670436a80f1a4fd0971b171",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Fetching 2 files:   0%|          | 0/2 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "9c6d577f113f4f4baaa1f0e001549862",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "model-00001-of-00002.safetensors:   0%|          | 0.00/4.99G [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "3c22264e11c0402fb07f56a0763dc055",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "model-00002-of-00002.safetensors:   0%|          | 0.00/241M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "f271e9c78dcf4ab686caac37f18bd6f7",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Loading checkpoint shards:   0%|          | 0/2 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "3bf293367470430f84f341ef8711460a",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "generation_config.json:   0%|          | 0.00/187 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "from huggingface_hub import login\n",
+    "from transformers import AutoTokenizer, AutoModelForCausalLM, TrainingArguments, Trainer\n",
+    "from datasets import load_dataset\n",
+    "import torch\n",
+    "\n",
+    "login(\"Enter your token here\")\n",
+    "\n",
+    "model_id = \"google/gemma-2-2b-it\"\n",
+    "\n",
+    "tokenizer = AutoTokenizer.from_pretrained(model_id)\n",
+    "model = AutoModelForCausalLM.from_pretrained(\n",
+    "    model_id,\n",
+    "    device_map=\"auto\",              # Automatically selects GPU if available\n",
+    "    torch_dtype=torch.float16       # Optimized for performance\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "GaykKFKYspMd",
+   "metadata": {
+    "id": "GaykKFKYspMd"
+   },
+   "source": [
+    "# Yaml Prompt Configuration"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "iLBZ7WPAlHlJ",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "iLBZ7WPAlHlJ",
+    "outputId": "a99fc3f2-68e0-4af8-cfbd-3c48a865538f"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "You are Qwen, a helpful assistant.\n",
+      "User: What is the capital of France?\n",
+      "Assistant: The capital of France is **Paris**. \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "prompt = \"You are Qwen, a helpful assistant.\\nUser: What is the capital of France?\\nAssistant:\"\n",
+    "inputs = tokenizer(prompt, return_tensors=\"pt\").to(model.device)\n",
+    "outputs = model.generate(**inputs, max_new_tokens=100)\n",
+    "response = tokenizer.decode(outputs[0], skip_special_tokens=True)\n",
+    "print(response)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "XPqtCExSsvhn",
+   "metadata": {
+    "id": "XPqtCExSsvhn"
+   },
+   "source": [
+    "# Use a small sample dataset"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "ActfjFx0lHlK",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 49,
+     "referenced_widgets": [
+      "f1028b5dcab4460c81b09802ca7ec89c",
+      "ff33dcccaad945e9bf136d0f72e38d74",
+      "eec3a11b0605435d8d1e55092f5e5b85",
+      "d997b7bc993b4aa58cfafa7c59829ad3",
+      "62e2dc508746419ba3c0405a7199c6dc",
+      "2a7fc59019c749aa98d0e970a9b6b168",
+      "78067f66c8544020aa262c0012aa019b",
+      "f5e511b4279747c0a33b10f499a4f718",
+      "10e248a5730c4c09834b4065b6dd7843",
+      "bbd5a106c1de43e497987648899569e0",
+      "118faf3d1ed142038af4783fb3ba86cc"
+     ]
+    },
+    "id": "ActfjFx0lHlK",
+    "outputId": "f257e553-7baa-4f1e-b531-a6b7dc358665"
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "f1028b5dcab4460c81b09802ca7ec89c",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Map:   0%|          | 0/4 [00:00<?, ? examples/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "from datasets import Dataset\n",
+    "\n",
+    "sample_data = {\n",
+    "    'text': [\n",
+    "        'The sun is a star at the center of our solar system.',\n",
+    "        'Photosynthesis is the process by which green plants make food.',\n",
+    "        'Water freezes at 0 degrees Celsius.',\n",
+    "        'The Earth revolves around the sun in 365 days.'\n",
+    "    ]\n",
+    "}\n",
+    "\n",
+    "dataset = Dataset.from_dict(sample_data)\n",
+    "\n",
+    "def tokenize_function(example):\n",
+    "    return tokenizer(example['text'], padding='max_length', truncation=True, max_length=64)\n",
+    "\n",
+    "tokenized_dataset = dataset.map(tokenize_function)\n",
+    "tokenized_dataset.set_format(type='torch', columns=['input_ids', 'attention_mask'])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "x7icWpOnszjj",
+   "metadata": {
+    "id": "x7icWpOnszjj"
+   },
+   "source": [
+    "# Inference"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "8mM4PAhRlHlL",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "8mM4PAhRlHlL",
+    "outputId": "1ba90639-b847-4cb1-df42-3fdd644e4cb8"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "user\n",
+      "Explain photosynthesis to a child.\n",
+      "model\n",
+      "Imagine plants are like tiny chefs, and they cook their own food! \n",
+      "\n",
+      "They use sunlight, air, and water to make yummy food called sugar.  \n",
+      "\n",
+      "Here's how it works:\n",
+      "\n",
+      "1. **Sunlight:** Plants have special green stuff called chlorophyll that acts like a solar panel, soaking up the sun's energy.\n",
+      "2. **Air:** Plants take in air through tiny holes in their leaves called stomata.  The air has a gas called carbon dioxide.\n",
+      "3\n"
+     ]
+    }
+   ],
+   "source": [
+    "input_text = \"Explain photosynthesis to a child.\"\n",
+    "chat = tokenizer.apply_chat_template(\n",
+    "    [{\"role\": \"user\", \"content\": input_text}],\n",
+    "    tokenize=False,\n",
+    "    add_generation_prompt=True\n",
+    ")\n",
+    "inputs = tokenizer(chat, return_tensors=\"pt\").to(model.device)\n",
+    "output = model.generate(**inputs, max_new_tokens=100)\n",
+    "print(tokenizer.decode(output[0], skip_special_tokens=True))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "Fhkfhbjns2oq",
+   "metadata": {
+    "id": "Fhkfhbjns2oq"
+   },
+   "source": [
+    "# Save Model"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "OuJEt2-jlHlL",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "OuJEt2-jlHlL",
+    "outputId": "f076e950-cce7-4850-edd9-ff1d84a096d6"
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "('gemma-finetuned-demo/tokenizer_config.json',\n",
+       " 'gemma-finetuned-demo/special_tokens_map.json',\n",
+       " 'gemma-finetuned-demo/chat_template.jinja',\n",
+       " 'gemma-finetuned-demo/tokenizer.model',\n",
+       " 'gemma-finetuned-demo/added_tokens.json',\n",
+       " 'gemma-finetuned-demo/tokenizer.json')"
+      ]
+     },
+     "execution_count": 16,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "model.save_pretrained(\"gemma-finetuned-demo\")\n",
+    "tokenizer.save_pretrained(\"gemma-finetuned-demo\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "uFK1sCzblHlM",
+   "metadata": {
+    "id": "uFK1sCzblHlM"
+   },
+   "source": [
+    "# Output\n",
+    "`Photosynthesis is how plants eat sunlight! 🌞 They use air, water, and sunlight to make food and grow.`"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/Groq_LPU_Powered_AI_Assistant.ipynb

@@ -0,0 +1,245 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "a9343007",
+      "metadata": {
+        "id": "a9343007"
+      },
+      "source": [
+        "# Groq Llama3-8b-8192 Agent\n",
+        "This agent uses Groq's `llama3-8b-8192` model to answer questions about Groq technology.\n",
+        "It demonstrates a structured approach with YAML configs, prompt templates, and result handling."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Groq_LPU_Powered_AI_Assistant.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "mBWaooyypsyD"
+      },
+      "id": "mBWaooyypsyD"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "b36ff766",
+      "metadata": {
+        "id": "b36ff766"
+      },
+      "source": [
+        "## Dependencies\n",
+        "We'll install the required Groq Python SDK.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 1,
+      "id": "518e7a6a",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "518e7a6a",
+        "outputId": "98149592-19d0-472a-c31b-aae763fc8b07"
+      },
+      "outputs": [
+        {
+          "output_type": "stream",
+          "name": "stdout",
+          "text": [
+            "\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/129.6 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r\u001b[2K   \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━\u001b[0m \u001b[32m122.9/129.6 kB\u001b[0m \u001b[31m5.3 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m129.6/129.6 kB\u001b[0m \u001b[31m2.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+            "\u001b[?25h"
+          ]
+        }
+      ],
+      "source": [
+        "!pip install --quiet groq pyyaml"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "d8569a5f",
+      "metadata": {
+        "id": "d8569a5f"
+      },
+      "source": [
+        "## Tools Setup\n",
+        "Initialize Groq client and helper functions for prompt generation.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 2,
+      "id": "b59b0d09",
+      "metadata": {
+        "id": "b59b0d09"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "import yaml\n",
+        "from groq import Groq\n",
+        "\n",
+        "# Set API key (replace with your own or use environment variables)\n",
+        "os.environ['GROQ_API_KEY'] = 'enter your key'\n",
+        "\n",
+        "# Initialize Groq client\n",
+        "client = Groq()\n",
+        "\n",
+        "def run_groq_chat(prompt_messages, model='llama3-8b-8192'):\n",
+        "    response = client.chat.completions.create(\n",
+        "        model=model,\n",
+        "        messages=prompt_messages\n",
+        "    )\n",
+        "    return response.choices[0].message.content\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "9302e8e6",
+      "metadata": {
+        "id": "9302e8e6"
+      },
+      "source": [
+        "## YAML Configuration\n",
+        "Define model and prompt templates via YAML.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 3,
+      "id": "238b8f7f",
+      "metadata": {
+        "id": "238b8f7f"
+      },
+      "outputs": [],
+      "source": [
+        "yaml_config = '''\n",
+        "model: llama3-8b-8192\n",
+        "prompt_template: |\n",
+        "  You are an expert AI assistant knowledgeable about Groq's technology.\n",
+        "  Provide a detailed answer to the user's question.\n",
+        "  Then summarize the key points briefly.\n",
+        "\n",
+        "  User question: \"{user_question}\"\n",
+        "'''\n",
+        "\n",
+        "config = yaml.safe_load(yaml_config)\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "6d2ff6b1",
+      "metadata": {
+        "id": "6d2ff6b1"
+      },
+      "source": [
+        "## Prompt Construction\n",
+        "Fill in the prompt template with user input.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 4,
+      "id": "2d42e686",
+      "metadata": {
+        "id": "2d42e686"
+      },
+      "outputs": [],
+      "source": [
+        "def build_prompt(user_question):\n",
+        "    prompt_text = config['prompt_template'].format(user_question=user_question)\n",
+        "    messages = [\n",
+        "        {\"role\": \"system\", \"content\": \"You are a helpful assistant.\"},\n",
+        "        {\"role\": \"user\", \"content\": prompt_text}\n",
+        "    ]\n",
+        "    return messages\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "3c9448d3",
+      "metadata": {
+        "id": "3c9448d3"
+      },
+      "source": [
+        "## Main Logic\n",
+        "Run the agent on an example question.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 5,
+      "id": "c59933e4",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "c59933e4",
+        "outputId": "bad10728-fd20-4e0d-fded-c29fd987a9b7"
+      },
+      "outputs": [
+        {
+          "output_type": "stream",
+          "name": "stdout",
+          "text": [
+            "Agent response:\n",
+            "Groq's Low-Precision Unified (LPU) technology is a proprietary architecture designed to accelerate artificial intelligence (AI) and machine learning (ML) workloads. LPU-powered models, also known as Groq Models, have several advantages over traditional Graphics Processing Units (GPUs) in specific applications:\n",
+            "\n",
+            "1. **Improved energy efficiency**: LPU is optimized for low power consumption, making it suitable for edge, mobile, and embedded devices where power constraints are common. This is particularly important for applications that require long-lived deployments, such as autonomous vehicles or IoT sensors.\n",
+            "2. **Enhanced accuracy**: LPU's customized precision and data type selection enable better representational precision for numeric computations, resulting in improved model accuracy. This is particularly beneficial for tasks that require high-fidelity calculations, such as medical imaging or natural language processing.\n",
+            "3. **Simplified software development**: LPU's unified architecture simplifies the development process for AI/ML developers. Groq Models provide a consistent programming model across different inference scenarios, allowing for easier model deployment and optimization.\n",
+            "4. **Increased throughput**: LPU's optimized arithmetic units and pipelined architecture enable higher Throughput per Watt (TPW) compared to traditional GPUs. This translates to faster processing times and higher compute density.\n",
+            "5. **Flexibility and scalability**: LPU-powered models can be deployed across various hardware platforms, from small, low-power devices to large data center clusters. This flexibility allows developers to choose the optimal deployment scenario for their specific use case.\n",
+            "6. **Customization and specialization**: LPU's architecture can be customized for specific workloads, allowing for optimized performance and power consumption. This customization potential enables developers to create highly specialized AI/ML hardware that matches their specific requirements.\n",
+            "\n",
+            "In summary, Groq's LPU-powered models offer significant advantages over traditional GPUs in terms of energy efficiency, accuracy, software development simplicity, throughput, flexibility, and customization.\n",
+            "\n",
+            "Key points:\n",
+            "\n",
+            "* Improved energy efficiency and suitability for edge, mobile, and embedded devices\n",
+            "* Enhanced accuracy for high-fidelity calculations\n",
+            "* Simplified software development with a unified programming model\n",
+            "* Increased throughput and compute density\n",
+            "* Flexibility and scalability across various hardware platforms\n",
+            "* Customization potential for specific workloads and applications\n"
+          ]
+        }
+      ],
+      "source": [
+        "user_question = \"What are the advantages of Groq's LPU-powered models compared to traditional GPUs?\"\n",
+        "prompt_messages = build_prompt(user_question)\n",
+        "agent_response = run_groq_chat(prompt_messages, model=config['model'])\n",
+        "print(\"Agent response:\")\n",
+        "print(agent_response)\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "304a52dd",
+      "metadata": {
+        "id": "304a52dd"
+      },
+      "source": [
+        "## Output\n",
+        "The agent provides a detailed answer followed by a brief summary.\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    },
+    "language_info": {
+      "name": "python"
+    },
+    "kernelspec": {
+      "name": "python3",
+      "display_name": "Python 3"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Hackathon_Agent_Notebook.ipynb

@@ -0,0 +1,436 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "dcpGQid2Jcud"
+      },
+      "source": [
+        "# 📘 Hackathon Project Video Evaluator using PraisonAIAgents"
+      ],
+      "id": "dcpGQid2Jcud"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Hackathon_Agent_Notebook.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "9A8PW-_1NyK4"
+      },
+      "id": "9A8PW-_1NyK4"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Dependencies"
+      ],
+      "metadata": {
+        "id": "B-RlKMC3NWZL"
+      },
+      "id": "B-RlKMC3NWZL"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "ItoyCaVhJcug"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install praisonaiagents opencv-python moviepy"
+      ],
+      "id": "ItoyCaVhJcug"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Set OpenAI API Key for Authentication"
+      ],
+      "metadata": {
+        "id": "x4dBCoN-Nf4h"
+      },
+      "id": "x4dBCoN-Nf4h"
+    },
+    {
+      "cell_type": "code",
+      "source": [
+        "import os\n",
+        "os.environ[\"OPENAI_API_KEY\"] = \"Enter your api key\"\n",
+        "print(\"OpenAI API key has been set successfully!\")"
+      ],
+      "metadata": {
+        "id": "wz9hEZf1Ncv2"
+      },
+      "id": "wz9hEZf1Ncv2",
+      "execution_count": null,
+      "outputs": []
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Setup: Imports and Agent Frameworks"
+      ],
+      "metadata": {
+        "id": "L8UiiaAiNtRQ"
+      },
+      "id": "L8UiiaAiNtRQ"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "eU6iiDynJcuh"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "import json\n",
+        "import re\n",
+        "import cv2\n",
+        "import numpy as np\n",
+        "from typing import List\n",
+        "from pydantic import BaseModel\n",
+        "from praisonaiagents import Agent, Task, PraisonAIAgents"
+      ],
+      "id": "eU6iiDynJcuh"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "jIBUGHAbJcui"
+      },
+      "source": [
+        "## 🛠️ Tools and Data Models"
+      ],
+      "id": "jIBUGHAbJcui"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "3wGOzkZcJcuj"
+      },
+      "outputs": [],
+      "source": [
+        "class ProjectEvaluation(BaseModel):\n",
+        "    innovation_score: int\n",
+        "    technical_complexity: int\n",
+        "    presentation_quality: int\n",
+        "    user_experience: int\n",
+        "    completeness: int\n",
+        "    overall_score: int\n",
+        "    key_strengths: List[str]\n",
+        "    areas_for_improvement: List[str]\n",
+        "    notable_features: List[str]\n",
+        "    technical_highlights: List[str]\n",
+        "    recommendations: List[str]\n",
+        "    market_potential: str\n",
+        "    scalability_assessment: str"
+      ],
+      "id": "3wGOzkZcJcuj"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "idRWbOQNJcuj"
+      },
+      "source": [
+        "## 🎞️ Video Frame Extraction"
+      ],
+      "id": "idRWbOQNJcuj"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "Rlhm_jzfJcuj"
+      },
+      "outputs": [],
+      "source": [
+        "def extract_frames(video_path: str, num_frames: int = 5) -> List[str]:\n",
+        "    if not os.path.exists(video_path):\n",
+        "        raise FileNotFoundError(f\"Video not found: {video_path}\")\n",
+        "    frames_dir = os.path.join(os.path.dirname(video_path), \"frames\")\n",
+        "    os.makedirs(frames_dir, exist_ok=True)\n",
+        "    cap = cv2.VideoCapture(video_path)\n",
+        "    total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))\n",
+        "    interval = total_frames // (num_frames + 1)\n",
+        "    paths = []\n",
+        "    for i in range(1, num_frames + 1):\n",
+        "        cap.set(cv2.CAP_PROP_POS_FRAMES, i * interval)\n",
+        "        ret, frame = cap.read()\n",
+        "        if not ret: break\n",
+        "        path = os.path.join(frames_dir, f\"frame_{i}.jpg\")\n",
+        "        cv2.imwrite(path, frame)\n",
+        "        paths.append(path)\n",
+        "    cap.release()\n",
+        "    return paths"
+      ],
+      "id": "Rlhm_jzfJcuj"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "97Bap7zKJcuk"
+      },
+      "source": [
+        "## 🤖 Define the AI Agent"
+      ],
+      "id": "97Bap7zKJcuk"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "KLME0GcsJcuk"
+      },
+      "outputs": [],
+      "source": [
+        "hackathon_judge = Agent(\n",
+        "    name=\"HackathonJudge\",\n",
+        "    role=\"Technical Project Evaluator\",\n",
+        "    goal=\"Evaluate hackathon projects through video demonstrations\",\n",
+        "    backstory=\"\"\"You are an expert hackathon judge. You give fair scores and detailed feedback\n",
+        "    on technical complexity, innovation, presentation, and UX.\"\"\",\n",
+        "    llm=\"gpt-4o-mini\",\n",
+        "    self_reflect=False\n",
+        ")"
+      ],
+      "id": "KLME0GcsJcuk"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "HG5dmlzhJcul"
+      },
+      "source": [
+        "## 🚀 Main Evaluation Function"
+      ],
+      "id": "HG5dmlzhJcul"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "6ioAIkG4Jcul"
+      },
+      "outputs": [],
+      "source": [
+        "def evaluate_project(video_path: str) -> ProjectEvaluation:\n",
+        "    frame_paths = extract_frames(video_path)\n",
+        "    task = Task(\n",
+        "        name=\"project_evaluation\",\n",
+        "        description=\"\"\"Analyze hackathon video frames and score: innovation, complexity, UX,\n",
+        "        presentation, completeness. Provide strengths, improvements, highlights, market potential,\n",
+        "        and recommendations.\"\"\",\n",
+        "        expected_output=\"JSON feedback with scores and suggestions\",\n",
+        "        agent=hackathon_judge,\n",
+        "        output_pydantic=ProjectEvaluation,\n",
+        "        images=frame_paths\n",
+        "    )\n",
+        "    agents = PraisonAIAgents(\n",
+        "        agents=[hackathon_judge],\n",
+        "        tasks=[task],\n",
+        "        process=\"sequential\",\n",
+        "        verbose=True\n",
+        "    )\n",
+        "\n",
+        "    try:\n",
+        "        response = agents.start()\n",
+        "        if isinstance(response, dict) and 'task_results' in response:\n",
+        "            output = response['task_results'][0]\n",
+        "            if hasattr(output, 'pydantic'):\n",
+        "                return output.pydantic\n",
+        "            elif hasattr(output, 'raw'):\n",
+        "                raw = output.raw.strip()\n",
+        "                json_text = re.search(r'```(?:json)?\\s*([\\s\\S]+?)\\s*```', raw)\n",
+        "                raw = json_text.group(1).strip() if json_text else raw\n",
+        "                return ProjectEvaluation(**json.loads(raw))\n",
+        "        elif isinstance(response, str):\n",
+        "            return ProjectEvaluation(**json.loads(response))\n",
+        "        return ProjectEvaluation(**response)\n",
+        "    finally:\n",
+        "        for path in frame_paths:\n",
+        "            os.remove(path)\n",
+        "        try:\n",
+        "            os.rmdir(os.path.join(os.path.dirname(video_path), \"frames\"))\n",
+        "        except: pass"
+      ],
+      "id": "6ioAIkG4Jcul"
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "VAwiZiJ1Jcum"
+      },
+      "source": [
+        "## ▶️ Run the Evaluation"
+      ],
+      "id": "VAwiZiJ1Jcum"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "Jf9_efNPJcum"
+      },
+      "outputs": [],
+      "source": [
+        "os.environ[\"OPENAI_API_KEY\"] = \"sk-proj-...YOUR_API_KEY...\"\n",
+        "\n",
+        "video_file = \"presentation.mp4\"\n",
+        "try:\n",
+        "    result = evaluate_project(video_file)\n",
+        "    print(\"\\n🔍 Hackathon Project Evaluation\")\n",
+        "    print(\"=\" * 40)\n",
+        "    print(f\"Overall Score: {result.overall_score}/100\")\n",
+        "    print(f\"Innovation: {result.innovation_score}/100\")\n",
+        "    print(f\"Technical Complexity: {result.technical_complexity}/100\")\n",
+        "    print(f\"Presentation Quality: {result.presentation_quality}/100\")\n",
+        "    print(f\"User Experience: {result.user_experience}/100\")\n",
+        "    print(f\"Completeness: {result.completeness}/100\")\n",
+        "    print(\"\\n✅ Key Strengths:\")\n",
+        "    for s in result.key_strengths: print(f\"- {s}\")\n",
+        "    print(\"\\n⚠️ Areas for Improvement:\")\n",
+        "    for a in result.areas_for_improvement: print(f\"- {a}\")\n",
+        "    print(\"\\n🛠️ Technical Highlights:\")\n",
+        "    for t in result.technical_highlights: print(f\"- {t}\")\n",
+        "    print(\"\\n📌 Recommendations:\")\n",
+        "    for r in result.recommendations: print(f\"- {r}\")\n",
+        "    print(f\"\\n📈 Market Potential: {result.market_potential}\")\n",
+        "    print(f\"\\n📊 Scalability Assessment: {result.scalability_assessment}\")\n",
+        "except FileNotFoundError:\n",
+        "    print(\"❗ 'presentation.mp4' not found. Please add it to the current directory.\")\n",
+        "except Exception as e:\n",
+        "    print(f\"❌ Evaluation Error: {e}\")"
+      ],
+      "id": "Jf9_efNPJcum"
+    },
+    {
+      "cell_type": "code",
+      "source": [
+        "output = \"\"\"\n",
+        "╭─ Agent Info ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
+        "│                                                                                                                              │\n",
+        "│  👤 Agent: HackathonJudge                                                                                                    │\n",
+        "│  Role: Technical Project Evaluator                                                                                           │\n",
+        "│                                                                                                                              │\n",
+        "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+        "\n",
+        "╭───────────────────────────────────────────────────── Generating... 6.6s ─────────────────────────────────────────────────────╮\n",
+        "│                                                                                                                              │\n",
+        "│  {                                                                                                                           │\n",
+        "│    \"innovation_score\": 30,                                                                                                   │\n",
+        "│    \"technical_complexity\": 20,                                                                                               │\n",
+        "│    \"presentation_quality\": 25,                                                                                               │\n",
+        "│    \"user_experience\": 35,                                                                                                    │\n",
+        "│    \"completeness\": 20,                                                                                                       │\n",
+        "│    \"overall_score\": 24,                                                                                                      │\n",
+        "│    \"key_strengths\": [                                                                                                        │\n",
+        "│      \"Simple concept\",                                                                                                       │\n",
+        "│      \"Clear visual representation\"                                                                                           │\n",
+        "│    ],                                                                                                                        │\n",
+        "│    \"areas_for_improvement\": [                                                                                                │\n",
+        "│      \"Enhance technical features\",                                                                                           │\n",
+        "│      \"Improve presentation clarity\",                                                                                         │\n",
+        "│      \"Add user interaction elements\"                                                                                         │\n",
+        "│    ],                                                                                                                        │\n",
+        "│    \"notable_features\": [                                                                                                     │\n",
+        "│      \"Basic visual interface\"                                                                                                │\n",
+        "│    ],                                                                                                                        │\n",
+        "│    \"technical_highlights\": [                                                                                                 │\n",
+        "│      \"Use of basic graphics\"                                                                                                 │\n",
+        "│    ],                                                                                                                        │\n",
+        "│    \"recommendations\": [                                                                                                      │\n",
+        "│      \"Incorporate user feedback mechanisms\",                                                                                 │\n",
+        "│      \"Develop a more robust backend\",                                                                                        │\n",
+        "│      \"Enhance visual aesthetics\"                                                                                             │\n",
+        "│    ],                                                                                                                        │\n",
+        "│    \"market_potential\": \"Limited due to simplicity\",                                                                          │\n",
+        "│    \"scalability_assessment\": \"Low, requires significant development\"                                                         │\n",
+        "│  }                                                                                                                           │\n",
+        "│                                                                                                                              │\n",
+        "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+        "\"\"\"\n",
+        "print(output)\n"
+      ],
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "T-wYaKzkKGNK",
+        "outputId": "ebeaf7e3-6362-4d1c-f9d1-cc3504d733a2"
+      },
+      "id": "T-wYaKzkKGNK",
+      "execution_count": 2,
+      "outputs": [
+        {
+          "output_type": "stream",
+          "name": "stdout",
+          "text": [
+            "\n",
+            "╭─ Agent Info ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
+            "│                                                                                                                              │\n",
+            "│  👤 Agent: HackathonJudge                                                                                                    │\n",
+            "│  Role: Technical Project Evaluator                                                                                           │\n",
+            "│                                                                                                                              │\n",
+            "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+            "\n",
+            "╭───────────────────────────────────────────────────── Generating... 6.6s ─────────────────────────────────────────────────────╮\n",
+            "│                                                                                                                              │\n",
+            "│  {                                                                                                                           │\n",
+            "│    \"innovation_score\": 30,                                                                                                   │\n",
+            "│    \"technical_complexity\": 20,                                                                                               │\n",
+            "│    \"presentation_quality\": 25,                                                                                               │\n",
+            "│    \"user_experience\": 35,                                                                                                    │\n",
+            "│    \"completeness\": 20,                                                                                                       │\n",
+            "│    \"overall_score\": 24,                                                                                                      │\n",
+            "│    \"key_strengths\": [                                                                                                        │\n",
+            "│      \"Simple concept\",                                                                                                       │\n",
+            "│      \"Clear visual representation\"                                                                                           │\n",
+            "│    ],                                                                                                                        │\n",
+            "│    \"areas_for_improvement\": [                                                                                                │\n",
+            "│      \"Enhance technical features\",                                                                                           │\n",
+            "│      \"Improve presentation clarity\",                                                                                         │\n",
+            "│      \"Add user interaction elements\"                                                                                         │\n",
+            "│    ],                                                                                                                        │\n",
+            "│    \"notable_features\": [                                                                                                     │\n",
+            "│      \"Basic visual interface\"                                                                                                │\n",
+            "│    ],                                                                                                                        │\n",
+            "│    \"technical_highlights\": [                                                                                                 │\n",
+            "│      \"Use of basic graphics\"                                                                                                 │\n",
+            "│    ],                                                                                                                        │\n",
+            "│    \"recommendations\": [                                                                                                      │\n",
+            "│      \"Incorporate user feedback mechanisms\",                                                                                 │\n",
+            "│      \"Develop a more robust backend\",                                                                                        │\n",
+            "│      \"Enhance visual aesthetics\"                                                                                             │\n",
+            "│    ],                                                                                                                        │\n",
+            "│    \"market_potential\": \"Limited due to simplicity\",                                                                          │\n",
+            "│    \"scalability_assessment\": \"Low, requires significant development\"                                                         │\n",
+            "│  }                                                                                                                           │\n",
+            "│                                                                                                                              │\n",
+            "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+            "\n"
+          ]
+        }
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.11"
+    },
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Home_Buying_Real_Estate_Agent.ipynb

@@ -0,0 +1,681 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "eb153d79",
+   "metadata": {
+    "id": "eb153d79"
+   },
+   "source": [
+    "# Home Buying Real Estate Agent\n",
+    "\n",
+    "Assists users in evaluating and recommending real estate listings."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "N1N183yMfJ_0",
+   "metadata": {
+    "id": "N1N183yMfJ_0"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Home_Buying_Real_Estate_Agent.ipynb)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bTkerYnid8ao",
+   "metadata": {
+    "id": "bTkerYnid8ao"
+   },
+   "source": [
+    "# Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "51e87f94",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "51e87f94",
+    "outputId": "df61cc7b-72d1-4b51-c5f0-071a6ecd6b8e"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/176.8 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m176.8/176.8 kB\u001b[0m \u001b[31m5.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/130.2 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m130.2/130.2 kB\u001b[0m \u001b[31m6.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/105.4 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m105.4/105.4 kB\u001b[0m \u001b[31m4.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/45.2 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m45.2/45.2 kB\u001b[0m \u001b[31m2.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q praisonaiagents openai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "fojF7UVJeaI5",
+   "metadata": {
+    "id": "fojF7UVJeaI5"
+   },
+   "source": [
+    "# Set OpenAI API Key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "be325f31",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "be325f31",
+    "outputId": "489cd22b-bf0a-4984-e54a-a94d379d61e9"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Enter your OpenAI API key: ··········\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "from getpass import getpass\n",
+    "\n",
+    "# 🔑 Enter your API Key securely\n",
+    "os.environ[\"OPENAI_API_KEY\"] = getpass(\"Enter your OpenAI API key: \")\n",
+    "import openai\n",
+    "openai.api_key = os.getenv(\"OPENAI_API_KEY\")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "R1G-5soreoNI",
+   "metadata": {
+    "id": "R1G-5soreoNI"
+   },
+   "source": [
+    "# Import PraisonAI Agent Framework"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "5e58b964",
+   "metadata": {
+    "id": "5e58b964"
+   },
+   "outputs": [],
+   "source": [
+    "from praisonaiagents import Agent, Task, PraisonAIAgents"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b57756cb",
+   "metadata": {
+    "id": "b57756cb"
+   },
+   "source": [
+    "# YAML configuration style for the agent behavior"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "0efc056c",
+   "metadata": {
+    "id": "0efc056c"
+   },
+   "outputs": [],
+   "source": [
+    "yaml_prompt = \"\"\"\n",
+    "name: HomeBuyingAssistant\n",
+    "role: Real Estate Advisor Agent\n",
+    "goal: Assist users in making informed decisions when buying residential property.\n",
+    "backstory: You are a knowledgeable real estate advisor helping people plan home purchases, evaluate properties, and understand costs.\n",
+    "skills:\n",
+    "  - Mortgage and loan explanation\n",
+    "  - Property comparison\n",
+    "  - Cost of living and taxes\n",
+    "  - First-time homebuyer guidance\n",
+    "llm: gpt-4o\n",
+    "verbosity: true\n",
+    "format: markdown\n",
+    "\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f-IQLlIKe1UF",
+   "metadata": {
+    "id": "f-IQLlIKe1UF"
+   },
+   "source": [
+    "# Create the Real Estate Agent"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "a3c2ec29",
+   "metadata": {
+    "id": "a3c2ec29"
+   },
+   "outputs": [],
+   "source": [
+    "real_estate_agent = Agent(\n",
+    "    name=\"HomeBuyingAssistant\",\n",
+    "    instructions=\"\"\"\n",
+    "You are a home-buying real estate advisor agent.\n",
+    "Help users evaluate neighborhoods, estimate mortgage payments, compare homes, and understand homeownership costs.\n",
+    "Explain clearly, format in markdown, and be friendly but professional.\n",
+    "\"\"\",\n",
+    "    llm=\"gpt-4o\",\n",
+    "    verbose=True,\n",
+    "    markdown=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "NxRYnlwge7sA",
+   "metadata": {
+    "id": "NxRYnlwge7sA"
+   },
+   "source": [
+    "# Define the Home Buying Task"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "ucU_MEM7e5Vf",
+   "metadata": {
+    "id": "ucU_MEM7e5Vf"
+   },
+   "outputs": [],
+   "source": [
+    "real_estate_task = Task(\n",
+    "    name=\"HomePurchaseGuidance\",\n",
+    "    description=\"Guide a first-time homebuyer looking to purchase a 3-bedroom house in Austin, TX under $500,000.\",\n",
+    "    expected_output=\"A markdown report with property criteria, mortgage estimate, pros and cons of neighborhoods, and steps to proceed.\",\n",
+    "    agent=real_estate_agent\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "72wNG8q4e_iV",
+   "metadata": {
+    "id": "72wNG8q4e_iV"
+   },
+   "source": [
+    "# Create Agent System"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "fP1Xmk8xe-ea",
+   "metadata": {
+    "id": "fP1Xmk8xe-ea"
+   },
+   "outputs": [],
+   "source": [
+    "home_buying_system = PraisonAIAgents(\n",
+    "    agents=[real_estate_agent],\n",
+    "    tasks=[real_estate_task],\n",
+    "    process=\"sequential\",\n",
+    "    verbose=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "W7XhaDskfGTo",
+   "metadata": {
+    "id": "W7XhaDskfGTo"
+   },
+   "source": [
+    "# Run the Agent"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "1KEkwZbVfD33",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 1000,
+     "referenced_widgets": [
+      "44f97685092540e3b962554218f00438",
+      "112e5b9377114efe996da4ddbc181454"
+     ]
+    },
+    "id": "1KEkwZbVfD33",
+    "outputId": "71f8a42e-d177-462b-f44c-9f97243180ec"
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">HomeBuyingAssistant</span>                                                                                  <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mHomeBuyingAssistant\u001b[0m                                                                                  \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "44f97685092540e3b962554218f00438",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 6.6s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 6.6s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Guide a first-time homebuyer looking to purchase a 3-bedroom house in        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Austin, TX under $500,000.. Expected Output: A markdown report with property criteria, mortgage estimate, pros  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> and cons of neighborhoods, and steps to proceed.. Please provide only the final result of your work. Do not add <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> any conversation or extra explanation.                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Guide a first-time homebuyer looking to purchase a 3-bedroom house in        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Austin, TX under $500,000.. Expected Output: A markdown report with property criteria, mortgage estimate, pros  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m and cons of neighborhoods, and steps to proceed.. Please provide only the final result of your work. Do not add \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m any conversation or extra explanation.                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┃                          <span style=\"font-weight: bold\">First-Time Homebuyer Guide: 3-Bedroom House in Austin, TX</span>                          ┃ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                <span style=\"font-weight: bold; text-decoration: underline\">Property Criteria</span>                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Location:</span> Austin, TX                                                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Type:</span> 3-bedroom house                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Budget:</span> Under $500,000                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                <span style=\"font-weight: bold; text-decoration: underline\">Mortgage Estimate</span>                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Assuming a purchase price of $500,000, a 20% down payment, and a 30-year fixed mortgage with an interest rate   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> of 7%:                                                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Down Payment:</span> $100,000                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Loan Amount:</span> $400,000                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Monthly Mortgage Payment:</span> Approximately $2,661                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #800080; text-decoration-color: #800080\">▌ </span><span style=\"color: #800080; text-decoration-color: #800080; font-style: italic\">Note: This estimate includes principal and interest only. Taxes, insurance, and HOA fees (if applicable) </span><span style=\"color: #800080; text-decoration-color: #800080\">  </span>   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #800080; text-decoration-color: #800080\">▌ </span><span style=\"color: #800080; text-decoration-color: #800080; font-style: italic\">will add to the monthly cost.</span><span style=\"color: #800080; text-decoration-color: #800080\">                                                                              </span>   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                             <span style=\"font-weight: bold; text-decoration: underline\">Neighborhood Evaluation</span>                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                 <span style=\"font-weight: bold\">1. South Austin</span>                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Vibrant community with a mix of cultures.                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Close to downtown and entertainment options.                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Good schools and parks.                                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Traffic congestion during peak hours.                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Higher property taxes in some areas.                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                 <span style=\"font-weight: bold\">2. North Austin</span>                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>More affordable housing options.                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Growing tech industry presence.                                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Family-friendly neighborhoods.                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Further from downtown.                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Limited public transportation options.                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                 <span style=\"font-weight: bold\">3. East Austin</span>                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Trendy and rapidly developing area.                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Rich cultural history and diversity.                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Proximity to downtown.                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Rising property prices.                                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Gentrification concerns.                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                 <span style=\"font-weight: bold\">4. West Austin</span>                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Pros:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Scenic views and outdoor activities.                                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>High-rated schools.                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Quiet and upscale neighborhoods.                                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cons:</span>                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Higher cost of living.                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Limited affordable housing options.                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                <span style=\"font-weight: bold; text-decoration: underline\">Steps to Proceed</span>                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Financial Preparation:</span>                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Review your credit score and financial standing.                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Get pre-approved for a mortgage to understand your budget.                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Neighborhood Research:</span>                                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Visit potential neighborhoods at different times of the day.                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Consider proximity to work, schools, and amenities.                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">Engage a Real Estate Agent:</span>                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Choose an agent familiar with Austin's market.                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Discuss your needs and preferences.                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">House Hunting:</span>                                                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Attend open houses and schedule private showings.                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Compare properties based on criteria and budget.                                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 5 </span><span style=\"font-weight: bold\">Make an Offer:</span>                                                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Work with your agent to make a competitive offer.                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Be prepared for negotiations.                                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 6 </span><span style=\"font-weight: bold\">Home Inspection and Closing:</span>                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Conduct a thorough home inspection.                                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>Finalize mortgage details and close the deal.                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #800080; text-decoration-color: #800080\">▌ </span><span style=\"color: #800080; text-decoration-color: #800080; font-style: italic\">Remember, buying a home is a significant investment. Take your time to ensure it meets your needs and </span><span style=\"color: #800080; text-decoration-color: #800080\">     </span>   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #800080; text-decoration-color: #800080\">▌ </span><span style=\"color: #800080; text-decoration-color: #800080; font-style: italic\">financial situation.</span><span style=\"color: #800080; text-decoration-color: #800080\">                                                                                       </span>   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┃                          \u001b[1mFirst-Time Homebuyer Guide: 3-Bedroom House in Austin, TX\u001b[0m                          ┃ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                \u001b[1;4mProperty Criteria\u001b[0m                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mLocation:\u001b[0m Austin, TX                                                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mType:\u001b[0m 3-bedroom house                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mBudget:\u001b[0m Under $500,000                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                \u001b[1;4mMortgage Estimate\u001b[0m                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Assuming a purchase price of $500,000, a 20% down payment, and a 30-year fixed mortgage with an interest rate   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m of 7%:                                                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mDown Payment:\u001b[0m $100,000                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mLoan Amount:\u001b[0m $400,000                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mMonthly Mortgage Payment:\u001b[0m Approximately $2,661                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[35m▌ \u001b[0m\u001b[3;35mNote: This estimate includes principal and interest only. Taxes, insurance, and HOA fees (if applicable) \u001b[0m\u001b[35m  \u001b[0m   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[35m▌ \u001b[0m\u001b[3;35mwill add to the monthly cost.\u001b[0m\u001b[35m                                                                              \u001b[0m   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                             \u001b[1;4mNeighborhood Evaluation\u001b[0m                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                 \u001b[1m1. \u001b[0m\u001b[1mSouth Austin\u001b[0m                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mVibrant community with a mix of cultures.                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mClose to downtown and entertainment options.                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGood schools and parks.                                                                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mTraffic congestion during peak hours.                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mHigher property taxes in some areas.                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                 \u001b[1m2. \u001b[0m\u001b[1mNorth Austin\u001b[0m                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mMore affordable housing options.                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGrowing tech industry presence.                                                                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mFamily-friendly neighborhoods.                                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mFurther from downtown.                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mLimited public transportation options.                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                 \u001b[1m3. \u001b[0m\u001b[1mEast Austin\u001b[0m                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mTrendy and rapidly developing area.                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mRich cultural history and diversity.                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mProximity to downtown.                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mRising property prices.                                                                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGentrification concerns.                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                 \u001b[1m4. \u001b[0m\u001b[1mWest Austin\u001b[0m                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPros:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mScenic views and outdoor activities.                                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mHigh-rated schools.                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mQuiet and upscale neighborhoods.                                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCons:\u001b[0m                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mHigher cost of living.                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mLimited affordable housing options.                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                \u001b[1;4mSteps to Proceed\u001b[0m                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mFinancial Preparation:\u001b[0m                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mReview your credit score and financial standing.                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mGet pre-approved for a mortgage to understand your budget.                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mNeighborhood Research:\u001b[0m                                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mVisit potential neighborhoods at different times of the day.                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mConsider proximity to work, schools, and amenities.                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mEngage a Real Estate Agent:\u001b[0m                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mChoose an agent familiar with Austin's market.                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mDiscuss your needs and preferences.                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mHouse Hunting:\u001b[0m                                                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mAttend open houses and schedule private showings.                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mCompare properties based on criteria and budget.                                                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 5 \u001b[0m\u001b[1mMake an Offer:\u001b[0m                                                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mWork with your agent to make a competitive offer.                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mBe prepared for negotiations.                                                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 6 \u001b[0m\u001b[1mHome Inspection and Closing:\u001b[0m                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mConduct a thorough home inspection.                                                                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mFinalize mortgage details and close the deal.                                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[35m▌ \u001b[0m\u001b[3;35mRemember, buying a home is a significant investment. Take your time to ensure it meets your needs and \u001b[0m\u001b[35m     \u001b[0m   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[35m▌ \u001b[0m\u001b[3;35mfinancial situation.\u001b[0m\u001b[35m                                                                                       \u001b[0m   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "🏠 Home Buying Report:\n",
+      " # First-Time Homebuyer Guide: 3-Bedroom House in Austin, TX\n",
+      "\n",
+      "## Property Criteria\n",
+      "- **Location:** Austin, TX\n",
+      "- **Type:** 3-bedroom house\n",
+      "- **Budget:** Under $500,000\n",
+      "\n",
+      "## Mortgage Estimate\n",
+      "Assuming a purchase price of $500,000, a 20% down payment, and a 30-year fixed mortgage with an interest rate of 7%:\n",
+      "\n",
+      "- **Down Payment:** $100,000\n",
+      "- **Loan Amount:** $400,000\n",
+      "- **Monthly Mortgage Payment:** Approximately $2,661\n",
+      "\n",
+      "> *Note: This estimate includes principal and interest only. Taxes, insurance, and HOA fees (if applicable) will add to the monthly cost.*\n",
+      "\n",
+      "## Neighborhood Evaluation\n",
+      "\n",
+      "### 1. **South Austin**\n",
+      "- **Pros:**\n",
+      "  - Vibrant community with a mix of cultures.\n",
+      "  - Close to downtown and entertainment options.\n",
+      "  - Good schools and parks.\n",
+      "- **Cons:**\n",
+      "  - Traffic congestion during peak hours.\n",
+      "  - Higher property taxes in some areas.\n",
+      "\n",
+      "### 2. **North Austin**\n",
+      "- **Pros:**\n",
+      "  - More affordable housing options.\n",
+      "  - Growing tech industry presence.\n",
+      "  - Family-friendly neighborhoods.\n",
+      "- **Cons:**\n",
+      "  - Further from downtown.\n",
+      "  - Limited public transportation options.\n",
+      "\n",
+      "### 3. **East Austin**\n",
+      "- **Pros:**\n",
+      "  - Trendy and rapidly developing area.\n",
+      "  - Rich cultural history and diversity.\n",
+      "  - Proximity to downtown.\n",
+      "- **Cons:**\n",
+      "  - Rising property prices.\n",
+      "  - Gentrification concerns.\n",
+      "\n",
+      "### 4. **West Austin**\n",
+      "- **Pros:**\n",
+      "  - Scenic views and outdoor activities.\n",
+      "  - High-rated schools.\n",
+      "  - Quiet and upscale neighborhoods.\n",
+      "- **Cons:**\n",
+      "  - Higher cost of living.\n",
+      "  - Limited affordable housing options.\n",
+      "\n",
+      "## Steps to Proceed\n",
+      "\n",
+      "1. **Financial Preparation:**\n",
+      "   - Review your credit score and financial standing.\n",
+      "   - Get pre-approved for a mortgage to understand your budget.\n",
+      "\n",
+      "2. **Neighborhood Research:**\n",
+      "   - Visit potential neighborhoods at different times of the day.\n",
+      "   - Consider proximity to work, schools, and amenities.\n",
+      "\n",
+      "3. **Engage a Real Estate Agent:**\n",
+      "   - Choose an agent familiar with Austin's market.\n",
+      "   - Discuss your needs and preferences.\n",
+      "\n",
+      "4. **House Hunting:**\n",
+      "   - Attend open houses and schedule private showings.\n",
+      "   - Compare properties based on criteria and budget.\n",
+      "\n",
+      "5. **Make an Offer:**\n",
+      "   - Work with your agent to make a competitive offer.\n",
+      "   - Be prepared for negotiations.\n",
+      "\n",
+      "6. **Home Inspection and Closing:**\n",
+      "   - Conduct a thorough home inspection.\n",
+      "   - Finalize mortgage details and close the deal.\n",
+      "\n",
+      "> *Remember, buying a home is a significant investment. Take your time to ensure it meets your needs and financial situation.*\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Input your query here\n",
+    "query = \"Help a first-time buyer find a 3-bedroom home under $500,000 in Austin, TX. Include loan and tax guidance.\"\n",
+    "output = home_buying_system.start(input=query)\n",
+    "\n",
+    "# 🏠 Show the results\n",
+    "print(\"🏠 Home Buying Report:\\n\", output)\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/KnowledgeAgent_PraisonAI.ipynb

@@ -0,0 +1,395 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "127dc323",
+   "metadata": {
+    "id": "127dc323"
+   },
+   "source": [
+    "# 📘 KnowledgeAgent - AI-Powered Content Analysis and Summarization Tool"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8290ecb7",
+   "metadata": {
+    "id": "8290ecb7"
+   },
+   "source": [
+    "\n",
+    "This notebook demonstrates how to create an AI-powered **KnowledgeAgent** using the [PraisonAI](https://github.com/MervinPraison/PraisonAI/) framework.  \n",
+    "The agent performs content analysis and summarization tasks using LLMs and a vector database.  \n",
+    "Runs on Google Colab free tier.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "Lxx3NiCrpFNM",
+   "metadata": {
+    "id": "Lxx3NiCrpFNM"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/KnowledgeAgent_PraisonAI.ipynb)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "N4Vxz84co0Ac",
+   "metadata": {
+    "id": "N4Vxz84co0Ac"
+   },
+   "source": [
+    "# Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "1241a155",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "1241a155",
+    "outputId": "05e987e6-e332-42a6-af0e-109aed2d6016"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/175.6 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m175.6/175.6 kB\u001b[0m \u001b[31m8.9 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/130.2 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m130.2/130.2 kB\u001b[0m \u001b[31m11.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/103.8 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m103.8/103.8 kB\u001b[0m \u001b[31m9.9 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/44.4 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m44.4/44.4 kB\u001b[0m \u001b[31m3.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q praisonaiagents"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "258c378c",
+   "metadata": {
+    "id": "258c378c"
+   },
+   "source": [
+    "\n",
+    "## 🔧 Tools Used\n",
+    "- [PraisonAI](https://github.com/MervinPraison/PraisonAI): Multi-agent framework for LLMs  \n",
+    "- OpenAI API: Used as the backend model (you'll need an API key)  \n",
+    "- Built-in vector store for document retrieval (RAG)  \n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "26723867",
+   "metadata": {
+    "id": "26723867"
+   },
+   "source": [
+    "\n",
+    "## 🧾 YAML Prompt (Equivalent in Python)\n",
+    "The agent will:\n",
+    "- Be called `KnowledgeAgent`\n",
+    "- Analyze documents or topics\n",
+    "- Summarize findings in structured format\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "vDnilJPOo3Q4",
+   "metadata": {
+    "id": "vDnilJPOo3Q4"
+   },
+   "source": [
+    "# Setting Up Your OpenAI API Key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7K3qo_5WocdJ",
+   "metadata": {
+    "id": "7K3qo_5WocdJ"
+   },
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "from getpass import getpass\n",
+    "\n",
+    "os.environ[\"OPENAI_API_KEY\"] = getpass(\"Enter your OpenAI API key: your api key here\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8MssHldCpCK4",
+   "metadata": {
+    "id": "8MssHldCpCK4"
+   },
+   "source": [
+    "# Main"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "55d0c5f1",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 877,
+     "referenced_widgets": [
+      "3e9d882fec5947bb86b8aa237e498673",
+      "8cd0e464954d433b854f6f743e1016ae"
+     ]
+    },
+    "id": "55d0c5f1",
+    "outputId": "795d2f18-edfc-4c53-ac61-c420d0b660d4"
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">KnowledgeAgent</span>                                                                                       <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mKnowledgeAgent\u001b[0m                                                                                       \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "3e9d882fec5947bb86b8aa237e498673",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 7.9s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 7.9s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Analyze a topic and produce a structured summary. Expected Output: A         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> well-structured paragraph or bullet summary. Please provide only the final result of your work. Do not add any  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> conversation or extra explanation.                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Analyze a topic and produce a structured summary. Expected Output: A         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m well-structured paragraph or bullet summary. Please provide only the final result of your work. Do not add any  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m conversation or extra explanation.                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Topic: The Impact of Artificial Intelligence on Healthcare</span>                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Introduction</span>: Artificial Intelligence (AI) is revolutionizing the healthcare industry by enhancing           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>diagnostic accuracy, personalizing treatment plans, and improving patient outcomes.                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Diagnostic Improvements</span>: AI algorithms, particularly in imaging and pathology, can analyze medical data with <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>high precision, leading to early and accurate disease detection, such as in radiology for identifying tumors <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>or in dermatology for skin cancer detection.                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Personalized Medicine</span>: AI facilitates the development of personalized treatment plans by analyzing genetic   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>information and predicting patient responses to various treatments, thus optimizing therapeutic efficacy and <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>minimizing adverse effects.                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Operational Efficiency</span>: AI streamlines administrative tasks, such as scheduling, patient record management,  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>and billing, reducing the burden on healthcare professionals and allowing them to focus more on patient      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>care.                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Predictive Analytics</span>: AI models can predict patient admission rates, potential outbreaks, and disease        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>progression, enabling proactive healthcare management and resource allocation.                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Challenges</span>: Despite its benefits, AI in healthcare faces challenges like data privacy concerns, the need for <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>large datasets for training, potential biases in AI algorithms, and the requirement for regulatory           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>frameworks to ensure safety and efficacy.                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Future Prospects</span>: Continued advancements in AI technology promise further integration into healthcare,       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>potentially leading to fully automated diagnostic systems and more sophisticated predictive models,          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>ultimately transforming patient care and healthcare delivery.                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mTopic: The Impact of Artificial Intelligence on Healthcare\u001b[0m                                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mIntroduction\u001b[0m: Artificial Intelligence (AI) is revolutionizing the healthcare industry by enhancing           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mdiagnostic accuracy, personalizing treatment plans, and improving patient outcomes.                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mDiagnostic Improvements\u001b[0m: AI algorithms, particularly in imaging and pathology, can analyze medical data with \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mhigh precision, leading to early and accurate disease detection, such as in radiology for identifying tumors \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mor in dermatology for skin cancer detection.                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPersonalized Medicine\u001b[0m: AI facilitates the development of personalized treatment plans by analyzing genetic   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0minformation and predicting patient responses to various treatments, thus optimizing therapeutic efficacy and \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mminimizing adverse effects.                                                                                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mOperational Efficiency\u001b[0m: AI streamlines administrative tasks, such as scheduling, patient record management,  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mand billing, reducing the burden on healthcare professionals and allowing them to focus more on patient      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mcare.                                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPredictive Analytics\u001b[0m: AI models can predict patient admission rates, potential outbreaks, and disease        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mprogression, enabling proactive healthcare management and resource allocation.                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mChallenges\u001b[0m: Despite its benefits, AI in healthcare faces challenges like data privacy concerns, the need for \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mlarge datasets for training, potential biases in AI algorithms, and the requirement for regulatory           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mframeworks to ensure safety and efficacy.                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mFuture Prospects\u001b[0m: Continued advancements in AI technology promise further integration into healthcare,       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mpotentially leading to fully automated diagnostic systems and more sophisticated predictive models,          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0multimately transforming patient care and healthcare delivery.                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "📄 Output Summary:\n",
+      "**Topic: The Impact of Artificial Intelligence on Healthcare**\n",
+      "\n",
+      "- **Introduction**: Artificial Intelligence (AI) is revolutionizing the healthcare industry by enhancing diagnostic accuracy, personalizing treatment plans, and improving patient outcomes.\n",
+      "  \n",
+      "- **Diagnostic Improvements**: AI algorithms, particularly in imaging and pathology, can analyze medical data with high precision, leading to early and accurate disease detection, such as in radiology for identifying tumors or in dermatology for skin cancer detection.\n",
+      "\n",
+      "- **Personalized Medicine**: AI facilitates the development of personalized treatment plans by analyzing genetic information and predicting patient responses to various treatments, thus optimizing therapeutic efficacy and minimizing adverse effects.\n",
+      "\n",
+      "- **Operational Efficiency**: AI streamlines administrative tasks, such as scheduling, patient record management, and billing, reducing the burden on healthcare professionals and allowing them to focus more on patient care.\n",
+      "\n",
+      "- **Predictive Analytics**: AI models can predict patient admission rates, potential outbreaks, and disease progression, enabling proactive healthcare management and resource allocation.\n",
+      "\n",
+      "- **Challenges**: Despite its benefits, AI in healthcare faces challenges like data privacy concerns, the need for large datasets for training, potential biases in AI algorithms, and the requirement for regulatory frameworks to ensure safety and efficacy.\n",
+      "\n",
+      "- **Future Prospects**: Continued advancements in AI technology promise further integration into healthcare, potentially leading to fully automated diagnostic systems and more sophisticated predictive models, ultimately transforming patient care and healthcare delivery.\n"
+     ]
+    }
+   ],
+   "source": [
+    "\n",
+    "from praisonaiagents import Agent, Task, PraisonAIAgents\n",
+    "import os\n",
+    "\n",
+    "# 🔑 Set your OpenAI API key\n",
+    "os.environ[\"OPENAI_API_KEY\"] = \"YOUR_API_KEY\"\n",
+    "# Define agent\n",
+    "knowledge_agent = Agent(\n",
+    "    name=\"KnowledgeAgent\",\n",
+    "    instructions=\"You are a knowledge expert. Research the given topic and summarize it clearly and concisely.\"\n",
+    ")\n",
+    "\n",
+    "# Define task\n",
+    "knowledge_task = Task(\n",
+    "    name=\"SummarizationTask\",\n",
+    "    description=\"Analyze a topic and produce a structured summary\",\n",
+    "    expected_output=\"A well-structured paragraph or bullet summary\",\n",
+    "    agent=knowledge_agent\n",
+    ")\n",
+    "\n",
+    "# Build system\n",
+    "agents = PraisonAIAgents(\n",
+    "    agents=[knowledge_agent],\n",
+    "    tasks=[knowledge_task],\n",
+    "    process=\"sequential\"\n",
+    ")\n",
+    "\n",
+    "# Run the system\n",
+    "result = agents.start(input=\"Explain how quantum computing differs from classical computing.\")\n",
+    "print(\"📄 Output Summary:\")\n",
+    "print(result)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "910d0f04",
+   "metadata": {
+    "id": "910d0f04"
+   },
+   "source": [
+    "\n",
+    "## 📄 Output\n",
+    "The output will be a structured summary of the input topic (in this case: **quantum vs classical computing**).  \n",
+    "If the model cannot run due to Colab limits, a text description will be printed instead.\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/LLaMA3_2_11B_Vision_Model.ipynb

@@ -0,0 +1,635 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "7eb3b7a8",
+      "metadata": {
+        "id": "7eb3b7a8"
+      },
+      "source": [
+        "# LLaMA3-2 (11B) Vision Model"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "4914e815",
+      "metadata": {
+        "id": "4914e815"
+      },
+      "source": [
+        "## Description\n",
+        "This notebook demonstrates how to use the **LLaMA3-2 (11B) Vision Model** vision-language model for image input and text generation tasks."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/LLaMA3_2_11B_Vision_Model.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "j_sehN-6kKcp"
+      },
+      "id": "j_sehN-6kKcp"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "366d7561",
+      "metadata": {
+        "id": "366d7561"
+      },
+      "source": [
+        "## Dependencies\n",
+        "```python\n",
+        "!pip install transformers accelerate torch torchvision\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "750d4351",
+      "metadata": {
+        "id": "750d4351"
+      },
+      "source": [
+        "## Tools\n",
+        "- 🤗 Transformers\n",
+        "- PyTorch\n",
+        "- Vision Model APIs"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "9f053796",
+      "metadata": {
+        "id": "9f053796"
+      },
+      "source": [
+        "## YAML Prompt\n",
+        "```yaml\n",
+        "mode: vision\n",
+        "model: LLaMA3-2 (11B) Vision Model\n",
+        "tasks:\n",
+        "  - image captioning\n",
+        "  - visual question answering\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "b920aca2",
+      "metadata": {
+        "id": "b920aca2"
+      },
+      "source": [
+        "## Main\n",
+        "Below is the simplified main execution to load the model and run basic inference."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "fb97f999",
+      "metadata": {
+        "id": "fb97f999"
+      },
+      "outputs": [],
+      "source": [
+        "%%capture\n",
+        "import os\n",
+        "if \"COLAB_\" not in \"\".join(os.environ.keys()):\n",
+        "    !pip install unsloth\n",
+        "else:\n",
+        "    # Do this only in Colab notebooks! Otherwise use pip install unsloth\n",
+        "    !pip install --no-deps bitsandbytes accelerate xformers==0.0.29.post3 peft trl triton cut_cross_entropy unsloth_zoo\n",
+        "    !pip install sentencepiece protobuf \"datasets>=3.4.1\" huggingface_hub hf_transfer\n",
+        "    !pip install --no-deps unsloth"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "2a6e11d8",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 511,
+          "referenced_widgets": [
+            "98d2cd94be9c454f83a18c8bf5fe9aec",
+            "c6d906d5fa284667a7021b56fb731e98",
+            "2394d94e0e714ffdb528b55605f40dc0",
+            "144522321d134e94858678d525a85f80",
+            "eaa4f5b890c3436bb8da3e74a8eeb237",
+            "a85bb0dcd185406c885af8d491cf3c22",
+            "91a165c1dade4c1b9d7c01771b61291e",
+            "24f8f69538bb469192088f3ffa1ed624",
+            "f5123643c11240c0bcc3d3588e8e8a1b",
+            "ef9a483fb2a3478cb94331868ab2db90",
+            "ce61267651164b50aa49876a05b7296a",
+            "289cd006e4ff4f018e758890e148c852",
+            "c8abe988d9864ca1955430b023c223ad",
+            "ad5361da5e774447b07bab7e0f272813",
+            "7fd8253214984e578754c1a7f184687e",
+            "e84d7f0735e045f498a85deee72e4a36",
+            "0d6664235d744c66bc567215699966b3",
+            "14ec87fd00454cc9b6e75a37d9cf2c1c",
+            "79e970816ead4141a8dc3c534db3a54c",
+            "f90c77c1bd02487da4d91289243c6a28",
+            "b0ea1c891cd44fb38f874d28f1b71ad7",
+            "017cce265bf84be7bd9b8ebe5f25047e",
+            "d0fc6802d6034d33bb33be048799320d",
+            "21df32143aa4410c885c0b84ce68466a",
+            "5dc3fb97742846c3bf4e6b99159d88ed",
+            "16583bf31a1846e0926fcfc3690fa505",
+            "b3638367ff0749ecabfef81e18c3f3dd",
+            "c84a668f99be4a74aae5cca75a2448d8",
+            "8dbb8561b0214721b69a0b4c41a9e431",
+            "d5bdec8c59af4d3a94ed7d2bfa2b7921",
+            "2d361e1d14c64f09b3dae11750e287f4",
+            "1ecf09bddb4046218cc703af721dced3",
+            "2361b35c79864c10a84b44929f69c547",
+            "97b945925ec94ee8851187d97a3b3e01",
+            "b332f446bf5a457bb1bb32862fb25779",
+            "4408a069a4e341d59423b51c25afbd64",
+            "f7902776f2a44de294a21f8d9d1f4e73",
+            "667e586bf81d4f90b17247741fed6a16",
+            "66b02dd825894df9b4c07fbf6a9d55b7",
+            "ae9fdc486fee4a07a332d2767aa487d3",
+            "b237fb86f5b24341a830c3707f881d12",
+            "8c436fe0faee404e8d61d9afa916d6b3",
+            "70141c664f464503b8a0821e6fb8aff2",
+            "03d88b6a463c40febec9e44329493ed3",
+            "443cae09fcc74bce8c85514c0e3306f8",
+            "5e3c171ca5494501841b1cabe5c083fe",
+            "ba6bf08f321841e180630e24ad14e31c",
+            "c18a21dd2b4f4d53afcf25d5e2f282ba",
+            "a61ba57420fc4fb387d03fbf2261e0d7",
+            "fe2444e22fac4ce48a2ac8b9483dd0ab",
+            "fe43c14445c54ea590a28bc3663d0c48",
+            "47ade2b90f5d41469fe68aa452043b10",
+            "3c4722f0972b4bbf995ea7285a61ba26",
+            "981e19084d2c4c4da0285ab6758e53d0",
+            "8ae036dfd56e4e92916f2030dbb5d634",
+            "c90bdb60e0fc46d8aa1d9e858cbbdd07",
+            "a7e36b913ce946e0808a5bc3f5b9744b",
+            "1ea701fee9fa4aac92ae9750da494815",
+            "c85f1cfff87b435f9041ecd4b657587b",
+            "e4eb768259094b0ea344ac96181842b4",
+            "51c2efe52566422394209040317384d9",
+            "c48225673e394ae9873b25a8b13446b9",
+            "9b97b57c43ec47ffad7e15ab3c7f21be",
+            "5f810775e57943bdafcceeccca145450",
+            "b1a430285adc498d836178ba93ec5604",
+            "43c0b5f1598e487194f846977edb2d9e",
+            "4f579cd077cd41c798478f572d592f6a",
+            "56a5f8469b834a998dbf9b195828f3de",
+            "e21d0116f78140cd9a2dfd548b93cdd9",
+            "49639c7bec544b3d92340188e9fab090",
+            "644eb1b7ad734624a51ec0c3435a96dc",
+            "181c7cd4ce0140b7a7bcdb8bda323529",
+            "4a9844c83b104b2dbb1b1149e894089b",
+            "9156991030be4967a32b7014fbb9d202",
+            "4e5e63413ead4256ad5900667f5c03b2",
+            "d70e648f960c4f71b0c4b250fef32654",
+            "ad3adfba64654cf2859f850c3de05e31",
+            "a37acc4c0f11436c80cb72272709a9fe",
+            "9b46b99cc8f5432cbce73a2913141033",
+            "96cc9201587f47679d0262868277b160",
+            "58691977879e424fa8d480be75a6e70d",
+            "8edb9a9006df4929b41b6531d9c27c95",
+            "cbd4cf8895514baa9420289c14455686",
+            "397e656680024d148a597cad7def07f5",
+            "c0297069253140978f1ccb5c1fed852c",
+            "1808e709f81847cabc126abe8552c289",
+            "f5117b4078194a058dac514abce9d08a",
+            "ed18219a0316437d8aef630b5de85b75",
+            "74742a6f4bb94067b6e6703cef8c3941",
+            "d1abd20ebc684c839df31d06cb5d658f",
+            "1d3238444dd041839602d3db4ed7fde2",
+            "daaf3480c1794c8895049dcd8eec3573",
+            "028dc1c882454b0dbbebdfbeb6eb4ca3",
+            "28450d6b5cc145afb3f4fda0f133b7ac",
+            "f5e7b16ff8f84ba888dd1af0e08df12d",
+            "d7bcadb25ead446181103aaba00f52c0",
+            "25f52c2d14c54eb09923acf20e85ca07",
+            "8df67a8cbe0c4734b52754108642ac10",
+            "04db919ebb474ae6bd1fba3cb9437eb6",
+            "1a4c9e787979474b9049e36f8c07c12b",
+            "3de2161fe36a43699a713916adc09857",
+            "125518e68b4e491a8e6d40c40504a5fb",
+            "fced4e62adb743798567c2c0f0d90966",
+            "77c06023e71440308a6aedd86190ab9b",
+            "2d508731af60413ea81136dc2ab64a76",
+            "2036bb5ed5fa4bd49e1d76f2b713b6a1",
+            "f9e6e2e5b59a4a0984ca0a83db0b186d",
+            "5b0ca7559eea43edb7009bc8ad41dcd6",
+            "db0696c568d34b6eab55305e2b87c1e2",
+            "95d28ba0fd2c47e2bb1fc145d82c7164",
+            "9430d398534341bca671d10e8bc91ddc",
+            "020c2d09aa4941b5bddfb3ce9470f9e6",
+            "bf309ecf24bb4ca68f72ce1acf72b739",
+            "148b83fa058145b98b69e29cda2f9dcc",
+            "e0ff84feca0f4c52b3c7d23cdff1a110",
+            "5a5cf37b757f4af78a0ad69f0ed5bfbc",
+            "65a2889ce3c04085a0702ce3bd75c9c9",
+            "0f5aee18791e4f8d95f86f6254ac7878",
+            "6fc02729c4254edcb86daf71336f30d6",
+            "7f5ece3436c64e51b34c20503d2fc0c3",
+            "d2c0dc378e864f42bc9994f7bc31ee1d"
+          ]
+        },
+        "id": "2a6e11d8",
+        "outputId": "f63afa9e-e320-4da2-bb91-b7f4f9163379"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🦥 Unsloth: Will patch your computer to enable 2x faster free finetuning.\n",
+            "🦥 Unsloth Zoo will now patch everything to make training faster!\n",
+            "==((====))==  Unsloth 2024.11.9: Fast Mllama vision patching. Transformers = 4.46.2.\n",
+            "   \\\\   /|    GPU: Tesla T4. Max memory: 14.748 GB. Platform = Linux.\n",
+            "O^O/ \\_/ \\    Pytorch: 2.5.1+cu121. CUDA = 7.5. CUDA Toolkit = 12.1.\n",
+            "\\        /    Bfloat16 = FALSE. FA [Xformers = 0.0.28.post3. FA2 = False]\n",
+            " \"-____-\"     Free Apache license: http://github.com/unslothai/unsloth\n",
+            "Unsloth: Fast downloading is enabled - ignore downloading bars which are red colored!\n"
+          ]
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "98d2cd94be9c454f83a18c8bf5fe9aec",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model.safetensors.index.json:   0%|          | 0.00/385k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "289cd006e4ff4f018e758890e148c852",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Downloading shards:   0%|          | 0/2 [00:00<?, ?it/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "d0fc6802d6034d33bb33be048799320d",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model-00001-of-00002.safetensors:   0%|          | 0.00/5.00G [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "97b945925ec94ee8851187d97a3b3e01",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model-00002-of-00002.safetensors:   0%|          | 0.00/2.18G [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "443cae09fcc74bce8c85514c0e3306f8",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Loading checkpoint shards:   0%|          | 0/2 [00:00<?, ?it/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "c90bdb60e0fc46d8aa1d9e858cbbdd07",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "generation_config.json:   0%|          | 0.00/210 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "4f579cd077cd41c798478f572d592f6a",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "preprocessor_config.json:   0%|          | 0.00/477 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "a37acc4c0f11436c80cb72272709a9fe",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer_config.json:   0%|          | 0.00/55.9k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "74742a6f4bb94067b6e6703cef8c3941",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer.json:   0%|          | 0.00/17.2M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "1a4c9e787979474b9049e36f8c07c12b",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "special_tokens_map.json:   0%|          | 0.00/454 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "9430d398534341bca671d10e8bc91ddc",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "chat_template.json:   0%|          | 0.00/5.15k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        }
+      ],
+      "source": [
+        "from unsloth import FastVisionModel # FastLanguageModel for LLMs\n",
+        "import torch\n",
+        "\n",
+        "# 4bit pre quantized models we support for 4x faster downloading + no OOMs.\n",
+        "fourbit_models = [\n",
+        "    \"unsloth/Llama-3.2-11B-Vision-Instruct-bnb-4bit\", # Llama 3.2 vision support\n",
+        "    \"unsloth/Llama-3.2-11B-Vision-bnb-4bit\",\n",
+        "    \"unsloth/Llama-3.2-90B-Vision-Instruct-bnb-4bit\", # Can fit in a 80GB card!\n",
+        "    \"unsloth/Llama-3.2-90B-Vision-bnb-4bit\",\n",
+        "\n",
+        "    \"unsloth/Pixtral-12B-2409-bnb-4bit\",              # Pixtral fits in 16GB!\n",
+        "    \"unsloth/Pixtral-12B-Base-2409-bnb-4bit\",         # Pixtral base model\n",
+        "\n",
+        "    \"unsloth/Qwen2-VL-2B-Instruct-bnb-4bit\",          # Qwen2 VL support\n",
+        "    \"unsloth/Qwen2-VL-7B-Instruct-bnb-4bit\",\n",
+        "    \"unsloth/Qwen2-VL-72B-Instruct-bnb-4bit\",\n",
+        "\n",
+        "    \"unsloth/llava-v1.6-mistral-7b-hf-bnb-4bit\",      # Any Llava variant works!\n",
+        "    \"unsloth/llava-1.5-7b-hf-bnb-4bit\",\n",
+        "] # More models at https://huggingface.co/unsloth\n",
+        "\n",
+        "model, tokenizer = FastVisionModel.from_pretrained(\n",
+        "    \"unsloth/Llama-3.2-11B-Vision-Instruct\",\n",
+        "    load_in_4bit = True, # Use 4bit to reduce memory use. False for 16bit LoRA.\n",
+        "    use_gradient_checkpointing = \"unsloth\", # True or \"unsloth\" for long context\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "cbc24d70",
+      "metadata": {
+        "id": "cbc24d70"
+      },
+      "outputs": [],
+      "source": [
+        "model = FastVisionModel.get_peft_model(\n",
+        "    model,\n",
+        "    finetune_vision_layers     = True, # False if not finetuning vision layers\n",
+        "    finetune_language_layers   = True, # False if not finetuning language layers\n",
+        "    finetune_attention_modules = True, # False if not finetuning attention layers\n",
+        "    finetune_mlp_modules       = True, # False if not finetuning MLP layers\n",
+        "\n",
+        "    r = 16,           # The larger, the higher the accuracy, but might overfit\n",
+        "    lora_alpha = 16,  # Recommended alpha == r at least\n",
+        "    lora_dropout = 0,\n",
+        "    bias = \"none\",\n",
+        "    random_state = 3407,\n",
+        "    use_rslora = False,  # We support rank stabilized LoRA\n",
+        "    loftq_config = None, # And LoftQ\n",
+        "    # target_modules = \"all-linear\", # Optional now! Can specify a list if needed\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "9e47b862",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 177,
+          "referenced_widgets": [
+            "aecf49a7a37445dfb4af43fed91cdc97",
+            "209f0d74e16b4c03a72687d796958863",
+            "17c372165582427dbc34abfd5dfdaa6c",
+            "59110c931b0b45d5a61d7dae7c7e7120",
+            "1ab79420b99e4508944ba5b4361171f8",
+            "89284068a3be4af4a0d9b8bc50b9afba",
+            "d11bd8033e4740929088a4fd0ef883c5",
+            "cc1cf7cbbcae4771be85c3e628510997",
+            "758e626f5c2f4b0193e1cf27824818ca",
+            "dfdce9a9549448a8a475db2c2507f5eb",
+            "4893fac70136425c9aa1c685e4ce71f3",
+            "ee828b24ee424cfc82b2f3b87636940a",
+            "115f636f0c0a4c1ebee21d973ff09e40",
+            "adb8a39222db4fe880c180fe5c601dbe",
+            "775514e06f1c453fa311d528b3d62749",
+            "523f128189f746ce9fb7a594e72e9c7e",
+            "72715b7c03e34b01b5f7715ce658eacd",
+            "432103db24e448e8b62bce3af49ec581",
+            "b382f1fd5c1645169079cdef08c14357",
+            "5ad48ea79bde44639976eeb61377b74d",
+            "2ae0d6c5c4c1419293e7b3832b8d8a17",
+            "71f1e8c406a54c52b6983ff2b922be20",
+            "34c7dbce08a146a7949152b0cac8666d",
+            "f8e7b74b13864adc9d6cfccaa9a11362",
+            "2aaa6c22a7d34c2aa20a169236a72f59",
+            "c79fefc6a20d4bce9eca13b0b1a604aa",
+            "8463516108b8491d8aaa0449a7f21f05",
+            "cb71c9d8d57744fb9cfeb740d7ea50e6",
+            "0241e7fc2a86481389ce140690fc544a",
+            "315e97f8931941d382ae5b91e1d644a0",
+            "ebdc57260e224077b0ba08ffbb3fb6a1",
+            "0ee41ec935844b09850972773468b5de",
+            "e7fabc6d4ea8476a9459604d745b7f08",
+            "5034f195628e43b98e4ab33fd297308c",
+            "46686703d557405685b5e910d81cfb4a",
+            "55e11fafe31f4147a7a53c870f637527",
+            "7fa57079e7414449a9b04330c91bd50d",
+            "add5ec75448b4378b8e7aab92a5e53f5",
+            "2e2dcbc6ae13435fa6bb91c35dbdf1ae",
+            "64a4a67880614ecebad79f9ac957d4af",
+            "dff190bbf4a746d393857037be5e5d72",
+            "7ebc322bc4824599a6f59ed979eae207",
+            "d61c2405111d4acc8428e1cebb96c963",
+            "5263b46f262a40518c43778191394e4a",
+            "78f33011fc0648439338fb4556284f31",
+            "b08e04e041a84597b225f2194943d715",
+            "7d36203af6344d50813eab42af8df957",
+            "00714fb691c14ca6a9ee14ead204b6c0",
+            "7d057295875d4525a165c823ff222268",
+            "be882001119342ebbbbc3f73dbfa5356",
+            "2713d41644f84b5290c0dd94b2953b2a",
+            "235bc65f45ac4b369e1e03582b1b2061",
+            "d2d708ed937b4deb8d72805e98b3aa9b",
+            "c0fc8d1e49d643b0b9871080545cbb27",
+            "f9bae803d6944df98773db211a4e98b6"
+          ]
+        },
+        "id": "9e47b862",
+        "outputId": "ac18735b-4865-4634-cdac-0672be9dc0e6"
+      },
+      "outputs": [
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "aecf49a7a37445dfb4af43fed91cdc97",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "README.md:   0%|          | 0.00/610 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "ee828b24ee424cfc82b2f3b87636940a",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "train-00000-of-00001.parquet:   0%|          | 0.00/481M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "34c7dbce08a146a7949152b0cac8666d",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "test-00000-of-00001.parquet:   0%|          | 0.00/79.2M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "5034f195628e43b98e4ab33fd297308c",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Generating train split:   0%|          | 0/1978 [00:00<?, ? examples/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "78f33011fc0648439338fb4556284f31",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Generating test split:   0%|          | 0/327 [00:00<?, ? examples/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        }
+      ],
+      "source": [
+        "from datasets import load_dataset\n",
+        "\n",
+        "dataset = load_dataset(\"unsloth/Radiology_mini\", split=\"train\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "c437c09d",
+      "metadata": {
+        "id": "c437c09d"
+      },
+      "source": [
+        "## Output\n",
+        "This shows a basic output example of the vision-language model."
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Meta_LLaMA3_SyntheticData.ipynb

@@ -0,0 +1,157 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "930bc11c",
+      "metadata": {
+        "id": "930bc11c"
+      },
+      "source": [
+        "# Meta Synthetic Data Generator (LLaMA 3.2 - 3B)\n",
+        "\n",
+        "This notebook demonstrates how to use Meta's LLaMA 3.2 3B model to generate synthetic data for use in AI training or application prototyping."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Meta_LLaMA3_SyntheticData.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "KPi7FpbV9J2d"
+      },
+      "id": "KPi7FpbV9J2d"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "80f68ecf",
+      "metadata": {
+        "id": "80f68ecf"
+      },
+      "source": [
+        "## Dependencies"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "7eeb508d",
+      "metadata": {
+        "id": "7eeb508d"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install -q transformers accelerate bitsandbytes"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "eda75a0c",
+      "metadata": {
+        "id": "eda75a0c"
+      },
+      "source": [
+        "## Tools\n",
+        "* `transformers` for model loading and text generation\n",
+        "* `pipeline` for simplified inference\n",
+        "* `AutoTokenizer`, `AutoModelForCausalLM` for LLaMA 3.2"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "6ee96383",
+      "metadata": {
+        "id": "6ee96383"
+      },
+      "source": [
+        "## YAML Prompt"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "aa4e56ef",
+      "metadata": {
+        "id": "aa4e56ef"
+      },
+      "outputs": [],
+      "source": [
+        "prompt: |\n",
+        "  task: \"Generate a customer complaint email\"\n",
+        "  style: \"Professional\"\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "e9fbe400",
+      "metadata": {
+        "id": "e9fbe400"
+      },
+      "source": [
+        "## Main"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "3e35336f",
+      "metadata": {
+        "id": "3e35336f"
+      },
+      "outputs": [],
+      "source": [
+        "from transformers import AutoTokenizer, AutoModelForCausalLM, pipeline\n",
+        "\n",
+        "# Load tokenizer and model (LLaMA 3.2 - 3B)\n",
+        "model_id = \"meta-llama/Meta-Llama-3-3B-Instruct\"\n",
+        "tokenizer = AutoTokenizer.from_pretrained(model_id)\n",
+        "model = AutoModelForCausalLM.from_pretrained(model_id)\n",
+        "\n",
+        "# Create a simple text generation pipeline\n",
+        "generator = pipeline(\"text-generation\", model=model, tokenizer=tokenizer)\n",
+        "\n",
+        "# Example synthetic data prompt\n",
+        "prompt = \"Create a customer support query about a late delivery.\"\n",
+        "\n",
+        "# Generate synthetic text\n",
+        "output = generator(prompt, max_length=60, do_sample=True)[0]['generated_text']\n",
+        "print(\"📝 Synthetic Output:\", output)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "ed28cc2e",
+      "metadata": {
+        "id": "ed28cc2e"
+      },
+      "source": [
+        "## Output"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "6fc8f19e",
+      "metadata": {
+        "id": "6fc8f19e"
+      },
+      "source": [
+        "🖼️ Output Preview (Text Summary):\n",
+        "\n",
+        "Prompt: \"Create a customer support query about a late delivery.\"\n",
+        "\n",
+        "📝 Output: The LLaMA model generates a realistic complaint, such as:\n",
+        "\n",
+        "\"Dear Support Team, I placed an order two weeks ago and have yet to receive it...\"\n",
+        "\n",
+        "🎯 This illustrates how the model can be used to generate realistic synthetic data for tasks like training chatbots or support models.\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Phi_3_5_Mini_Conversational.ipynb

@@ -0,0 +1,120 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "468831db",
+      "metadata": {
+        "id": "468831db"
+      },
+      "source": [
+        "# Phi-3.5 Mini Conversational Example"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "ecb80fe2",
+      "metadata": {
+        "id": "ecb80fe2"
+      },
+      "source": [
+        "**Description:**\n",
+        "\n",
+        "Demonstrates lightweight inference using Phi-3.5 Mini, suitable for smaller hardware and educational use cases."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Phi_3_5_Mini_Conversational.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "S1erg7-JP6n3"
+      },
+      "id": "S1erg7-JP6n3"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0822161c",
+      "metadata": {
+        "id": "0822161c"
+      },
+      "source": [
+        "**Dependencies**\n",
+        "\n",
+        "```python\n",
+        "!pip install transformers accelerate\n",
+        "!pip install torch\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0df5580b",
+      "metadata": {
+        "id": "0df5580b"
+      },
+      "source": [
+        "**Tools Used**\n",
+        "\n",
+        "- HuggingFace Transformers\n",
+        "- PyTorch"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "9d6df43d",
+      "metadata": {
+        "id": "9d6df43d"
+      },
+      "source": [
+        "**YAML Prompt**\n",
+        "\n",
+        "```yaml\n",
+        "system: You are a helpful assistant.\n",
+        "user: Explain what an AI model is.\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "0e775593",
+      "metadata": {
+        "id": "0e775593"
+      },
+      "outputs": [],
+      "source": [
+        "from transformers import AutoTokenizer, AutoModelForCausalLM\n",
+        "\n",
+        "tokenizer = AutoTokenizer.from_pretrained(\"microsoft/phi-3.5-mini\")\n",
+        "model = AutoModelForCausalLM.from_pretrained(\"microsoft/phi-3.5-mini\")\n",
+        "\n",
+        "inputs = tokenizer(\"What is an AI model?\", return_tensors=\"pt\")\n",
+        "outputs = model.generate(**inputs, max_new_tokens=40)\n",
+        "print(tokenizer.decode(outputs[0], skip_special_tokens=True))"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "187fe354",
+      "metadata": {
+        "id": "187fe354"
+      },
+      "source": [
+        "**Output**\n",
+        "\n",
+        "The model gives a basic explanation of what AI models do.\n",
+        "\n",
+        "What is an AI model?\n",
+        "An AI model is a computer program that is trained on large amounts of data to perform tasks that normally require human intelligence.\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Phi_3_Medium_Conversational.ipynb

@@ -0,0 +1,122 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "ddb8fd1c",
+      "metadata": {
+        "id": "ddb8fd1c"
+      },
+      "source": [
+        "# Phi-3 Medium Conversational Inference"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Phi_3_Medium_Conversational.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "uMIvNFtYQDKO"
+      },
+      "id": "uMIvNFtYQDKO"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "71a9292d",
+      "metadata": {
+        "id": "71a9292d"
+      },
+      "source": [
+        "**Description:**\n",
+        "\n",
+        "Run a conversational inference using the Phi-3 Medium model with an efficient pipeline. The notebook illustrates basic loading, prompting, and response generation."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "9023e3f2",
+      "metadata": {
+        "id": "9023e3f2"
+      },
+      "source": [
+        "**Dependencies**\n",
+        "\n",
+        "```python\n",
+        "!pip install transformers accelerate\n",
+        "!pip install torch torchvision\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "8ed8c345",
+      "metadata": {
+        "id": "8ed8c345"
+      },
+      "source": [
+        "**Tools Used**\n",
+        "\n",
+        "- HuggingFace Transformers\n",
+        "- Accelerate\n",
+        "- PyTorch"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "68cb4bd6",
+      "metadata": {
+        "id": "68cb4bd6"
+      },
+      "source": [
+        "**YAML Prompt**\n",
+        "\n",
+        "```yaml\n",
+        "system: You are a helpful assistant.\n",
+        "user: What is the capital of France?\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "be5d0fde",
+      "metadata": {
+        "id": "be5d0fde"
+      },
+      "outputs": [],
+      "source": [
+        "from transformers import AutoTokenizer, AutoModelForCausalLM\n",
+        "import torch\n",
+        "\n",
+        "model = AutoModelForCausalLM.from_pretrained(\"microsoft/phi-3-medium\")\n",
+        "tokenizer = AutoTokenizer.from_pretrained(\"microsoft/phi-3-medium\")\n",
+        "\n",
+        "prompt = \"What is the capital of France?\"\n",
+        "inputs = tokenizer(prompt, return_tensors=\"pt\")\n",
+        "outputs = model.generate(**inputs, max_new_tokens=20)\n",
+        "print(tokenizer.decode(outputs[0], skip_special_tokens=True))"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "4ac8c793",
+      "metadata": {
+        "id": "4ac8c793"
+      },
+      "source": [
+        "**Output**\n",
+        "\n",
+        "This example shows the model answering a simple geography question.\n",
+        "\n",
+        "What is the capital of France? The capital of France is Paris.\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Phi_4_14B_GRPO.ipynb

@@ -0,0 +1,123 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "cc1b7810",
+      "metadata": {
+        "id": "cc1b7810"
+      },
+      "source": [
+        "# Phi-4 (14B) Conversational with GRPO"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "9c882a2d",
+      "metadata": {
+        "id": "9c882a2d"
+      },
+      "source": [
+        "**Description:**\n",
+        "\n",
+        "This notebook demonstrates inference using the Phi-4 14B parameter model with GRPO optimization strategy."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Phi_4_14B_GRPO.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "Z7azojscP0Ax"
+      },
+      "id": "Z7azojscP0Ax"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "e8616784",
+      "metadata": {
+        "id": "e8616784"
+      },
+      "source": [
+        "**Dependencies**\n",
+        "\n",
+        "```python\n",
+        "!pip install transformers accelerate\n",
+        "!pip install torch\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "09866448",
+      "metadata": {
+        "id": "09866448"
+      },
+      "source": [
+        "**Tools Used**\n",
+        "\n",
+        "- HuggingFace Transformers\n",
+        "- GRPO Optimization\n",
+        "- PyTorch"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "403b0c37",
+      "metadata": {
+        "id": "403b0c37"
+      },
+      "source": [
+        "**YAML Prompt**\n",
+        "\n",
+        "```yaml\n",
+        "system: Act as a professional consultant.\n",
+        "user: How can AI help in healthcare?\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "e1785bcd",
+      "metadata": {
+        "id": "e1785bcd"
+      },
+      "outputs": [],
+      "source": [
+        "from transformers import AutoTokenizer, AutoModelForCausalLM\n",
+        "\n",
+        "tokenizer = AutoTokenizer.from_pretrained(\"microsoft/phi-4-14b\")\n",
+        "model = AutoModelForCausalLM.from_pretrained(\"microsoft/phi-4-14b\")\n",
+        "\n",
+        "prompt = \"How can AI help in healthcare?\"\n",
+        "inputs = tokenizer(prompt, return_tensors=\"pt\")\n",
+        "outputs = model.generate(**inputs, max_new_tokens=60)\n",
+        "print(tokenizer.decode(outputs[0], skip_special_tokens=True))"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "074e4e6e",
+      "metadata": {
+        "id": "074e4e6e"
+      },
+      "source": [
+        "**Output**\n",
+        "\n",
+        "The model generates thoughtful insights on AI applications in healthcare.\n",
+        "\n",
+        "How can AI help in healthcare?\n",
+        "\n",
+        "AI can assist in healthcare by improving diagnostics, predicting patient outcomes, personalizing treatments, and enhancing administrative workflows. It enables faster data analysis and decision-making, leading to better patient care.\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Phi_4_Conversational.ipynb

@@ -0,0 +1,124 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "7b502c12",
+      "metadata": {
+        "id": "7b502c12"
+      },
+      "source": [
+        "# Phi-4 Conversational Chat"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "6f550ca9",
+      "metadata": {
+        "id": "6f550ca9"
+      },
+      "source": [
+        "**Description:**\n",
+        "\n",
+        "Basic conversational inference with Phi-4 demonstrating chat-style turn-based communication."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Phi_4_Conversational.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "CB4mkM7yPmua"
+      },
+      "id": "CB4mkM7yPmua"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "e0db4638",
+      "metadata": {
+        "id": "e0db4638"
+      },
+      "source": [
+        "**Dependencies**\n",
+        "\n",
+        "```python\n",
+        "!pip install transformers accelerate\n",
+        "!pip install torch\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "25ef05dd",
+      "metadata": {
+        "id": "25ef05dd"
+      },
+      "source": [
+        "**Tools Used**\n",
+        "\n",
+        "- HuggingFace Transformers\n",
+        "- PyTorch"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "8986b9d8",
+      "metadata": {
+        "id": "8986b9d8"
+      },
+      "source": [
+        "**YAML Prompt**\n",
+        "\n",
+        "```yaml\n",
+        "system: You are a tutor.\n",
+        "user: Teach me what machine learning is.\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "ffdb2319",
+      "metadata": {
+        "id": "ffdb2319"
+      },
+      "outputs": [],
+      "source": [
+        "from transformers import AutoTokenizer, AutoModelForCausalLM\n",
+        "\n",
+        "tokenizer = AutoTokenizer.from_pretrained(\"microsoft/phi-4\")\n",
+        "model = AutoModelForCausalLM.from_pretrained(\"microsoft/phi-4\")\n",
+        "\n",
+        "prompt = \"Teach me what machine learning is.\"\n",
+        "inputs = tokenizer(prompt, return_tensors=\"pt\")\n",
+        "outputs = model.generate(**inputs, max_new_tokens=80)\n",
+        "print(tokenizer.decode(outputs[0], skip_special_tokens=True))"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "ac4caeac",
+      "metadata": {
+        "id": "ac4caeac"
+      },
+      "source": [
+        "**Output**\n",
+        "\n",
+        "Explains machine learning in a clear, tutor-like manner.\n",
+        "\n",
+        "Machine learning is a field of artificial intelligence that allows computers to learn from data without being explicitly programmed.\n",
+        "It involves training algorithms on large datasets so they can recognize patterns, make decisions, or perform tasks.\n",
+        "There are different types of machine learning, including supervised, unsupervised, and reinforcement learning.\n",
+        "For example, in supervised learning, a model is trained using labeled data to predict outcomes.\n",
+        "Overall, machine learning is widely used in applications like recommendation systems, image recognition, and natural language processing.\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Pixtral_12B_Vision_Model.ipynb

@@ -0,0 +1,660 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "23d69f99",
+      "metadata": {
+        "id": "23d69f99"
+      },
+      "source": [
+        "# Pixtral (12B) Vision Model"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "b842f675",
+      "metadata": {
+        "id": "b842f675"
+      },
+      "source": [
+        "## Description\n",
+        "This notebook demonstrates how to use the **Pixtral (12B) Vision Model** vision-language model for image input and text generation tasks."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Pixtral_12B_Vision_Model.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "MilYelUMlD2z"
+      },
+      "id": "MilYelUMlD2z"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "557dba1c",
+      "metadata": {
+        "id": "557dba1c"
+      },
+      "source": [
+        "## Dependencies\n",
+        "```python\n",
+        "!pip install transformers accelerate torch torchvision\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "2b864df8",
+      "metadata": {
+        "id": "2b864df8"
+      },
+      "source": [
+        "## Tools\n",
+        "- 🤗 Transformers\n",
+        "- PyTorch\n",
+        "- Vision Model APIs"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "1b050001",
+      "metadata": {
+        "id": "1b050001"
+      },
+      "source": [
+        "## YAML Prompt\n",
+        "```yaml\n",
+        "mode: vision\n",
+        "model: Pixtral (12B) Vision Model\n",
+        "tasks:\n",
+        "  - image captioning\n",
+        "  - visual question answering\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "44ce2c02",
+      "metadata": {
+        "id": "44ce2c02"
+      },
+      "source": [
+        "## Main\n",
+        "Below is the simplified main execution to load the model and run basic inference."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "c996306e",
+      "metadata": {
+        "id": "c996306e"
+      },
+      "outputs": [],
+      "source": [
+        "%%capture\n",
+        "import os\n",
+        "if \"COLAB_\" not in \"\".join(os.environ.keys()):\n",
+        "    !pip install unsloth\n",
+        "else:\n",
+        "    # Do this only in Colab notebooks! Otherwise use pip install unsloth\n",
+        "    !pip install --no-deps bitsandbytes accelerate xformers==0.0.29.post3 peft trl triton cut_cross_entropy unsloth_zoo\n",
+        "    !pip install sentencepiece protobuf \"datasets>=3.4.1\" huggingface_hub hf_transfer\n",
+        "    !pip install --no-deps unsloth"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "30147f7c",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 543,
+          "referenced_widgets": [
+            "8a0ce0af1025429cb3cfcc5b973a4af0",
+            "6fe6ac6a53f745c5a2736e1b6cb01ff7",
+            "8d93c4b87f69485e8e97192a8431113f",
+            "08af812d04fe481fa84e85a6a591c506",
+            "257fe2a05570417882a606b304087a21",
+            "6d8e442e771d4955a29a360dee525119",
+            "00a911ef0d7f4a6d8b1b4f972b0b4d7c",
+            "766a605b2c5a463d977b8fefb554fea5",
+            "54ae26be14bc4fb28933af46f45e023a",
+            "360f3db84aac4728861b74b5a37adcaa",
+            "a2ae977cf14c461e9fa0cbc5c27e7186",
+            "d401dcde88274752b4f0786f834527d9",
+            "5d10ef16c7154f5392519da3ff6a2f0d",
+            "d8358c67c0b0415098b3e4a4e7ad0cbb",
+            "4f593d75532d4087bafc02d6ad2b4f79",
+            "a519350329d04d5096ccb605c9ffd623",
+            "9cd924df198145ed93d9df07249236cb",
+            "a01af94f415b4ed18186fa099c3ecbc3",
+            "27cd2e02e78d4ef8a52ba73a9e214120",
+            "841f197cba3f455d8fe9a9dafac992d7",
+            "d6507d692f9743e6b3eed08df94e2a56",
+            "c3438845441142fa92fec3acd21b3955",
+            "eb64d7acd375493098e1f7c30e7f2781",
+            "ad01bece3f444f1382988a65833bebf7",
+            "281b9b2311e5460aa4df9bbe9f8e22f0",
+            "34afc68bfe9d4e47ad73b31a34a74b32",
+            "23c9c94b98f141e8827c37cd26b6138e",
+            "d2b5a8a0c51c4d04aa1da73a56c2bcd3",
+            "4587ddab1af04157b8cba09f780ce9b0",
+            "aab82ec73c0b42fb928fbc74fc44c168",
+            "45f90f73051b4f898666ecd14f2818f0",
+            "6f96f236961344418015be410aedc57c",
+            "6105cefd94bb4a07b9123e461e857c9c",
+            "d4d3c9f1f54746d8895b66b6d2888ee2",
+            "eaa7a98acf704791a5c3ca37232c94b9",
+            "7b1f0430e15a476eb4b59fd5ddb0f9ac",
+            "481ce6bb0bf74e9592b5a4ef6cbc6d33",
+            "7a35df90dc40472eb0862deb368da362",
+            "d4bda244da214ee497b82608944bce6e",
+            "2cd8ad1cedb0484fa4c5d47b7b25971c",
+            "68c0b7aee1464e78b1bbd420f540fcf4",
+            "1fd521ec517348aa9d8dd73757619da4",
+            "9c967803321d4ca39b663165c2ce1953",
+            "c39f8980d63a4a5ab17f031e06b03f67",
+            "b60b17cb67044a82b173f94d781d5174",
+            "9078d37b65424033b551caf1ae410d2f",
+            "e5d3e2d9fb7e4f8fbfa84ba66ea0a81c",
+            "ae50ac57cecb48cb917a2a3ddf3312d0",
+            "2a85749ab4144e01bb640cd90a1a8697",
+            "96ce0742a2a247dd84d85ad7b5286f19",
+            "b67a770e477e40b3a7ca8f4570cb2129",
+            "79dfa298db314ce2874e86abd8e6b1ba",
+            "38700d9515ca4ee694010fd7914e0d18",
+            "7819396bd89b4917beac22678b04b9ec",
+            "bdbd0b350dbd49e9b463993a3d5c0e92",
+            "8f1faff5468a46d4a725d095ae31ea3c",
+            "4a704f4b14614fe6934420a895d9d1a0",
+            "e67dfbfbba4d4f4298b7ef302830ab40",
+            "9b6572529f65495693d840718d37e744",
+            "f06f07a6a1b94dfa9091651c9e95f6f4",
+            "c3bea8260e5f493d8a470ff98f025324",
+            "60f44f8bb72645eba40d9320d9d6e447",
+            "47905056428d4404b73049b3cc437a5a",
+            "5edec95909a6434ebf0bfd8a60f5887e",
+            "c9900bd2f3374f858680f5a40efa70a0",
+            "003f8dc6323b40d29b4f827e14108b20",
+            "1ef7d525ad2b4a57ae1118a0c3908b1a",
+            "7630787d9003423c81eac646fb88edc6",
+            "f41ca30bce18404b953b97548251b556",
+            "371f6292472d4befb3d8fcfcca290fed",
+            "4334bb17edbd4b279287ea9723a62a3c",
+            "b3114bb6194149989d1fa63011299251",
+            "4827624c03d848bbb473fe94b2d21c22",
+            "3047608c78ef465199d52959a425c5c0",
+            "8fb84b1203cb43b5803c11b4a77c0d42",
+            "426281caaa3f47e393ea8b001123cb22",
+            "6381166be9444c0a9b98186e978e94cb",
+            "fe28321b0bf04f58b0d63e7dc617e3ed",
+            "77335dfe86c34eb08f9085b6b839b8c7",
+            "49e7c650e0cc4b449ddd2d50f989d541",
+            "c502fd2bf724410dbcf1528c79f220ce",
+            "1b8d5199f7144981b5e9ae71f8ea8199",
+            "2fa87811a24f4b6e9695d7b80817a422",
+            "25133a67be974e6293bcdb3507529406",
+            "fdbff4f0bd6b4989b72f8252b5faea16",
+            "189edd39642b421f879956bea51d853e",
+            "740ffbd464f041a283b9b2d9396b180c",
+            "f5661357cbc144c5947529a979360114",
+            "ec91a47eece543a495f36ed0e051d637",
+            "443e64f8935544a0b4c159794fd8b272",
+            "7dd0095387264941a52e8587ebd0fea1",
+            "363406f847db494f972011724185b02a",
+            "c21d3532550248b8a927756a510a2770",
+            "82f03edadab54f949f92dd0c4a60bd55",
+            "d2488adbea5344329da2b447382139f5",
+            "fed393eac57747fabee1c2b743828ef8",
+            "b1d82fdb948b4c5bbee4d327a0f41a21",
+            "cccdb395613a4256950b7c3d740736fd",
+            "24c7bdd72f3546c882a7a7c78de5925f",
+            "db8a5ea365094bc4a87e77d059b4d0d0",
+            "2f494500c50a42f0ba3589743048cdd8",
+            "3ec4018cd5e54ba998a0f143f62407cc",
+            "f3a87c6d2986429cb40979782b38e712",
+            "4f7fb67e816b44598022407aacf71f19",
+            "be9935d016a34ac5a272b51261053f13",
+            "24540fc3ff1944edaa61e6037bec31c8",
+            "713338a99be84b54877f8e35c953d8ba",
+            "5586a425c639474ba5d6c0bd6d93328a",
+            "088d87f186cc4a5d95745d8317cca20e",
+            "acdecdef8bd14e44bcd36374b944b562",
+            "1c7c3bfb5ae4472c9bb6e340c012d302",
+            "41ae4c0601084403ba26a287f485ebeb",
+            "916e61f972f6439b8135a70100753917",
+            "36c3f462830247d7a219f1722cae8791",
+            "69ae06a22fa9488598ed89641cc135b6",
+            "c5ca864cc0144ddeb72dcbf1f8303609",
+            "728f786930a14c7a91cb4ff1f97a24ee",
+            "71704d8853ed40c4a55fa06669393ec9",
+            "af5c196783e349888eaefc227beadbf0",
+            "d3aee68f69ad4e5d81a087ec791cc9b1",
+            "1ec887eb8dac43ba9922e1f9f2111231",
+            "aa6b598305944d5ab2e2b4afaea8063c",
+            "a132d68b4ae94f64b80893b9149f7fd8",
+            "ec8f420a6f7d413bb528a1661aa3a0e8",
+            "b70265a81e9a49109c18eaad44135562",
+            "67a1b2e8e39b48849441368c33e16be4",
+            "e2ec06c317034b5681d83347b530362f",
+            "97bcd619eea74ed99650a1d8fed1f406",
+            "14bc6db53fa449049a6a63b422ee54bc",
+            "70f9cecf2dca4a3badc609b10ffcc8ec",
+            "cc082399aef94823b67d6e9c33d468e5",
+            "b4fb273306e941ebaa529e781361acfb"
+          ]
+        },
+        "id": "30147f7c",
+        "outputId": "8b36524b-d22e-43f2-a6e0-cc4209d76736"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🦥 Unsloth: Will patch your computer to enable 2x faster free finetuning.\n",
+            "🦥 Unsloth Zoo will now patch everything to make training faster!\n",
+            "==((====))==  Unsloth 2024.11.9: Fast Pixtral vision patching. Transformers = 4.46.2.\n",
+            "   \\\\   /|    GPU: Tesla T4. Max memory: 14.748 GB. Platform = Linux.\n",
+            "O^O/ \\_/ \\    Pytorch: 2.5.1+cu121. CUDA = 7.5. CUDA Toolkit = 12.1.\n",
+            "\\        /    Bfloat16 = FALSE. FA [Xformers = 0.0.28.post3. FA2 = False]\n",
+            " \"-____-\"     Free Apache license: http://github.com/unslothai/unsloth\n",
+            "Unsloth: Fast downloading is enabled - ignore downloading bars which are red colored!\n"
+          ]
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "8a0ce0af1025429cb3cfcc5b973a4af0",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model.safetensors.index.json:   0%|          | 0.00/316k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "d401dcde88274752b4f0786f834527d9",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Downloading shards:   0%|          | 0/2 [00:00<?, ?it/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "eb64d7acd375493098e1f7c30e7f2781",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model-00001-of-00002.safetensors:   0%|          | 0.00/4.97G [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "d4d3c9f1f54746d8895b66b6d2888ee2",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model-00002-of-00002.safetensors:   0%|          | 0.00/3.57G [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "b60b17cb67044a82b173f94d781d5174",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Loading checkpoint shards:   0%|          | 0/2 [00:00<?, ?it/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "8f1faff5468a46d4a725d095ae31ea3c",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "generation_config.json:   0%|          | 0.00/133 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "1ef7d525ad2b4a57ae1118a0c3908b1a",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "processor_config.json:   0%|          | 0.00/162 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "fe28321b0bf04f58b0d63e7dc617e3ed",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "chat_template.json:   0%|          | 0.00/1.59k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "ec91a47eece543a495f36ed0e051d637",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "preprocessor_config.json:   0%|          | 0.00/483 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "db8a5ea365094bc4a87e77d059b4d0d0",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer_config.json:   0%|          | 0.00/177k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "1c7c3bfb5ae4472c9bb6e340c012d302",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer.json:   0%|          | 0.00/17.1M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "aa6b598305944d5ab2e2b4afaea8063c",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "special_tokens_map.json:   0%|          | 0.00/552 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        }
+      ],
+      "source": [
+        "from unsloth import FastVisionModel # FastLanguageModel for LLMs\n",
+        "import torch\n",
+        "\n",
+        "# 4bit pre quantized models we support for 4x faster downloading + no OOMs.\n",
+        "fourbit_models = [\n",
+        "    \"unsloth/Llama-3.2-11B-Vision-Instruct-bnb-4bit\", # Llama 3.2 vision support\n",
+        "    \"unsloth/Llama-3.2-11B-Vision-bnb-4bit\",\n",
+        "    \"unsloth/Llama-3.2-90B-Vision-Instruct-bnb-4bit\", # Can fit in a 80GB card!\n",
+        "    \"unsloth/Llama-3.2-90B-Vision-bnb-4bit\",\n",
+        "\n",
+        "    \"unsloth/Pixtral-12B-2409-bnb-4bit\",              # Pixtral fits in 16GB!\n",
+        "    \"unsloth/Pixtral-12B-Base-2409-bnb-4bit\",         # Pixtral base model\n",
+        "\n",
+        "    \"unsloth/Qwen2-VL-2B-Instruct-bnb-4bit\",          # Qwen2 VL support\n",
+        "    \"unsloth/Qwen2-VL-7B-Instruct-bnb-4bit\",\n",
+        "    \"unsloth/Qwen2-VL-72B-Instruct-bnb-4bit\",\n",
+        "\n",
+        "    \"unsloth/llava-v1.6-mistral-7b-hf-bnb-4bit\",      # Any Llava variant works!\n",
+        "    \"unsloth/llava-1.5-7b-hf-bnb-4bit\",\n",
+        "] # More models at https://huggingface.co/unsloth\n",
+        "\n",
+        "model, tokenizer = FastVisionModel.from_pretrained(\n",
+        "    \"unsloth/Pixtral-12B-2409\",\n",
+        "    load_in_4bit = True, # Use 4bit to reduce memory use. False for 16bit LoRA.\n",
+        "    use_gradient_checkpointing = \"unsloth\", # True or \"unsloth\" for long context\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "1c0cd2b0",
+      "metadata": {
+        "id": "1c0cd2b0"
+      },
+      "outputs": [],
+      "source": [
+        "model = FastVisionModel.get_peft_model(\n",
+        "    model,\n",
+        "    # We do NOT finetune vision & attention layers since Pixtral uses more memory!\n",
+        "    finetune_vision_layers     = True, # False if not finetuning vision layers\n",
+        "    finetune_language_layers   = True,  # False if not finetuning language layers\n",
+        "    finetune_attention_modules = False, # False if not finetuning attention layers\n",
+        "    finetune_mlp_modules       = True,  # False if not finetuning MLP layers\n",
+        "\n",
+        "    r = 8,           # The larger, the higher the accuracy, but might overfit\n",
+        "    lora_alpha = 8,  # Recommended alpha == r at least\n",
+        "    lora_dropout = 0,\n",
+        "    bias = \"none\",\n",
+        "    random_state = 3407,\n",
+        "    use_rslora = False,  # We support rank stabilized LoRA\n",
+        "    loftq_config = None, # And LoftQ\n",
+        "    # target_modules = \"all-linear\", # Optional now! Can specify a list if needed\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "440fa965",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 177,
+          "referenced_widgets": [
+            "453a07e03ee94f528890205d14511da6",
+            "309ebf7d588244a3ba28d29d56edbc2a",
+            "dcc1ef7862e240eebefd5985202ef3b2",
+            "0ef444f87c454640aa657c4c187e94f5",
+            "d291b920db4b48fb9f3e89bc916db8c8",
+            "3570f6aec06d461e9259a2bd60c6a16a",
+            "3ed61e45df71452f844c1f39ea5c9dcf",
+            "2b6b7fd9d5204198953a0f6fe8333d57",
+            "e74c5834491b46d5b065665533671407",
+            "fc9a5b89da594730a09a6bb4c3adb879",
+            "22b0b4a4585148b2b6f75ecd86ebded3",
+            "94a24760f2e3453aa615caf5300cd9da",
+            "52e83aca1e544ffaabc57d149dd0415e",
+            "b2e5c457d6a246cabcd71459cf2cee8d",
+            "b8b672b219c347c4a636c1a43f73fda9",
+            "76e1e2ae0a2944de8eff1c8eea325164",
+            "6795172d2bb54298ae68cb481cf84822",
+            "c09587db5ef3473490c1638c359ca945",
+            "58e75f4e6c3e4ca9a6e6bc6e9865de67",
+            "0fd6dae874a344678bac899cca709c3b",
+            "da76163d3abd4ab9b4a7d02efdb15f00",
+            "dc79ba710e9f4485a6f51d48963c6666",
+            "9f45d79473ef446ca8f81c08ec82edda",
+            "c381bddbbb6a4bbd99f90546dfb1867c",
+            "9ca49f19650848dfbade44d036e166d2",
+            "348f47ec75d44295b089a0071b747010",
+            "d7601975774c43e4af927247019c2dab",
+            "46513f9858a8403b93fc2fb1a0ea8779",
+            "3d378819a2084a7797e8e8debf9bf815",
+            "d2080299e24d40cbaecf75aead507415",
+            "7d64c5f1dac64a49b794e723a5c77620",
+            "08acfb1a242542d9990577d62118185f",
+            "6cdfb3c8a1bc45b1ad34dd77feb4d4fe",
+            "7856e0634b86431382280c591b6f740f",
+            "cac2e90d5e3449978089a9fe4690cd93",
+            "01838b1fb6da41e6bee2c632f9873b6e",
+            "12b8a9e56ff646d4ba7032405183daf3",
+            "2ef9f2c39bdf4893a4016e0880445e0f",
+            "d358e59f602245fc96651c018347c448",
+            "b7aeadfe764542e3ae4dd47e2664e410",
+            "10523b38a16b4a48b095860653d34a6c",
+            "ac9cb94447274626afc8580dd17260ad",
+            "c6bc57fe79f045fabe94281cbe1bd09a",
+            "05e888e211274b269794cde826c7d1f9",
+            "6b2c1870e4ae44aba0326535f75c6858",
+            "c3997e6823fb40349d9c92e32ce28045",
+            "a4cf715dfb534feb814d426c2cac2b8e",
+            "f57ddd4b011e428e82a86317d15779aa",
+            "be6e313fb0b045adb8d8da6702081a0d",
+            "dc07e208294f47d8b122afc8d415e3c8",
+            "c2d88ba605ab4c2ab3f9686c5b65b8e8",
+            "625723d424624ab2ac641b2c369da9e8",
+            "35f6d9677b67401699e094040eaf8bd2",
+            "ed9c8e6297654278bb360c13134920cb",
+            "39d1ac1f430544c087b69e3bdb6ab5d6"
+          ]
+        },
+        "id": "440fa965",
+        "outputId": "54b0ee23-5573-407a-d22f-cda8378461da"
+      },
+      "outputs": [
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "453a07e03ee94f528890205d14511da6",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "README.md:   0%|          | 0.00/728 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "94a24760f2e3453aa615caf5300cd9da",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "train-00000-of-00001.parquet:   0%|          | 0.00/357M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "9f45d79473ef446ca8f81c08ec82edda",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "test-00000-of-00001.parquet:   0%|          | 0.00/57.6M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "7856e0634b86431382280c591b6f740f",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Generating train split:   0%|          | 0/8552 [00:00<?, ? examples/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "6b2c1870e4ae44aba0326535f75c6858",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Generating test split:   0%|          | 0/1364 [00:00<?, ? examples/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        }
+      ],
+      "source": [
+        "from datasets import load_dataset\n",
+        "dataset = load_dataset(\"unsloth/llava-instruct-mix-vsft-mini\", split = \"train\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "b9670b46",
+      "metadata": {
+        "id": "b9670b46"
+      },
+      "source": [
+        "## Output\n",
+        "This shows a basic output example of the vision-language model."
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Predictive_Maintenance_Multi_Agent_Workflow.ipynb

@@ -0,0 +1,401 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "l7oSysosTfJj"
+      },
+      "source": [
+        "# Predictive Maintenance Workflow using PraisonAIAgents\n",
+        "\n",
+        "This notebook demonstrates how to build a predictive maintenance workflow using multiple AI agents."
+      ],
+      "id": "l7oSysosTfJj"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Predictive_Maintenance_Multi-Agent_Workflow.ipynb)"
+      ],
+      "metadata": {
+        "id": "LH0_JjO7Y1G2"
+      },
+      "id": "LH0_JjO7Y1G2"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Dependencies"
+      ],
+      "metadata": {
+        "id": "ei-yNZSKXgtJ"
+      },
+      "id": "ei-yNZSKXgtJ"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "fnkuN8sTTfJq"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install praisonaiagents"
+      ],
+      "id": "fnkuN8sTTfJq"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Set your OpenAI API key"
+      ],
+      "metadata": {
+        "id": "7PUSTQHwX5ia"
+      },
+      "id": "7PUSTQHwX5ia"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 2,
+      "metadata": {
+        "id": "33HivD-LTfJu"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "os.environ['OPENAI_API_KEY'] = 'enter your api key'"
+      ],
+      "id": "33HivD-LTfJu"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Import required modules"
+      ],
+      "metadata": {
+        "id": "D6we7t4nYESB"
+      },
+      "id": "D6we7t4nYESB"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "03z7Pi22TfJw"
+      },
+      "outputs": [],
+      "source": [
+        "from praisonaiagents import Agent, Task, PraisonAIAgents\n",
+        "import time\n",
+        "from typing import Dict, List\n",
+        "import asyncio"
+      ],
+      "id": "03z7Pi22TfJw"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Define helper functions"
+      ],
+      "metadata": {
+        "id": "TzZt0jbjYGgw"
+      },
+      "id": "TzZt0jbjYGgw"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "2oMzDsp3TfJw"
+      },
+      "outputs": [],
+      "source": [
+        "\n",
+        "def collect_sensor_data():\n",
+        "    return {\n",
+        "        \"temperature\": 75 + (int(time.time()) % 20),\n",
+        "        \"vibration\": 0.5 + (int(time.time()) % 10) / 10,\n",
+        "        \"pressure\": 100 + (int(time.time()) % 50),\n",
+        "        \"noise_level\": 60 + (int(time.time()) % 30)\n",
+        "    }\n",
+        "\n",
+        "def analyze_performance():\n",
+        "    return {\n",
+        "        \"efficiency\": 0.8 + (int(time.time()) % 20) / 100,\n",
+        "        \"uptime\": 0.95 + (int(time.time()) % 5) / 100,\n",
+        "        \"output_quality\": 0.9 + (int(time.time()) % 10) / 100\n",
+        "    }\n",
+        "\n",
+        "def detect_anomalies(sensor_data: Dict, performance: Dict):\n",
+        "    anomalies = []\n",
+        "    if sensor_data[\"temperature\"] > 90:\n",
+        "        anomalies.append({\"type\": \"temperature_high\", \"severity\": \"critical\"})\n",
+        "    if sensor_data[\"vibration\"] > 1.2:\n",
+        "        anomalies.append({\"type\": \"vibration_excess\", \"severity\": \"warning\"})\n",
+        "    if performance[\"efficiency\"] < 0.85:\n",
+        "        anomalies.append({\"type\": \"efficiency_low\", \"severity\": \"warning\"})\n",
+        "    return anomalies\n",
+        "\n",
+        "def predict_failures(anomalies: List[Dict]):\n",
+        "    predictions = []\n",
+        "    severity_scores = {\"critical\": 0.9, \"warning\": 0.6}\n",
+        "    for anomaly in anomalies:\n",
+        "        predictions.append({\n",
+        "            \"component\": anomaly[\"type\"].split(\"_\")[0],\n",
+        "            \"probability\": severity_scores[anomaly[\"severity\"]],\n",
+        "            \"timeframe\": \"24_hours\" if anomaly[\"severity\"] == \"critical\" else \"7_days\"\n",
+        "        })\n",
+        "    return predictions\n",
+        "\n",
+        "def schedule_maintenance(predictions: List[Dict]):\n",
+        "    schedule = []\n",
+        "    for pred in predictions:\n",
+        "        schedule.append({\n",
+        "            \"component\": pred[\"component\"],\n",
+        "            \"priority\": \"immediate\" if pred[\"timeframe\"] == \"24_hours\" else \"planned\",\n",
+        "            \"estimated_duration\": \"2_hours\",\n",
+        "            \"required_parts\": [\"replacement_\" + pred[\"component\"]]\n",
+        "        })\n",
+        "    return schedule"
+      ],
+      "id": "2oMzDsp3TfJw"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Define agents and tasks"
+      ],
+      "metadata": {
+        "id": "-7qMHyY5YIph"
+      },
+      "id": "-7qMHyY5YIph"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "4ZYbYzjNTfJy"
+      },
+      "outputs": [],
+      "source": [
+        "\n",
+        "sensor_monitor = Agent(\"Sensor Monitor\", \"Data Collection\", \"Collect sensor data\", \"Monitor and collect sensor readings\", [collect_sensor_data])\n",
+        "performance_analyzer = Agent(\"Performance Analyzer\", \"Performance Analysis\", \"Analyze equipment performance\", \"Analyze operational metrics\", [analyze_performance])\n",
+        "anomaly_detector = Agent(\"Anomaly Detector\", \"Anomaly Detection\", \"Detect operational anomalies\", \"Identify abnormal patterns\", [detect_anomalies])\n",
+        "failure_predictor = Agent(\"Failure Predictor\", \"Failure Prediction\", \"Predict potential failures\", \"Predict equipment failures\", [predict_failures])\n",
+        "maintenance_scheduler = Agent(\"Maintenance Scheduler\", \"Maintenance Planning\", \"Schedule maintenance activities\", \"Plan and schedule maintenance\", [schedule_maintenance])\n",
+        "\n",
+        "sensor_task = Task(\"collect_data\", \"Collect sensor data\", \"Sensor readings\", sensor_monitor, is_start=True, next_tasks=[\"analyze_performance\"], async_execution=True)\n",
+        "performance_task = Task(\"analyze_performance\", \"Analyze performance metrics\", \"Performance analysis\", performance_analyzer, next_tasks=[\"detect_anomalies\"], async_execution=True)\n",
+        "anomaly_task = Task(\"detect_anomalies\", \"Detect operational anomalies\", \"Detected anomalies\", anomaly_detector, next_tasks=[\"predict_failures\"], context=[sensor_task, performance_task])\n",
+        "prediction_task = Task(\"predict_failures\", \"Predict potential failures\", \"Failure predictions\", failure_predictor, next_tasks=[\"schedule_maintenance\"], task_type=\"decision\", condition={\"critical\": [\"schedule_maintenance\"], \"warning\": [\"schedule_maintenance\"], \"normal\": \"\"})\n",
+        "scheduling_task = Task(\"schedule_maintenance\", \"Schedule maintenance activities\", \"Maintenance schedule\", maintenance_scheduler, context=[prediction_task])"
+      ],
+      "id": "4ZYbYzjNTfJy"
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "# Create and run the workflow"
+      ],
+      "metadata": {
+        "id": "XOdIxJKiYKuD"
+      },
+      "id": "XOdIxJKiYKuD"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "KYu_YTVDTfJz"
+      },
+      "outputs": [],
+      "source": [
+        "\n",
+        "workflow = PraisonAIAgents(\n",
+        "    agents=[sensor_monitor, performance_analyzer, anomaly_detector, failure_predictor, maintenance_scheduler],\n",
+        "    tasks=[sensor_task, performance_task, anomaly_task, prediction_task, scheduling_task],\n",
+        "    process=\"workflow\",\n",
+        "    verbose=True\n",
+        ")\n",
+        "\n",
+        "async def main():\n",
+        "    print(\"\\nStarting Predictive Maintenance Workflow...\")\n",
+        "    print(\"=\" * 50)\n",
+        "    results = await workflow.astart()\n",
+        "    print(\"\\nMaintenance Planning Results:\")\n",
+        "    print(\"=\" * 50)\n",
+        "    for task_id, result in results[\"task_results\"].items():\n",
+        "        if result:\n",
+        "            print(f\"\\nTask: {task_id}\\nResult: {result.raw}\\n{'-'*50}\")\n",
+        "\n",
+        "await main()"
+      ],
+      "id": "KYu_YTVDTfJz"
+    },
+    {
+      "cell_type": "code",
+      "source": [
+        "print(\"\"\"\n",
+        "[Starting Predictive Maintenance Workflow...\n",
+        "==================================================\n",
+        "╭─ Agent Info ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
+        "│                                                                                                                                              │\n",
+        "│  👤 Agent: Sensor Monitor                                                                                                                    │\n",
+        "│  Role: Data Collection                                                                                                                       │\n",
+        "│  Tools: collect_sensor_data                                                                                                                  │\n",
+        "│                                                                                                                                              │\n",
+        "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+        "\n",
+        "╭─ Agent Info ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
+        "│                                                                                                                                              │\n",
+        "│  👤 Agent: Performance Analyzer                                                                                                              │\n",
+        "│  Role: Performance Analysis                                                                                                                  │\n",
+        "│  Tools: analyze_performance                                                                                                                  │\n",
+        "│                                                                                                                                              │\n",
+        "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+        "\n",
+        "[20:01:26] INFO     [20:01:26] process.py:429 INFO Task schedule_maintenance has no next tasks, ending workflow                   process.py:429\n",
+        "\n",
+        "Maintenance Planning Results:\n",
+        "==================================================\n",
+        "\n",
+        "Task: 0\n",
+        "Result: The sensor readings you have collected are as follows:\n",
+        "\n",
+        "- **Temperature**: 86°F\n",
+        "- **Vibration**: 0.6 (units not specified, but typically measured in g-forces or mm/s)\n",
+        "- **Pressure**: 101 (units not specified, but typically measured in kPa or psi)\n",
+        "- **Noise Level**: 81 dB\n",
+        "\n",
+        "Here's a brief analysis of these readings:\n",
+        "\n",
+        "1. **Temperature**: At 86°F, the temperature is relatively warm. Depending on the context (e.g., industrial equipment, environmental monitoring), this could be within normal operating conditions or might require cooling measures if it's above the optimal range.\n",
+        "\n",
+        "2. **Vibration**: A vibration level of 0.6 is generally low, but the significance depends on the type of equipment being monitored. For precision machinery, even small vibrations can be critical, whereas for more robust equipment, this might be negligible.\n",
+        "\n",
+        "3. **Pressure**: A pressure reading of 101 is often within normal ranges for many systems, but without specific units or context, it's hard to determine if this is optimal or requires adjustment.\n",
+        "\n",
+        "4. **Noise Level**: At 81 dB, the noise level is relatively high. Prolonged exposure to noise levels above 85 dB can be harmful to hearing, so if this is a workplace environment, it might be necessary to implement noise reduction measures or provide hearing protection.\n",
+        "\n",
+        "Overall, these readings should be compared against the specific operational thresholds and safety standards relevant to the equipment or environment being monitored. If any values are outside of acceptable ranges, further investigation or corrective actions may be needed.\n",
+        "--------------------------------------------------\n",
+        "\n",
+        "Task: 1\n",
+        "Result: Based on the provided operational metrics, here's an analysis of the equipment performance:\n",
+        "\n",
+        "1. **Efficiency (94%)**:\n",
+        "   - The equipment is operating at a high efficiency level, with 94% of the input being effectively converted into useful output. This suggests\n",
+        "that the equipment is well-maintained and optimized for performance. However, there is still a 6% margin for improvement, which could be addressed by identifying and minimizing any inefficiencies in the process.\n",
+        "\n",
+        "2. **Uptime (99%)**:\n",
+        "   - The equipment has an excellent uptime rate of 99%, indicating that it is available and operational almost all the time. This is a strong indicator of reliability and suggests that downtime due to maintenance or unexpected failures is minimal. Maintaining this level of uptime should\n",
+        "be a priority, as it directly impacts productivity and operational continuity.\n",
+        "\n",
+        "3. **Output Quality (94%)**:\n",
+        "   - The output quality is also at 94%, which is a positive sign that the equipment is producing high-quality products or results. However, similar to efficiency, there is room for improvement. Efforts could be made to identify any factors that might be affecting quality, such as calibration issues, material inconsistencies, or process deviations.\n",
+        "\n",
+        "**Overall Assessment**:\n",
+        "The equipment is performing well across all key metrics, with high efficiency, uptime, and output quality. To further enhance performance, focus should be placed on fine-tuning processes to close the small gaps in efficiency and quality. Regular maintenance, monitoring, and process optimization can help sustain and potentially improve these metrics.\n",
+        "--------------------------------------------------]\n",
+        "\"\"\")"
+      ],
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/"
+        },
+        "id": "4hrEJ5S6XpJ7",
+        "outputId": "899e677d-19d5-4e0a-d9ab-ebc945aeee1b"
+      },
+      "id": "4hrEJ5S6XpJ7",
+      "execution_count": 4,
+      "outputs": [
+        {
+          "output_type": "stream",
+          "name": "stdout",
+          "text": [
+            "\n",
+            "[Starting Predictive Maintenance Workflow...\n",
+            "==================================================\n",
+            "╭─ Agent Info ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
+            "│                                                                                                                                              │\n",
+            "│  👤 Agent: Sensor Monitor                                                                                                                    │\n",
+            "│  Role: Data Collection                                                                                                                       │\n",
+            "│  Tools: collect_sensor_data                                                                                                                  │\n",
+            "│                                                                                                                                              │\n",
+            "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+            "\n",
+            "╭─ Agent Info ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
+            "│                                                                                                                                              │\n",
+            "│  👤 Agent: Performance Analyzer                                                                                                              │\n",
+            "│  Role: Performance Analysis                                                                                                                  │\n",
+            "│  Tools: analyze_performance                                                                                                                  │\n",
+            "│                                                                                                                                              │\n",
+            "╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
+            "\n",
+            "[20:01:26] INFO     [20:01:26] process.py:429 INFO Task schedule_maintenance has no next tasks, ending workflow                   process.py:429\n",
+            "\n",
+            "Maintenance Planning Results:\n",
+            "==================================================\n",
+            "\n",
+            "Task: 0\n",
+            "Result: The sensor readings you have collected are as follows:\n",
+            "\n",
+            "- **Temperature**: 86°F\n",
+            "- **Vibration**: 0.6 (units not specified, but typically measured in g-forces or mm/s)\n",
+            "- **Pressure**: 101 (units not specified, but typically measured in kPa or psi)\n",
+            "- **Noise Level**: 81 dB\n",
+            "\n",
+            "Here's a brief analysis of these readings:\n",
+            "\n",
+            "1. **Temperature**: At 86°F, the temperature is relatively warm. Depending on the context (e.g., industrial equipment, environmental monitoring), this could be within normal operating conditions or might require cooling measures if it's above the optimal range.\n",
+            "\n",
+            "2. **Vibration**: A vibration level of 0.6 is generally low, but the significance depends on the type of equipment being monitored. For precision machinery, even small vibrations can be critical, whereas for more robust equipment, this might be negligible.\n",
+            "\n",
+            "3. **Pressure**: A pressure reading of 101 is often within normal ranges for many systems, but without specific units or context, it's hard to determine if this is optimal or requires adjustment.\n",
+            "\n",
+            "4. **Noise Level**: At 81 dB, the noise level is relatively high. Prolonged exposure to noise levels above 85 dB can be harmful to hearing, so if this is a workplace environment, it might be necessary to implement noise reduction measures or provide hearing protection.\n",
+            "\n",
+            "Overall, these readings should be compared against the specific operational thresholds and safety standards relevant to the equipment or environment being monitored. If any values are outside of acceptable ranges, further investigation or corrective actions may be needed.\n",
+            "--------------------------------------------------\n",
+            "\n",
+            "Task: 1\n",
+            "Result: Based on the provided operational metrics, here's an analysis of the equipment performance:\n",
+            "\n",
+            "1. **Efficiency (94%)**:\n",
+            "   - The equipment is operating at a high efficiency level, with 94% of the input being effectively converted into useful output. This suggests \n",
+            "that the equipment is well-maintained and optimized for performance. However, there is still a 6% margin for improvement, which could be addressed by identifying and minimizing any inefficiencies in the process.\n",
+            "\n",
+            "2. **Uptime (99%)**:\n",
+            "   - The equipment has an excellent uptime rate of 99%, indicating that it is available and operational almost all the time. This is a strong indicator of reliability and suggests that downtime due to maintenance or unexpected failures is minimal. Maintaining this level of uptime should \n",
+            "be a priority, as it directly impacts productivity and operational continuity.\n",
+            "\n",
+            "3. **Output Quality (94%)**:\n",
+            "   - The output quality is also at 94%, which is a positive sign that the equipment is producing high-quality products or results. However, similar to efficiency, there is room for improvement. Efforts could be made to identify any factors that might be affecting quality, such as calibration issues, material inconsistencies, or process deviations.\n",
+            "\n",
+            "**Overall Assessment**:\n",
+            "The equipment is performing well across all key metrics, with high efficiency, uptime, and output quality. To further enhance performance, focus should be placed on fine-tuning processes to close the small gaps in efficiency and quality. Regular maintenance, monitoring, and process optimization can help sustain and potentially improve these metrics.\n",
+            "--------------------------------------------------]\n",
+            "\n"
+          ]
+        }
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.9"
+    },
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Qwen2_5_InstructionAgent.ipynb

@@ -0,0 +1,420 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "MLutIRWTYLqq",
+   "metadata": {
+    "id": "MLutIRWTYLqq"
+   },
+   "source": [
+    "# Simple Chat with Qwen2.5 (0.5B) using Hugging Face Transformers"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2LoeTPnYQOW",
+   "metadata": {
+    "id": "a2LoeTPnYQOW"
+   },
+   "source": [
+    "This beginner-friendly notebook demonstrates how to use the Qwen2.5-0.5B-Instruct model for simple chat-based generation. It includes installing dependencies, setting up authentication via Hugging Face token, generating a response using a chat prompt, and displaying the output. The notebook is organized into 5 clean sections for easy understanding."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "WlfJBFucY9gi",
+   "metadata": {
+    "id": "WlfJBFucY9gi"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Qwen2_5_InstructionAgent.ipynb)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "57059c85",
+   "metadata": {
+    "id": "57059c85"
+   },
+   "source": [
+    "# 🔧 Dependencies\n",
+    "Install necessary Python packages."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "1cdaae47",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "1cdaae47",
+    "outputId": "5b140b09-5c16-4849-f370-f8b5abcc127a"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m363.4/363.4 MB\u001b[0m \u001b[31m3.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m13.8/13.8 MB\u001b[0m \u001b[31m58.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m24.6/24.6 MB\u001b[0m \u001b[31m58.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m883.7/883.7 kB\u001b[0m \u001b[31m39.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m664.8/664.8 MB\u001b[0m \u001b[31m1.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m211.5/211.5 MB\u001b[0m \u001b[31m6.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m56.3/56.3 MB\u001b[0m \u001b[31m14.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m127.9/127.9 MB\u001b[0m \u001b[31m9.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m207.5/207.5 MB\u001b[0m \u001b[31m6.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m21.1/21.1 MB\u001b[0m \u001b[31m64.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install transformers --quiet\n",
+    "!pip install accelerate --quiet\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9a65a2fa",
+   "metadata": {
+    "id": "9a65a2fa"
+   },
+   "source": [
+    "# 🛠️ Tools\n",
+    "Import required tools and libraries."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "a8a4bc30",
+   "metadata": {
+    "id": "a8a4bc30"
+   },
+   "outputs": [],
+   "source": [
+    "from transformers import AutoModelForCausalLM, AutoTokenizer\n",
+    "import torch\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1ad2bec4",
+   "metadata": {
+    "id": "1ad2bec4"
+   },
+   "source": [
+    "# ⚙️ YAML Prompt (Token Authentication)\n",
+    "Use Hugging Face token to access the model."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "cd030b94",
+   "metadata": {
+    "id": "cd030b94"
+   },
+   "outputs": [],
+   "source": [
+    "from huggingface_hub import login\n",
+    "login(token=\"Enter your huggingface token\")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b7b1a32d",
+   "metadata": {
+    "id": "b7b1a32d"
+   },
+   "source": [
+    "# 🚀 Main\n",
+    "Load model, prepare prompt and generate response."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "ef73b9ea",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 365,
+     "referenced_widgets": [
+      "a175e2b1fa8c4733afe1ddc78095be58",
+      "f5aaf63d7be04927a33e5cdd3655a003",
+      "7af74b8c184b4e72a2dba769b9caa40f",
+      "22b1c604d91648479cf01198db25a863",
+      "faaeb1c3ab914a6db9ff9b8ea06a440f",
+      "138860a12c6347fba11437eb098d31b5",
+      "d2f5fe459d544fa6adc92debab823ee6",
+      "468e8e7bee5c4198b121ac1aa677153d",
+      "068991c9ac44496bab06ccaa7d030722",
+      "44436151662f41ef81f6a4005add51de",
+      "c774c78c4fce4825872a76bb1e5fde33",
+      "4a7d0a84994c4b628974f631ecb95425",
+      "4adb654ea143456eb3b4244c3030b39f",
+      "d8dbdbc9327f4799a07767b59db59c47",
+      "669ea95c4cb642b580aa176ae2e89f9f",
+      "0bc8529b03364f83adf1110b5c1378ec",
+      "2eb8007145ef4c3caf7f5a9d1fd299e3",
+      "3fa4c368cea4474e8b97a215a20fd8d8",
+      "c750b36cfda24e24ae44a615e426de4b",
+      "e3001e1e3ba74c7ba28702fa5b2a6ed8",
+      "7ac0f7770ad341f68f194705f59ccb27",
+      "f9140e1979c6412993eee36c3f79c0d9",
+      "1ad8e2e2200c4277ba10dd8e9ac83b90",
+      "f193e4fb00b64e86b6f40f10f514739d",
+      "ae3aa36b649a43eb928ed843d2cfc239",
+      "c346fba7badb4c4596f6d6e8fa62224b",
+      "39dd29002d7b46848a29dfeb7405d9f9",
+      "166e17a0be5a4aa8831101eeb07a8645",
+      "60f9503b404945a3b99b5207190474f5",
+      "c480a676b82b48a0aae3dc438fa02ba8",
+      "d97b7d0765e84926b974b2c19156ae20",
+      "b22ca5c038f7419aa8e03f5f9a54accc",
+      "0387fba7ed044fbfb2a78c8d593c7b38",
+      "d6a31c3cf026450088596db5917c3e4a",
+      "4948c0014a95413b81848ae2b4a5fe7e",
+      "377cbca7363a495ea131a1e49a702168",
+      "a5eaad3284034beab09d212765d7ff78",
+      "7ed393b7c7564ab1897446eba875a4da",
+      "66d773bc8c7a40bc95dcba35052675cb",
+      "ad196b0deb2144b083cf8fddcbcfd147",
+      "09a99df922154a528f327bba0a47cb9a",
+      "bc9918e686244eb5b5db78932600a9d6",
+      "4fef54176f4b4a2d8d543a4bf04b416a",
+      "48551fb8dd5140cbb2d792e72b5fbb0d",
+      "955225e4206a4ee5a4284579935db920",
+      "e2faef80a0034c5384daf8ba66c1b75d",
+      "f27c3ec92bc74bacb3f86672b689370a",
+      "ec03dfb79a26474e812606b2664c931b",
+      "4705d2f502a74c3bb8eb8a06c3ba6889",
+      "7d8c99f622c34229894024c9772aed84",
+      "1e6e892b153c4c05b7de806ec674215f",
+      "85ac6a67bb0944b5bb8713fcf302da45",
+      "796771b887ce49119307725382f73bfd",
+      "c686586c431f4c22b0f0c698a9b213b6",
+      "239180fd12624e3a90188270b55ee218",
+      "e04653090c7e454d9c5e520e7f313588",
+      "992c7a4b44aa4feb8e13714fa922d705",
+      "a0a238c78d2842d680be448a2cb20157",
+      "6ab5ebed63674b5e87327a1623eba7f0",
+      "a49887aa0fcd4b91a0d5d978b29c1e0a",
+      "d9b2e4142dd14264b90829a5a4116613",
+      "154b27bb2ba44d10bde5c96929b65cc9",
+      "f0bf6206c31f49f2ad1ce97b99963011",
+      "1762735cfbcf4706b1c0686d3c2926a0",
+      "d5e3440785794f0f9ad4fd0650c2f682",
+      "08019bdd70364fabbc222dca66db0bb1",
+      "6f0b3a92d47c42dd815a670bb1c0f42c",
+      "54554545ad5a4f39b649f3acff6d5cba",
+      "bfd8f4ee8c414349a3695975e79c332e",
+      "332fc944eef14a9c82f71a68a3857dea",
+      "3b0b899fcfae451ba8ec3d8da176fcec",
+      "8383df3f07bd427287ad05726737cc67",
+      "67c267d7d1ec424593775bf8129e8ac9",
+      "85a50e2cb406403988639e6d6ecf9dc1",
+      "7251ed20382c4a60bae8549f68971043",
+      "44fbc377fd6a4c5a910c00dcceb143af",
+      "2d6d273941f04c13af598c53e067aae7"
+     ]
+    },
+    "id": "ef73b9ea",
+    "outputId": "34512fa7-527c-45cb-f3c7-b42d37e74980"
+   },
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/usr/local/lib/python3.11/dist-packages/huggingface_hub/utils/_auth.py:94: UserWarning: \n",
+      "The secret `HF_TOKEN` does not exist in your Colab secrets.\n",
+      "To authenticate with the Hugging Face Hub, create a token in your settings tab (https://huggingface.co/settings/tokens), set it as secret in your Google Colab and restart your session.\n",
+      "You will be able to reuse this secret in all of your notebooks.\n",
+      "Please note that authentication is recommended but still optional to access public models or datasets.\n",
+      "  warnings.warn(\n"
+     ]
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "a175e2b1fa8c4733afe1ddc78095be58",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer_config.json:   0%|          | 0.00/7.30k [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "4a7d0a84994c4b628974f631ecb95425",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "vocab.json:   0%|          | 0.00/2.78M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "1ad8e2e2200c4277ba10dd8e9ac83b90",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "merges.txt:   0%|          | 0.00/1.67M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "d6a31c3cf026450088596db5917c3e4a",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer.json:   0%|          | 0.00/7.03M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "955225e4206a4ee5a4284579935db920",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "config.json:   0%|          | 0.00/659 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "e04653090c7e454d9c5e520e7f313588",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "model.safetensors:   0%|          | 0.00/988M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "6f0b3a92d47c42dd815a670bb1c0f42c",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "generation_config.json:   0%|          | 0.00/242 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "model_name = \"Qwen/Qwen2.5-0.5B-Instruct\"\n",
+    "\n",
+    "tokenizer = AutoTokenizer.from_pretrained(model_name)\n",
+    "model = AutoModelForCausalLM.from_pretrained(\n",
+    "    model_name,\n",
+    "    torch_dtype=\"auto\",\n",
+    "    device_map=\"auto\"\n",
+    ")\n",
+    "\n",
+    "messages = [\n",
+    "    {\"role\": \"system\", \"content\": \"You are Qwen, a helpful assistant.\"},\n",
+    "    {\"role\": \"user\", \"content\": \"Explain photosynthesis in simple words.\"}\n",
+    "]\n",
+    "\n",
+    "text = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)\n",
+    "inputs = tokenizer(text, return_tensors=\"pt\").to(model.device)\n",
+    "\n",
+    "outputs = model.generate(**inputs, max_new_tokens=100)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bf70c765",
+   "metadata": {
+    "id": "bf70c765"
+   },
+   "source": [
+    "# 📤 Output\n",
+    "Print the model response."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "d8f70a7b",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "d8f70a7b",
+    "outputId": "559e9358-c2b7-4410-c1a6-1624640dfeae"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "system\n",
+      "You are Qwen, a helpful assistant.\n",
+      "user\n",
+      "Explain photosynthesis in simple words.\n",
+      "assistant\n",
+      "Photosynthesis is the process by which plants, algae, and some bacteria convert light energy from the sun into chemical energy stored in glucose molecules, using carbon dioxide and water as reactants. This process occurs in chloroplasts within plant cells and involves two main stages: the light-dependent reactions and the light-independent reactions (also known as the Calvin cycle).\n",
+      "\n",
+      "In the light-dependent reactions, light energy is captured by pigments like chlorophyll, causing electrons to be excited and transferred to oxygen through a series\n"
+     ]
+    }
+   ],
+   "source": [
+    "response = tokenizer.decode(outputs[0], skip_special_tokens=True)\n",
+    "print(response)\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/Qwen2_5_VL_7B_Vision_Model.ipynb

@@ -0,0 +1,616 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "a627af7f",
+      "metadata": {
+        "id": "a627af7f"
+      },
+      "source": [
+        "# Qwen2.5-VL (7B) Vision Model"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "6ca9476a",
+      "metadata": {
+        "id": "6ca9476a"
+      },
+      "source": [
+        "## Description\n",
+        "This notebook demonstrates how to use the **Qwen2.5-VL (7B) Vision Model** vision-language model for image input and text generation tasks."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Qwen2_5_VL_7B_Vision_Model.ipynb)"
+      ],
+      "metadata": {
+        "id": "0G9UGDLJk8uV"
+      },
+      "id": "0G9UGDLJk8uV"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "f467ebfe",
+      "metadata": {
+        "id": "f467ebfe"
+      },
+      "source": [
+        "## Dependencies\n",
+        "```python\n",
+        "!pip install transformers accelerate torch torchvision\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "ea76265d",
+      "metadata": {
+        "id": "ea76265d"
+      },
+      "source": [
+        "## Tools\n",
+        "- 🤗 Transformers\n",
+        "- PyTorch\n",
+        "- Vision Model APIs"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "37c57a37",
+      "metadata": {
+        "id": "37c57a37"
+      },
+      "source": [
+        "## YAML Prompt\n",
+        "```yaml\n",
+        "mode: vision\n",
+        "model: Qwen2.5-VL (7B) Vision Model\n",
+        "tasks:\n",
+        "  - image captioning\n",
+        "  - visual question answering\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "7b02bc60",
+      "metadata": {
+        "id": "7b02bc60"
+      },
+      "source": [
+        "## Main\n",
+        "Below is the simplified main execution to load the model and run basic inference."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "6c397c49",
+      "metadata": {
+        "id": "6c397c49"
+      },
+      "outputs": [],
+      "source": [
+        "%%capture\n",
+        "import os\n",
+        "if \"COLAB_\" not in \"\".join(os.environ.keys()):\n",
+        "    !pip install unsloth\n",
+        "else:\n",
+        "    # Do this only in Colab notebooks! Otherwise use pip install unsloth\n",
+        "    !pip install --no-deps bitsandbytes accelerate xformers==0.0.29.post3 peft trl triton cut_cross_entropy unsloth_zoo\n",
+        "    !pip install sentencepiece protobuf \"datasets>=3.4.1\" huggingface_hub hf_transfer\n",
+        "    !pip install --no-deps unsloth"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "18b3d67c",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 513,
+          "referenced_widgets": [
+            "73fc3ac47de840cda7a07297153404d5",
+            "8c8b54f4d34a4b59a5a2513bbc082297",
+            "7bd2abffca3f4193afffd3f1a7c8ff8a",
+            "9ecdc7e0e9c247c59e9eab93455153b8",
+            "84f4e9f7ff6f433bbf13078e43ebbe2a",
+            "7475f8a404624b1b844d8148fabb493b",
+            "9d4aae9ebe594bd6875a5963eb6d77ed",
+            "62b6d78abada429393c499e0479eb56e",
+            "2aecce21a3a04971b4f5c9fd0b059738",
+            "2af66136423c41c6908c5a61c6fa2e5d",
+            "8bf92078d48448848402ede49b1b5182",
+            "78ae8aea29e04420bcfe616061934d98",
+            "e22b1706b6be49af8e31d2c512ccaaf6",
+            "71ac48ba667b4af291df3a33e7643c6c",
+            "7d16f0e5aaec4429a5b8d3c4878ea74a",
+            "a21de38381c241309bc798be604c3bf5",
+            "f26f1de0f3f34010ac0d37d6f3ed74b6",
+            "0af61827920e415daf64cfcb1685ee63",
+            "77a82cf2255b43e088812087af4d8ead",
+            "fad668efab014d28877087f38f3c034e",
+            "e764888263e54f0ba2f603992d678096",
+            "2dccbbbdfbf645b8b5896953f6e8a59b",
+            "45385885a26e42d0b1f52eda382fd6f4",
+            "ccb21e1b7fc14a6ab10689154ab2b94a",
+            "f5c7ab8d65c4418a943a51a401720f67",
+            "f6aaa74bce474abcbc9daf0515b6ffbd",
+            "76bd63e567e94650a82272ca6fd85011",
+            "d3cac12f194a40a187bbba68da36173c",
+            "30439a7bf22f416cbc01cfe87e433e1f",
+            "3265b3490b11426a8aa44d541981a296",
+            "78a31b91439c4c99a07f8f8d8dfb548f",
+            "d2a3a751ac2f491c9e7cb7a4092ab0b6",
+            "b652bb727c1148c4aac9ed751920e3ae",
+            "14e519d5e0834fd9a70a111140f8429a",
+            "41f3770e6d864c1794a1fa93feaf8605",
+            "6aa1670b808b42db894756b904243947",
+            "5757f1d68b8f4571a05486d846127b14",
+            "14cbf1b61170470bbb9d63e31d0ca310",
+            "3324ce12dc3e45fab9984eb83a92eb39",
+            "0ccabea3b39d4b148d420e26b53d3990",
+            "2d65a3b83b524eeaafde8e406e90198f",
+            "d179ef65b2b842d69548302c2f7a31be",
+            "2362fd437a134c30b147df947ee97128",
+            "7f22e31fc7174ff2bfa8bc2624d33dc7",
+            "643db314d8e94feeb9cd8747909eaabe",
+            "b80bb8f2cc92400aa34934978f9bc865",
+            "03f0c63c572249aabb7fb61272af1f1b",
+            "4113f045f9bc440b8dfaed5dfab14c1b",
+            "86a231a75d4a4586a53e4c7e74c63550",
+            "573653d0298246868e5d93069ca0fef5",
+            "c20a42f12c4545dfafdba22267e44d4b",
+            "4b74060c0bb44a35b847e6752b93e463",
+            "7e211233455342d48bd60f6d499b91f5",
+            "520ca077c6854e6fa1e019c0b209eae7",
+            "8f1fce549e494998b13f523bd793d300",
+            "bbb5e6a0a8b64d10802fbf3e89778306",
+            "0cef8128eeba4638bd268f9a1a364427",
+            "399cc918cec24db7b99af9e5f3c5adb4",
+            "3a611a2e00be4da6833172d928802fb9",
+            "0f2f303ae91349e29132055105fcbdec",
+            "17c08a96e04244a995e658eeb5a69699",
+            "9269dee0b0104b22b4043d3661f79350",
+            "a405cbc6d42d4f8f8be7c05f4e34128c",
+            "e702e948bb34481d995c75be223c4e16",
+            "c9949e2b99d14fa0bc4cfc88f42c2afb",
+            "48bbf9b662af47c5b99ebe24a6b70549",
+            "c1af10a57c0a40cf818d0974facdcc36",
+            "e4c1ff933c6e4ef49afbedffcdd99d5c",
+            "3caf3a6d48da403099bcdee89bda6949",
+            "7e0bbe2417e0420db1502390ba7c6c2d",
+            "5522658c84dc47a491f5deb08353b631",
+            "aecb331a01a44c9e92c74840faaf2616",
+            "caadc7751ff847b4a831dd6b2b53e60b",
+            "f0dd55c8f71a4f47a91a7018ab89d092",
+            "7a2d1ba8441e4a368a505c38d2c811ad",
+            "6657bbba902e43429224ed9c426389fe",
+            "a25ba73fb99448a3b46ac3571e2db0be",
+            "c2f518986b724620bbc67f7b6ede6d96",
+            "ed214eea73f54928af276883ddd53b5e",
+            "b241468a1d684fbb820baff6b9f9e362",
+            "0f7da532813445f1be01977cdec364ab",
+            "de7ac823a59d488995aa37bfbcec2e5b",
+            "fc5321766b8742ca97c4a839ba30d421",
+            "c4256f50e38e481083f3d366bfd91d3f",
+            "f7e4e90fb3fe4bbb85adb039404dd8e2",
+            "e0f8b5f130064bd69f4f3298e9536b5a",
+            "20956dab8f3e4f22830b4d9e56a5232a",
+            "4efe313f923c4ae585fb8a4353cecd97",
+            "3af59a3e9ac2430da201262fc54b5998",
+            "ad746cc40cdb461bba8cf04033d4afc5",
+            "3d09770f22854ca38213d4a64ace6df3",
+            "910df16ec7494eb68fb1f8ce95046414",
+            "080c7eed9cc0475980e85a530c91e616",
+            "e4fe961d149b461fb1d168d226c8aa1d",
+            "2a588c12d3814de495fa865a63629ba8",
+            "607a235508e54fdda0aef75311c7a213",
+            "383e14f14b0d4328a80e6b0283c421fa",
+            "913324d3476a4d04887d200f91afc553",
+            "4c0c6892c4f347deb4a85544664ff1e1",
+            "a863bb17b5984981bf9bd4ff93e438f4",
+            "b28286deba7c4152a8d2c21ea0d19402",
+            "fb9e17975b2349de81115173af6ac17a",
+            "f3b068de4fa6466e88970b73c868de0a",
+            "2127bee2928e43578b8b51e3c1fdfabf",
+            "a97f3d8c7bdf4292ae8ed133f059f635",
+            "67053bf18cd04347a0f2d2ff6134ae88",
+            "80e56300aee14b4386832aa1618c5d43",
+            "d096e33830754ea5b2e8f102548b805a",
+            "a913ea3370404f5f972754715889aced",
+            "35db2f7869f44aeab422409d27d5f7ec"
+          ]
+        },
+        "id": "18b3d67c",
+        "outputId": "f0d7f72f-8166-439b-96da-ed7e30f8bdb3"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🦥 Unsloth: Will patch your computer to enable 2x faster free finetuning.\n",
+            "🦥 Unsloth Zoo will now patch everything to make training faster!\n",
+            "==((====))==  Unsloth 2025.3.19: Fast Qwen2_5_Vl patching. Transformers: 4.50.0.\n",
+            "   \\\\   /|    Tesla T4. Num GPUs = 1. Max memory: 14.741 GB. Platform: Linux.\n",
+            "O^O/ \\_/ \\    Torch: 2.6.0+cu124. CUDA: 7.5. CUDA Toolkit: 12.4. Triton: 3.2.0\n",
+            "\\        /    Bfloat16 = FALSE. FA [Xformers = 0.0.29.post3. FA2 = False]\n",
+            " \"-____-\"     Free license: http://github.com/unslothai/unsloth\n",
+            "Unsloth: Fast downloading is enabled - ignore downloading bars which are red colored!\n"
+          ]
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "73fc3ac47de840cda7a07297153404d5",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model.safetensors:   0%|          | 0.00/5.97G [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "78ae8aea29e04420bcfe616061934d98",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "generation_config.json:   0%|          | 0.00/267 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "45385885a26e42d0b1f52eda382fd6f4",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "preprocessor_config.json:   0%|          | 0.00/575 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stderr",
+          "output_type": "stream",
+          "text": [
+            "Using a slow image processor as `use_fast` is unset and a slow processor was saved with this model. `use_fast=True` will be the default behavior in v4.50, even if the model was saved with a slow processor. This will result in minor differences in outputs. You'll still be able to use a slow processor with `use_fast=False`.\n"
+          ]
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "14e519d5e0834fd9a70a111140f8429a",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer_config.json:   0%|          | 0.00/7.33k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "643db314d8e94feeb9cd8747909eaabe",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "vocab.json:   0%|          | 0.00/2.78M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "bbb5e6a0a8b64d10802fbf3e89778306",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "merges.txt:   0%|          | 0.00/1.67M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "c1af10a57c0a40cf818d0974facdcc36",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer.json:   0%|          | 0.00/11.4M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "c2f518986b724620bbc67f7b6ede6d96",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "added_tokens.json:   0%|          | 0.00/605 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "3af59a3e9ac2430da201262fc54b5998",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "special_tokens_map.json:   0%|          | 0.00/614 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "a863bb17b5984981bf9bd4ff93e438f4",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "chat_template.json:   0%|          | 0.00/1.05k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        }
+      ],
+      "source": [
+        "from unsloth import FastVisionModel # FastLanguageModel for LLMs\n",
+        "import torch\n",
+        "\n",
+        "# 4bit pre quantized models we support for 4x faster downloading + no OOMs.\n",
+        "fourbit_models = [\n",
+        "    \"unsloth/Llama-3.2-11B-Vision-Instruct-bnb-4bit\", # Llama 3.2 vision support\n",
+        "    \"unsloth/Llama-3.2-11B-Vision-bnb-4bit\",\n",
+        "    \"unsloth/Llama-3.2-90B-Vision-Instruct-bnb-4bit\", # Can fit in a 80GB card!\n",
+        "    \"unsloth/Llama-3.2-90B-Vision-bnb-4bit\",\n",
+        "\n",
+        "    \"unsloth/Pixtral-12B-2409-bnb-4bit\",              # Pixtral fits in 16GB!\n",
+        "    \"unsloth/Pixtral-12B-Base-2409-bnb-4bit\",         # Pixtral base model\n",
+        "\n",
+        "    \"unsloth/Qwen2-VL-2B-Instruct-bnb-4bit\",          # Qwen2 VL support\n",
+        "    \"unsloth/Qwen2-VL-7B-Instruct-bnb-4bit\",\n",
+        "    \"unsloth/Qwen2-VL-72B-Instruct-bnb-4bit\",\n",
+        "\n",
+        "    \"unsloth/llava-v1.6-mistral-7b-hf-bnb-4bit\",      # Any Llava variant works!\n",
+        "    \"unsloth/llava-1.5-7b-hf-bnb-4bit\",\n",
+        "] # More models at https://huggingface.co/unsloth\n",
+        "\n",
+        "model, tokenizer = FastVisionModel.from_pretrained(\n",
+        "    \"unsloth/Qwen2.5-VL-7B-Instruct-bnb-4bit\",\n",
+        "    load_in_4bit = True, # Use 4bit to reduce memory use. False for 16bit LoRA.\n",
+        "    use_gradient_checkpointing = \"unsloth\", # True or \"unsloth\" for long context\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "45f1a7d8",
+      "metadata": {
+        "id": "45f1a7d8"
+      },
+      "outputs": [],
+      "source": [
+        "model = FastVisionModel.get_peft_model(\n",
+        "    model,\n",
+        "    finetune_vision_layers     = True, # False if not finetuning vision layers\n",
+        "    finetune_language_layers   = True, # False if not finetuning language layers\n",
+        "    finetune_attention_modules = True, # False if not finetuning attention layers\n",
+        "    finetune_mlp_modules       = True, # False if not finetuning MLP layers\n",
+        "\n",
+        "    r = 16,           # The larger, the higher the accuracy, but might overfit\n",
+        "    lora_alpha = 16,  # Recommended alpha == r at least\n",
+        "    lora_dropout = 0,\n",
+        "    bias = \"none\",\n",
+        "    random_state = 3407,\n",
+        "    use_rslora = False,  # We support rank stabilized LoRA\n",
+        "    loftq_config = None, # And LoftQ\n",
+        "    # target_modules = \"all-linear\", # Optional now! Can specify a list if needed\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "915566b6",
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 177,
+          "referenced_widgets": [
+            "5e4f3f4910d1477b924362c095a0cedd",
+            "b5a01de096fa4e2daf66e235bd5686bb",
+            "e9195f3a3e29475f941c302fe2a88a83",
+            "0d6f6fb66522436786728d8602e2f466",
+            "94b72e08764c486d8eed43a4557f1d98",
+            "8e8281a56a3d4879b6b376077890c920",
+            "630894e18b264f7dae8eddb17304a1cd",
+            "697fc92abb824cf4a9bc78709640ba54",
+            "eb6d552d6c1d4e82a521b29b36ae3db0",
+            "7572f2d06114442ba94fc22761a55346",
+            "c6dcd15e155949cbb9698e43e55b7a90",
+            "7365368b63d9425db5d4e5514e6e0586",
+            "5997909fc34645ce9a03d82ab0932766",
+            "ea4ebb90b708493c85fa81fecf4d60c0",
+            "227724312eb045a58616f63c3a5b7407",
+            "4f58e8a2ddbb4a73a2421ea37c68fea9",
+            "7e89e5546e394162b7b0f793478527ff",
+            "db9ea237050045d8861d76bb3b995753",
+            "3a484309bbe148abb2ef05452850728a",
+            "5e601d00c0094d999a5b37b9555c111c",
+            "e7bd6c674af541d08c0acb5e47579156",
+            "927147d620b0426cb46b49b6d8dc2ffc",
+            "4ebb36e479884847bcef5736e276dfb9",
+            "7b5a059a8ef84817851d109fd7e3a7b5",
+            "0e949ae97d544d65af09cebe63041b8e",
+            "c817a779a9ff4a848391a7c7dff1e4ca",
+            "abae462b98c84006b71d4a62c8a47d5a",
+            "dc1a755aae6c44849d818fd96c046649",
+            "2650d2ce196e404a98cbfac96d0a9bef",
+            "36d579fdc2fb4c59b827f5bf7a92abd4",
+            "fccec1c2a389401eb614f5f1cfb15f0c",
+            "7b4d303966274c71b50312df12e7b87a",
+            "ce4bb2dffcf84ae9bf1f8ac86b2d768e",
+            "639b886f72e24951909e4ffb6cfa247d",
+            "7b13cf1727a04f5ca6de1f7eb536d800",
+            "631ce764f4684225a3c1e4455717a555",
+            "48af93dada914d8b88d5ffffd24ac666",
+            "4bd339c9d3ee43f39678d2c18baeef53",
+            "b1b12b8def994e748b08b27abcef4b87",
+            "bc38022049ce47628d8c215959c38b91",
+            "331d5d2bc67f44f283fc82481cb60411",
+            "0a5ad3bd338b4e6ea94a11a199d2f5ba",
+            "5c41f695158641f485349c20a1405cfd",
+            "89bc17f1911a43cca7196da232500fd6",
+            "f5629e8c82c848218f69810e1b21b0e4",
+            "5244452af0734f3183a7384435f9e1fe",
+            "69f645decfb64baca11cfbdb9773a458",
+            "d1788fabe3e34f6eb60fecab3c7490ba",
+            "8f423066ba8f421495f934a269053cc1",
+            "569d1435402e4533b0427a4b191b6754",
+            "b834a7ab12544f9b8305f5728677e921",
+            "e72ac7c9b7824c81a6e77e6fadad9f9c",
+            "828ad6e5fcfb44b3b4559ec5682d095d",
+            "dac611678f4949ae98051bdc975e083f",
+            "0a21bae13a3c46509db70dbe8e9de5eb"
+          ]
+        },
+        "id": "915566b6",
+        "outputId": "ece64855-55d4-4011-c5b8-33a9bb622734"
+      },
+      "outputs": [
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "5e4f3f4910d1477b924362c095a0cedd",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "README.md:   0%|          | 0.00/519 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "7365368b63d9425db5d4e5514e6e0586",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "train-00000-of-00001.parquet:   0%|          | 0.00/344M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "4ebb36e479884847bcef5736e276dfb9",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "test-00000-of-00001.parquet:   0%|          | 0.00/38.2M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "639b886f72e24951909e4ffb6cfa247d",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Generating train split:   0%|          | 0/68686 [00:00<?, ? examples/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "f5629e8c82c848218f69810e1b21b0e4",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Generating test split:   0%|          | 0/7632 [00:00<?, ? examples/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        }
+      ],
+      "source": [
+        "from datasets import load_dataset\n",
+        "dataset = load_dataset(\"unsloth/LaTeX_OCR\", split = \"train\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "6193435d",
+      "metadata": {
+        "id": "6193435d"
+      },
+      "source": [
+        "## Output\n",
+        "This shows a basic output example of the vision-language model."
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/Sesame_CSM_1B_TTS.ipynb

@@ -0,0 +1,146 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "a050dfc0",
+      "metadata": {
+        "id": "a050dfc0"
+      },
+      "source": [
+        "# Sesame CSM (1B) - Text to Speech"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "7c2c61ec",
+      "metadata": {
+        "id": "7c2c61ec"
+      },
+      "source": [
+        "This notebook showcases how to generate speech from text using the Sesame CSM 1B model. This is ideal for converting instructional or conversational content into natural audio output."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Sesame_CSM_1B_TTS.ipynb)\n"
+      ],
+      "metadata": {
+        "id": "5SA94wTb9AH-"
+      },
+      "id": "5SA94wTb9AH-"
+    },
+    {
+      "cell_type": "markdown",
+      "id": "ab27fd8d",
+      "metadata": {
+        "id": "ab27fd8d"
+      },
+      "source": [
+        "## 🧩 Dependencies"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "ac3a627f",
+      "metadata": {
+        "id": "ac3a627f"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install -q transformers\n",
+        "!pip install -q torchaudio\n",
+        "!pip install -q soundfile"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "a382e4d0",
+      "metadata": {
+        "id": "a382e4d0"
+      },
+      "source": [
+        "## 🛠️ Tools\n",
+        "- transformers for loading the model\n",
+        "- torchaudio for audio processing\n",
+        "- soundfile for playback"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "7ff6eb6d",
+      "metadata": {
+        "id": "7ff6eb6d"
+      },
+      "source": [
+        "## 🧾 YAML Prompt\n",
+        "```yaml\n",
+        "task: \"Text to Speech\"\n",
+        "style: \"Clear, educational\"\n",
+        "language: \"en\"\n",
+        "```"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0ab9cda8",
+      "metadata": {
+        "id": "0ab9cda8"
+      },
+      "source": [
+        "## 🧠 Main"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "6459f8bd",
+      "metadata": {
+        "id": "6459f8bd"
+      },
+      "outputs": [],
+      "source": [
+        "from transformers import AutoProcessor, AutoModelForSpeechSeq2Seq\n",
+        "import torchaudio\n",
+        "import soundfile as sf\n",
+        "import torch\n",
+        "\n",
+        "processor = AutoProcessor.from_pretrained(\"m-a-p/Sesame-CM\")\n",
+        "model = AutoModelForSpeechSeq2Seq.from_pretrained(\"m-a-p/Sesame-CM\")\n",
+        "model = model.to(\"cuda\" if torch.cuda.is_available() else \"cpu\")\n",
+        "\n",
+        "text = \"Welcome to the world of voice synthesis using open models!\"\n",
+        "inputs = processor(text, return_tensors=\"pt\").to(model.device)\n",
+        "with torch.no_grad():\n",
+        "    outputs = model.generate(**inputs)\n",
+        "speech = processor.batch_decode(outputs, return_tensors=\"pt\")[0]\n",
+        "\n",
+        "sf.write(\"output.wav\", speech.numpy(), 16000)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "376fe112",
+      "metadata": {
+        "id": "376fe112"
+      },
+      "source": [
+        "## 📤 Output\n",
+        "🖼️ Output Preview (Text Summary):\n",
+        "\n",
+        "Prompt: A clear educational text is converted to a .wav file.\n",
+        "\n",
+        "🎧 The output audio will say: 'Welcome to the world of voice synthesis using open models!'\n",
+        "This demonstrates how Sesame-CM can be used for building TTS applications easily."
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

examples/cookbooks/TinyLlama_1_1B_model_SimpleAIAgent.ipynb

@@ -0,0 +1,364 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "3622c575",
+   "metadata": {
+    "id": "3622c575"
+   },
+   "source": [
+    "# TinyLlama Agent Demo\n",
+    "\n",
+    "This notebook demonstrates how to create a simple AI agent using the TinyLlama (1.1B) model.\n",
+    "\n",
+    "**Requirements:**\n",
+    "- `transformers`\n",
+    "- `accelerate`\n",
+    "- `torch`\n",
+    "\n",
+    "We will load the model, prepare a basic conversational interface, and test it with a simple prompt."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "qS0M9pRhTGpf",
+   "metadata": {
+    "id": "qS0M9pRhTGpf"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/TinyLlama_1_1B_model_SimpleAIAgent.ipynb)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "tuw0IDpBS0ei",
+   "metadata": {
+    "id": "tuw0IDpBS0ei"
+   },
+   "source": [
+    "# Install necessary packages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "0d06cae9",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "0d06cae9",
+    "outputId": "3e1d8fb7-19be-455b-dc35-d0ab19146669"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m363.4/363.4 MB\u001b[0m \u001b[31m3.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m13.8/13.8 MB\u001b[0m \u001b[31m29.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m24.6/24.6 MB\u001b[0m \u001b[31m29.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m883.7/883.7 kB\u001b[0m \u001b[31m20.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m664.8/664.8 MB\u001b[0m \u001b[31m2.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m211.5/211.5 MB\u001b[0m \u001b[31m5.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m56.3/56.3 MB\u001b[0m \u001b[31m12.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m127.9/127.9 MB\u001b[0m \u001b[31m7.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m207.5/207.5 MB\u001b[0m \u001b[31m6.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m21.1/21.1 MB\u001b[0m \u001b[31m45.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q transformers accelerate torch"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "RFhYLkO1S5F9",
+   "metadata": {
+    "id": "RFhYLkO1S5F9"
+   },
+   "source": [
+    "# Load TinyLlama model and tokenizer"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "415af398",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 241,
+     "referenced_widgets": [
+      "dae7d635257948149c74e65956f614e3",
+      "17ec6fcc9f624cdbb62fe2b8b55230d0",
+      "58474504488044138a0252bb75258d86",
+      "04fe4518fac04b9f8b29c62ed70f1dfd",
+      "c6a9d3ea25594170977243d2048d3408",
+      "730bebf00be142d3979c6d12b55d6757",
+      "03ad1674c0884e7b9c4a21af0a1e66c3",
+      "ebac47c887f04b79a60bd0918002bf0d",
+      "ece9bce5d2ca4dd7b019040175513118",
+      "458f11dbadb045f1aa8c72780e7aa2a0",
+      "ec28a20d0a14445489723684d2d69c0a",
+      "d347fa0c0fc849559b66c8f116c86317",
+      "117f649fa62b4f5d9add0160e6cd80a4",
+      "66f702418fa348eea27778282dc443aa",
+      "44413339df5b4ae688f8101faf9ed3b5",
+      "00cc576df95441c8916ce38a7c6decc2",
+      "22e9ea6d191841bf9a5a5072326aa6d8",
+      "bd94a291b3164113b5ea460b38b8c167",
+      "9d132a297f924a3d867605df81e70d8e",
+      "5345feddca204db784ea0452e739eda6",
+      "ace33e6e88d842c89efd180b3a83f674",
+      "61dd85a7edf544f196c60a259a91fa0d",
+      "7451ec9bd091441c852d075b47bd1ca5",
+      "05e3446e7c9243819a25d1ca8e8fa38e",
+      "73141c4c9218462da97999d3afa459bc",
+      "1cffc33252b94fbc861edb0953f13153",
+      "de917c0fc49040c8a9254333c34c884a",
+      "50962ececc0b42c28170eb0c23fd6171",
+      "856cc834a33a4f9fb59c77f748006b36",
+      "17fd1d476c1f4891b8cbeb8cacdeb866",
+      "c97dc50f42cb44b8a71aeff5272d5337",
+      "2e3a66f622d445c4be544a9306798cb6",
+      "92920b1d428a4ed68a9e0329e2034cad",
+      "7e282c1fcae842cc87c93ecfc1763654",
+      "f9ed70f887204e2fb336e38a35096eec",
+      "a4d99f9beca44e4a8fadff65b27aa78f",
+      "b4f77b96d00445eea77ac78baa8c1e99",
+      "695898e4a4c8476cb318446a6da592ba",
+      "d70bcacbe77c41f685a4f8020f767889",
+      "af49afc49ecf47fb9ebf2d299954eff2",
+      "1bd2a253348f4b45928c875940f72481",
+      "b6c5f55fc85b4331a2e749d27ce15f89",
+      "81a87638c71046d7aeb1c642558602f7",
+      "e750883103444391bd64872344c651d7",
+      "e78dca0cf1314d01a5d5126e448e9d87",
+      "d0c53dffc0c34d7090febf78231972b2",
+      "152a118177914c6692e7ee4987b92b9b",
+      "88fd71fd6dbf43ebb0a3b8471fd35f8d",
+      "ddb91266f8834e4eaaf136cc15f4a831",
+      "9f8179d135054eb292c9adc7fd66a91a",
+      "297d5bc8b3a04f26b80e2cc5ee3f7bbd",
+      "f49f72679cb944cd8fce5557bbd68b1b",
+      "2ee28c8ef4f74690b80a89050da4ebb5",
+      "c29924d6561a4feaa9238d1b34394941",
+      "03636146b7c14f5db80b8f105be55303",
+      "b391081de4444859ac3213aac99cc33a",
+      "2babb83499fc46dc8422473f7b98403c",
+      "a32f6cc2777941bca5b6250e36624ead",
+      "90cd9996184a452ab651f9b8cc590f47",
+      "dc04209c92764096ba9bd4aefa81c189",
+      "16e5b93c3c964a8a8ca460d9077d0638",
+      "794f22ded07d46c5a916325109618987",
+      "dce367f1a5a74ebf94aea37209aa0a40",
+      "5e355e3f340f4a7590e4a88d44b03383",
+      "4e725e19c877462aa3c10726a335bbde",
+      "d60ab6c255d244098a459459016a2089",
+      "f1b07183320d42af88f985bd1abf054f",
+      "d23103bb4b354e29a2c3e7dc93867b36",
+      "ea3e0ae0aef54e5da113c9686ebbbab9",
+      "4d3365c1bb7740dc8f36f4b419af135a",
+      "c06ccbc051264027bd2c6521fec69abe",
+      "597dbf5b28134cc0bf9d613443243455",
+      "faa4f285eb224bbcbed649bd479e571f",
+      "6e684d35885a4706b8add6834cd521ad",
+      "f9c55ada3386460183e02559defec8a4",
+      "9d64cbe1605f4f358923754c5f8b6424",
+      "6008ed7eca09485195eb37c36acfbe79"
+     ]
+    },
+    "id": "415af398",
+    "outputId": "28de1886-e83f-49bf-b05f-cd19439605c5"
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "dae7d635257948149c74e65956f614e3",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer_config.json:   0%|          | 0.00/1.29k [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "d347fa0c0fc849559b66c8f116c86317",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer.model:   0%|          | 0.00/500k [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "7451ec9bd091441c852d075b47bd1ca5",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "tokenizer.json:   0%|          | 0.00/1.84M [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "7e282c1fcae842cc87c93ecfc1763654",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "special_tokens_map.json:   0%|          | 0.00/551 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "e78dca0cf1314d01a5d5126e448e9d87",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "config.json:   0%|          | 0.00/608 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "b391081de4444859ac3213aac99cc33a",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "model.safetensors:   0%|          | 0.00/2.20G [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "f1b07183320d42af88f985bd1abf054f",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "generation_config.json:   0%|          | 0.00/124 [00:00<?, ?B/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "from transformers import AutoTokenizer, AutoModelForCausalLM\n",
+    "import torch\n",
+    "\n",
+    "model_name = \"TinyLlama/TinyLlama-1.1B-Chat-v1.0\"\n",
+    "tokenizer = AutoTokenizer.from_pretrained(model_name)\n",
+    "model = AutoModelForCausalLM.from_pretrained(model_name, torch_dtype=torch.float16, device_map=\"auto\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "N0bRTd_DS8aL",
+   "metadata": {
+    "id": "N0bRTd_DS8aL"
+   },
+   "source": [
+    "# Define a function to generate responses from the agent"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "1b0483e1",
+   "metadata": {
+    "id": "1b0483e1"
+   },
+   "outputs": [],
+   "source": [
+    "def generate_response(prompt, max_length=256):\n",
+    "    inputs = tokenizer(prompt, return_tensors=\"pt\").to(model.device)\n",
+    "    outputs = model.generate(**inputs, max_new_tokens=max_length)\n",
+    "    return tokenizer.decode(outputs[0], skip_special_tokens=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "vbHKNxc-S_Bk",
+   "metadata": {
+    "id": "vbHKNxc-S_Bk"
+   },
+   "source": [
+    "# Example usage"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "298c9811",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "298c9811",
+    "outputId": "6e412608-735c-4604-8a5d-a66b98dd9df0"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "You are a helpful assistant. What is the capital of France?\n"
+     ]
+    }
+   ],
+   "source": [
+    "prompt = \"You are a helpful assistant. What is the capital of France?\"\n",
+    "response = generate_response(prompt)\n",
+    "print(response)"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/YouTube_Influencer_Intelligence_Agent.ipynb

@@ -0,0 +1,591 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "c417d47b",
+   "metadata": {
+    "id": "c417d47b"
+   },
+   "source": [
+    "# YouTube Influencer Intelligence Agent\n",
+    "\n",
+    "Analyzes YouTube influencers for marketing or collaboration purposes."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "xox_eBaJg4rq",
+   "metadata": {
+    "id": "xox_eBaJg4rq"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/YouTube_Influencer_Intelligence_Agent.ipynb)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "jsaqhbElgHza",
+   "metadata": {
+    "id": "jsaqhbElgHza"
+   },
+   "source": [
+    "# Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "324febba",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "324febba",
+    "outputId": "148556a5-fd5e-44ee-e4e1-56ae68709464"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/176.8 kB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m176.8/176.8 kB\u001b[0m \u001b[31m6.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m130.2/130.2 kB\u001b[0m \u001b[31m5.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m105.4/105.4 kB\u001b[0m \u001b[31m5.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m3.3/3.3 MB\u001b[0m \u001b[31m41.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m45.2/45.2 kB\u001b[0m \u001b[31m3.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q praisonaiagents openai duckduckgo_search"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "pnILL4wigO--",
+   "metadata": {
+    "id": "pnILL4wigO--"
+   },
+   "source": [
+    "# Set OpenAI API Key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "2997709c",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "2997709c",
+    "outputId": "c6369f33-76c5-4b23-fd68-ed1ec92eec0e"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Enter your OpenAI API key: ··········\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "from getpass import getpass\n",
+    "\n",
+    "# 🔑 Securely input your API key\n",
+    "os.environ[\"OPENAI_API_KEY\"] = getpass(\"Enter your OpenAI API key: \")\n",
+    "import openai\n",
+    "openai.api_key = os.getenv(\"OPENAI_API_KEY\")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "fhuSmjHFgW8t",
+   "metadata": {
+    "id": "fhuSmjHFgW8t"
+   },
+   "source": [
+    "# Import PraisonAI Agents"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "1c01dc84",
+   "metadata": {
+    "id": "1c01dc84"
+   },
+   "outputs": [],
+   "source": [
+    "from praisonaiagents import Agent, Task, PraisonAIAgents"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "49a41cdd",
+   "metadata": {
+    "id": "49a41cdd"
+   },
+   "source": [
+    "# YAML Prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "0b3a6096",
+   "metadata": {
+    "id": "0b3a6096"
+   },
+   "outputs": [],
+   "source": [
+    "yaml_prompt = \"\"\"\n",
+    "name: YouTubeInfluencerIntelligence\n",
+    "role: YouTube Channel Analysis and Strategy Expert\n",
+    "goal: Analyze YouTube influencers and channels to provide strategic insights, trends, and content suggestions.\n",
+    "backstory: You are a YouTube analytics expert trained in identifying trends, engagement metrics, and content strategies.\n",
+    "skills:\n",
+    "  - Analyze subscriber and engagement data\n",
+    "  - Spot content patterns and trends\n",
+    "  - Recommend growth strategies\n",
+    "  - Detect potential monetization methods\n",
+    "llm: gpt-4o\n",
+    "verbosity: true\n",
+    "format: markdown\n",
+    "\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dQ0vQrsggiqt",
+   "metadata": {
+    "id": "dQ0vQrsggiqt"
+   },
+   "source": [
+    "# Define the Intelligence Agent"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "f293e64e",
+   "metadata": {
+    "id": "f293e64e"
+   },
+   "outputs": [],
+   "source": [
+    "yt_agent = Agent(\n",
+    "    name=\"YouTubeInfluencerIntel\",\n",
+    "    instructions=\"\"\"\n",
+    "You are a YouTube intelligence analyst. Your job is to research a specific channel, niche, or influencer topic.\n",
+    "Provide growth recommendations, engagement analysis, trending strategies, and monetization tips. Format in markdown.\n",
+    "\"\"\",\n",
+    "    llm=\"gpt-4o\",\n",
+    "    verbose=True,\n",
+    "    markdown=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ULFepw5ggoRY",
+   "metadata": {
+    "id": "ULFepw5ggoRY"
+   },
+   "source": [
+    "# Define the Task"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "pplhgO0WglsY",
+   "metadata": {
+    "id": "pplhgO0WglsY"
+   },
+   "outputs": [],
+   "source": [
+    "yt_task = Task(\n",
+    "    name=\"AnalyzeInfluencerChannel\",\n",
+    "    description=\"Analyze the growth strategy of the YouTube channel 'Ali Abdaal' and suggest content ideas for a new productivity creator.\",\n",
+    "    expected_output=\"A markdown report with channel strengths, content patterns, audience engagement tips, and content ideas.\",\n",
+    "    agent=yt_agent\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "JCLR8cZEguUV",
+   "metadata": {
+    "id": "JCLR8cZEguUV"
+   },
+   "source": [
+    "# Create Agent System"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "DT34DDBmgqbk",
+   "metadata": {
+    "id": "DT34DDBmgqbk"
+   },
+   "outputs": [],
+   "source": [
+    "yt_intel_system = PraisonAIAgents(\n",
+    "    agents=[yt_agent],\n",
+    "    tasks=[yt_task],\n",
+    "    process=\"sequential\",\n",
+    "    verbose=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "N1gjbZ33gzzN",
+   "metadata": {
+    "id": "N1gjbZ33gzzN"
+   },
+   "source": [
+    "# Run the Agent"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "yjM_e2rQgw2h",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 1000,
+     "referenced_widgets": [
+      "b04f460c5c974d6b9360a8bea97ab662",
+      "f464ceb8423c4e4484b6fd5318cca4c6"
+     ]
+    },
+    "id": "yjM_e2rQgw2h",
+    "outputId": "90bb00e7-5829-4f53-ef90-ca9df38a3e23"
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">YouTubeInfluencerIntel</span>                                                                               <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mYouTubeInfluencerIntel\u001b[0m                                                                               \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "b04f460c5c974d6b9360a8bea97ab662",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 12.5s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 12.5s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Analyze the growth strategy of the YouTube channel 'Ali Abdaal' and suggest  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> content ideas for a new productivity creator.. Expected Output: A markdown report with channel strengths,       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> content patterns, audience engagement tips, and content ideas.. Please provide only the final result of your    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> work. Do not add any conversation or extra explanation.                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Analyze the growth strategy of the YouTube channel 'Ali Abdaal' and suggest  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m content ideas for a new productivity creator.. Expected Output: A markdown report with channel strengths,       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m content patterns, audience engagement tips, and content ideas.. Please provide only the final result of your    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m work. Do not add any conversation or extra explanation.                                                         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┃                                    <span style=\"font-weight: bold\">YouTube Channel Analysis: Ali Abdaal</span>                                     ┃ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                <span style=\"font-weight: bold; text-decoration: underline\">Channel Strengths</span>                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Educational Content</span>: Ali Abdaal is known for his informative and educational content, focusing on            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>productivity, personal development, and tech reviews.                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Authenticity</span>: His genuine and relatable personality helps build trust with his audience.                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Consistency</span>: Regular uploads and a consistent content schedule keep the audience engaged.                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">High-Quality Production</span>: Professional video and audio quality enhance viewer experience.                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Diverse Content Formats</span>: Utilizes a mix of long-form videos, vlogs, and shorts to cater to different         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>audience preferences.                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                <span style=\"font-weight: bold; text-decoration: underline\">Content Patterns</span>                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Productivity Tips</span>: Videos often focus on productivity hacks, study techniques, and time management.          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Book Reviews and Summaries</span>: Regularly shares insights from books, appealing to an audience interested in     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>self-improvement.                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Tech and Tools</span>: Reviews and recommendations of productivity tools and tech gadgets.                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Personal Development</span>: Content on habits, routines, and personal growth strategies.                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Collaborations</span>: Features interviews and collaborations with other influencers and experts.                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                            <span style=\"font-weight: bold; text-decoration: underline\">Audience Engagement Tips</span>                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Community Building</span>: Encourage viewer interaction through comments, polls, and Q&amp;A sessions.                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Feedback Loop</span>: Regularly ask for audience feedback to tailor content to viewer preferences.                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Live Streams</span>: Host live sessions to engage with the audience in real-time and build a stronger community.    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Social Media Integration</span>: Use platforms like Instagram and Twitter to engage with the audience outside of    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>YouTube.                                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                  <span style=\"font-weight: bold; text-decoration: underline\">Content Ideas for a New Productivity Creator</span>                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Daily Routine Vlogs</span>: Share a day-in-the-life video focusing on productivity habits and routines.             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Productivity Challenges</span>: Create a series where you try different productivity techniques for a week and      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>share results.                                                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">Tool Comparisons</span>: Compare popular productivity tools and apps, providing pros and cons for each.             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">Case Studies</span>: Analyze the productivity habits of successful individuals and extract actionable insights.     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 5 </span><span style=\"font-weight: bold\">Interactive Workshops</span>: Host virtual workshops on productivity topics, encouraging viewer participation.      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 6 </span><span style=\"font-weight: bold\">Behind-the-Scenes</span>: Offer a glimpse into your content creation process and how you stay productive.           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 7 </span><span style=\"font-weight: bold\">Book Club</span>: Start a monthly book club focusing on productivity and personal development books.                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 8 </span><span style=\"font-weight: bold\">Myth Busting</span>: Debunk common productivity myths and provide evidence-based alternatives.                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                               <span style=\"font-weight: bold; text-decoration: underline\">Trending Strategies</span>                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Short-Form Content</span>: Leverage YouTube Shorts to capture attention with quick, impactful productivity tips.    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">SEO Optimization</span>: Use relevant keywords and tags to improve video discoverability.                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Cross-Promotion</span>: Collaborate with other creators in the productivity niche to reach new audiences.           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Series Format</span>: Develop a series around a specific productivity theme to encourage binge-watching.            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                <span style=\"font-weight: bold; text-decoration: underline\">Monetization Tips</span>                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Affiliate Marketing</span>: Promote productivity tools and books with affiliate links.                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Online Courses</span>: Develop and sell courses on productivity and personal development.                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Merchandise</span>: Create branded merchandise related to productivity themes.                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Sponsorships</span>: Partner with brands that align with your content and audience interests.                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Memberships</span>: Offer exclusive content and perks through YouTube memberships or Patreon.                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> By leveraging these insights and strategies, a new productivity creator can effectively grow their channel and  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> engage with their audience.                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┃                                    \u001b[1mYouTube Channel Analysis: Ali Abdaal\u001b[0m                                     ┃ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                \u001b[1;4mChannel Strengths\u001b[0m                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mEducational Content\u001b[0m: Ali Abdaal is known for his informative and educational content, focusing on            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mproductivity, personal development, and tech reviews.                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mAuthenticity\u001b[0m: His genuine and relatable personality helps build trust with his audience.                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mConsistency\u001b[0m: Regular uploads and a consistent content schedule keep the audience engaged.                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mHigh-Quality Production\u001b[0m: Professional video and audio quality enhance viewer experience.                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mDiverse Content Formats\u001b[0m: Utilizes a mix of long-form videos, vlogs, and shorts to cater to different         \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0maudience preferences.                                                                                        \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                \u001b[1;4mContent Patterns\u001b[0m                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mProductivity Tips\u001b[0m: Videos often focus on productivity hacks, study techniques, and time management.          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mBook Reviews and Summaries\u001b[0m: Regularly shares insights from books, appealing to an audience interested in     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mself-improvement.                                                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mTech and Tools\u001b[0m: Reviews and recommendations of productivity tools and tech gadgets.                          \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mPersonal Development\u001b[0m: Content on habits, routines, and personal growth strategies.                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCollaborations\u001b[0m: Features interviews and collaborations with other influencers and experts.                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                            \u001b[1;4mAudience Engagement Tips\u001b[0m                                             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCommunity Building\u001b[0m: Encourage viewer interaction through comments, polls, and Q&A sessions.                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mFeedback Loop\u001b[0m: Regularly ask for audience feedback to tailor content to viewer preferences.                  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mLive Streams\u001b[0m: Host live sessions to engage with the audience in real-time and build a stronger community.    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mSocial Media Integration\u001b[0m: Use platforms like Instagram and Twitter to engage with the audience outside of    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mYouTube.                                                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                  \u001b[1;4mContent Ideas for a New Productivity Creator\u001b[0m                                   \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mDaily Routine Vlogs\u001b[0m: Share a day-in-the-life video focusing on productivity habits and routines.             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mProductivity Challenges\u001b[0m: Create a series where you try different productivity techniques for a week and      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mshare results.                                                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mTool Comparisons\u001b[0m: Compare popular productivity tools and apps, providing pros and cons for each.             \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mCase Studies\u001b[0m: Analyze the productivity habits of successful individuals and extract actionable insights.     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 5 \u001b[0m\u001b[1mInteractive Workshops\u001b[0m: Host virtual workshops on productivity topics, encouraging viewer participation.      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 6 \u001b[0m\u001b[1mBehind-the-Scenes\u001b[0m: Offer a glimpse into your content creation process and how you stay productive.           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 7 \u001b[0m\u001b[1mBook Club\u001b[0m: Start a monthly book club focusing on productivity and personal development books.                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m 8 \u001b[0m\u001b[1mMyth Busting\u001b[0m: Debunk common productivity myths and provide evidence-based alternatives.                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                               \u001b[1;4mTrending Strategies\u001b[0m                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mShort-Form Content\u001b[0m: Leverage YouTube Shorts to capture attention with quick, impactful productivity tips.    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mSEO Optimization\u001b[0m: Use relevant keywords and tags to improve video discoverability.                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mCross-Promotion\u001b[0m: Collaborate with other creators in the productivity niche to reach new audiences.           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mSeries Format\u001b[0m: Develop a series around a specific productivity theme to encourage binge-watching.            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                \u001b[1;4mMonetization Tips\u001b[0m                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mAffiliate Marketing\u001b[0m: Promote productivity tools and books with affiliate links.                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mOnline Courses\u001b[0m: Develop and sell courses on productivity and personal development.                           \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mMerchandise\u001b[0m: Create branded merchandise related to productivity themes.                                      \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mSponsorships\u001b[0m: Partner with brands that align with your content and audience interests.                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mMemberships\u001b[0m: Offer exclusive content and perks through YouTube memberships or Patreon.                       \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m By leveraging these insights and strategies, a new productivity creator can effectively grow their channel and  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m engage with their audience.                                                                                     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "🎥 YouTube Intelligence Report:\n",
+      " # YouTube Channel Analysis: Ali Abdaal\n",
+      "\n",
+      "## Channel Strengths\n",
+      "- **Educational Content**: Ali Abdaal is known for his informative and educational content, focusing on productivity, personal development, and tech reviews.\n",
+      "- **Authenticity**: His genuine and relatable personality helps build trust with his audience.\n",
+      "- **Consistency**: Regular uploads and a consistent content schedule keep the audience engaged.\n",
+      "- **High-Quality Production**: Professional video and audio quality enhance viewer experience.\n",
+      "- **Diverse Content Formats**: Utilizes a mix of long-form videos, vlogs, and shorts to cater to different audience preferences.\n",
+      "\n",
+      "## Content Patterns\n",
+      "- **Productivity Tips**: Videos often focus on productivity hacks, study techniques, and time management.\n",
+      "- **Book Reviews and Summaries**: Regularly shares insights from books, appealing to an audience interested in self-improvement.\n",
+      "- **Tech and Tools**: Reviews and recommendations of productivity tools and tech gadgets.\n",
+      "- **Personal Development**: Content on habits, routines, and personal growth strategies.\n",
+      "- **Collaborations**: Features interviews and collaborations with other influencers and experts.\n",
+      "\n",
+      "## Audience Engagement Tips\n",
+      "- **Community Building**: Encourage viewer interaction through comments, polls, and Q&A sessions.\n",
+      "- **Feedback Loop**: Regularly ask for audience feedback to tailor content to viewer preferences.\n",
+      "- **Live Streams**: Host live sessions to engage with the audience in real-time and build a stronger community.\n",
+      "- **Social Media Integration**: Use platforms like Instagram and Twitter to engage with the audience outside of YouTube.\n",
+      "\n",
+      "## Content Ideas for a New Productivity Creator\n",
+      "1. **Daily Routine Vlogs**: Share a day-in-the-life video focusing on productivity habits and routines.\n",
+      "2. **Productivity Challenges**: Create a series where you try different productivity techniques for a week and share results.\n",
+      "3. **Tool Comparisons**: Compare popular productivity tools and apps, providing pros and cons for each.\n",
+      "4. **Case Studies**: Analyze the productivity habits of successful individuals and extract actionable insights.\n",
+      "5. **Interactive Workshops**: Host virtual workshops on productivity topics, encouraging viewer participation.\n",
+      "6. **Behind-the-Scenes**: Offer a glimpse into your content creation process and how you stay productive.\n",
+      "7. **Book Club**: Start a monthly book club focusing on productivity and personal development books.\n",
+      "8. **Myth Busting**: Debunk common productivity myths and provide evidence-based alternatives.\n",
+      "\n",
+      "## Trending Strategies\n",
+      "- **Short-Form Content**: Leverage YouTube Shorts to capture attention with quick, impactful productivity tips.\n",
+      "- **SEO Optimization**: Use relevant keywords and tags to improve video discoverability.\n",
+      "- **Cross-Promotion**: Collaborate with other creators in the productivity niche to reach new audiences.\n",
+      "- **Series Format**: Develop a series around a specific productivity theme to encourage binge-watching.\n",
+      "\n",
+      "## Monetization Tips\n",
+      "- **Affiliate Marketing**: Promote productivity tools and books with affiliate links.\n",
+      "- **Online Courses**: Develop and sell courses on productivity and personal development.\n",
+      "- **Merchandise**: Create branded merchandise related to productivity themes.\n",
+      "- **Sponsorships**: Partner with brands that align with your content and audience interests.\n",
+      "- **Memberships**: Offer exclusive content and perks through YouTube memberships or Patreon.\n",
+      "\n",
+      "By leveraging these insights and strategies, a new productivity creator can effectively grow their channel and engage with their audience.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query = \"Study the YouTube channel 'Ali Abdaal'. What makes it grow? Give tips for new productivity YouTubers.\"\n",
+    "output = yt_intel_system.start(input=query)\n",
+    "\n",
+    "# 🎬 Output\n",
+    "print(\"🎥 YouTube Intelligence Report:\\n\", output)\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/cookbooks/github_repo_analyzer_agent.ipynb

@@ -0,0 +1,466 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "YiPIh4QSYBCW"
+      },
+      "source": [
+        "# 🤖 GitHub Repo Analyzer Agent\n",
+        "AI agent powered by PraisonAI and OpenAI to analyze GitHub repositories using GitHub API."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "2Jkig4AGZG1n"
+      },
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/github_repo_analyzer_agent.ipynb)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "aAiN-i3UYvsN"
+      },
+      "source": [
+        "# 📦 Install dependencies"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "1B_sEv9PYBCZ"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install praisonaiagents openai requests"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "eUViHgGPaObo"
+      },
+      "source": [
+        "# Tools Used"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "ut_APj9xaSQI"
+      },
+      "source": [
+        "🧠 praisonaiagents – Smart AI agent\n",
+        "\n",
+        "🔗 openai – GPT-powered responses\n",
+        "\n",
+        "📂 requests – GitHub repo analysis\n",
+        "\n",
+        "🖥️ Python I/O – Interactive CLI in notebook"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "hDsXrWYpYzuB"
+      },
+      "source": [
+        "# 🔐 Set OpenAI API Key"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "aea6TQ4hYBCb"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "if not os.getenv(\"OPENAI_API_KEY\"):\n",
+        "    os.environ[\"OPENAI_API_KEY\"] = input(\"🔐 Enter your OpenAI API key: \")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "OvQvZZonY2YI"
+      },
+      "source": [
+        "# 🧠 Imports"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "1XSubvMsYBCc"
+      },
+      "outputs": [],
+      "source": [
+        "import requests\n",
+        "import openai\n",
+        "from praisonaiagents import Agent\n",
+        "\n",
+        "openai.api_key = os.environ[\"OPENAI_API_KEY\"]"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "s0o_V2oqY4rJ"
+      },
+      "source": [
+        "# 🤖 Create the Agent"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "40KpW78vYBCc"
+      },
+      "outputs": [],
+      "source": [
+        "agent = Agent(instructions=\"\"\"\n",
+        "You are a GitHub codebase explainer. When given a repo URL, fetch summary of\n",
+        "its files and provide insightful analysis. Be helpful and concise.\n",
+        "\"\"\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "q4b3ts3lY-Fe"
+      },
+      "source": [
+        "# 📂 Fetch GitHub repo file names"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "8fWBzdRxYBCd"
+      },
+      "outputs": [],
+      "source": [
+        "def fetch_repo_files(repo_url):\n",
+        "    api_url = repo_url.replace(\"https://github.com\", \"https://api.github.com/repos\") + \"/contents\"\n",
+        "    r = requests.get(api_url)\n",
+        "    return [f[\"name\"] for f in r.json()] if r.status_code == 200 else []"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "de0Du9OsZAjo"
+      },
+      "source": [
+        "# 💬 Ask Agent"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "v85t6c8PYBCd"
+      },
+      "outputs": [],
+      "source": [
+        "def ask_agent(repo_url):\n",
+        "    files = fetch_repo_files(repo_url)\n",
+        "    if not files:\n",
+        "        return \"❌ Cannot fetch repo contents.\"\n",
+        "    return agent.start(f\"Repo contains files: {files}. Analyze key components and structure.\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "8HOy15H0ZCsZ"
+      },
+      "source": [
+        "# 🧪 Run the agent"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 1000,
+          "referenced_widgets": [
+            "c536cd3c498244d4b0c2526b00610f29",
+            "f0baa19f760c4a869064e51fde0ea4d0"
+          ]
+        },
+        "id": "QNmR8_ZdYBCd",
+        "outputId": "448195d1-28eb-43c1-e86c-5308c4e6d089"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🔗 Enter GitHub repository URL: https://github.com/DhivyaBharathy-web/agents\n"
+          ]
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Agent</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mAgent\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "c536cd3c498244d4b0c2526b00610f29",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Output()"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+            ],
+            "text/plain": []
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 10.0s</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[2mResponse generated in 10.0s\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Repo contains files: ['Fuel_Emission_Agent_Intelligence_Agent.ipynb',                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> 'fixed_Cognitive_Assistant_Agent_Team.ipynb', 'fixed_Crypto_Research_Agent_Intelligence_Agent.ipynb',           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> 'fixed_E_commerce_Shopping_Assistant.ipynb', 'fixed_Home_Buying_Real_Estate_Agent.ipynb',                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> 'fixed_YouTube_Influencer_Intelligence_Agent.ipynb', 'fixed_voiGno_Restaurant_Agent_PraisonAI.ipynb']. Analyze  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> key components and structure.                                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m Repo contains files: ['Fuel_Emission_Agent_Intelligence_Agent.ipynb',                                           \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m 'fixed_Cognitive_Assistant_Agent_Team.ipynb', 'fixed_Crypto_Research_Agent_Intelligence_Agent.ipynb',           \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m 'fixed_E_commerce_Shopping_Assistant.ipynb', 'fixed_Home_Buying_Real_Estate_Agent.ipynb',                       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m 'fixed_YouTube_Influencer_Intelligence_Agent.ipynb', 'fixed_voiGno_Restaurant_Agent_PraisonAI.ipynb']. Analyze  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m key components and structure.                                                                                   \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> The repository contains several Jupyter Notebook files, each seemingly focused on different specialized agents. <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Here's a breakdown of the key components and structure based on the file names:                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Fuel_Emission_Agent_Intelligence_Agent.ipynb</span>:                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>This notebook likely focuses on analyzing and possibly predicting fuel emissions. It might include data   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>analysis, machine learning models, or simulations to assess environmental impacts or optimize fuel usage. <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">fixed_Cognitive_Assistant_Agent_Team.ipynb</span>:                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>This file suggests a cognitive assistant, possibly designed to aid in decision-making or provide          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>intelligent recommendations. The \"Team\" aspect might indicate collaborative features or multi-agent       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>interactions.                                                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">fixed_Crypto_Research_Agent_Intelligence_Agent.ipynb</span>:                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>This notebook is probably dedicated to cryptocurrency research. It might include data analysis, market    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>trend predictions, or sentiment analysis related to cryptocurrencies.                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">fixed_E_commerce_Shopping_Assistant.ipynb</span>:                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>This agent likely serves as a shopping assistant, possibly providing product recommendations, price       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>comparisons, or personalized shopping experiences for e-commerce platforms.                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 5 </span><span style=\"font-weight: bold\">fixed_Home_Buying_Real_Estate_Agent.ipynb</span>:                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>This notebook appears to be focused on the real estate market, potentially offering insights into         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>property values, market trends, or personalized home-buying recommendations.                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 6 </span><span style=\"font-weight: bold\">fixed_YouTube_Influencer_Intelligence_Agent.ipynb</span>:                                                           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>This file likely deals with analyzing YouTube influencers, possibly providing insights into influencer    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>performance, audience engagement, or content optimization strategies.                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 7 </span><span style=\"font-weight: bold\">fixed_voiGno_Restaurant_Agent_PraisonAI.ipynb</span>:                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">    • </span>This agent seems to be related to the restaurant industry, possibly offering services like menu           <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">      </span>optimization, customer feedback analysis, or operational efficiency improvements.                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Overall Structure and Insights</span>:                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span>The repository appears to focus on developing intelligent agents across various domains, each tailored to    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>specific industry needs.                                                                                     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span>The use of Jupyter Notebooks suggests an emphasis on data analysis, visualization, and possibly machine      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>learning or AI model development.                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span>The prefix \"fixed_\" in the file names might indicate that these are refined or updated versions of previous  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>iterations.                                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span>The diversity of domains covered (environmental, cognitive, financial, e-commerce, real estate, social       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>media, and hospitality) suggests a broad application of AI and data-driven insights.                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> These notebooks likely contain a mix of data preprocessing, model training, and evaluation, along with          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> visualizations to support the findings and recommendations of each agent.                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m The repository contains several Jupyter Notebook files, each seemingly focused on different specialized agents. \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m Here's a breakdown of the key components and structure based on the file names:                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mFuel_Emission_Agent_Intelligence_Agent.ipynb\u001b[0m:                                                                \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThis notebook likely focuses on analyzing and possibly predicting fuel emissions. It might include data   \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0manalysis, machine learning models, or simulations to assess environmental impacts or optimize fuel usage. \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mfixed_Cognitive_Assistant_Agent_Team.ipynb\u001b[0m:                                                                  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThis file suggests a cognitive assistant, possibly designed to aid in decision-making or provide          \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mintelligent recommendations. The \"Team\" aspect might indicate collaborative features or multi-agent       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0minteractions.                                                                                             \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mfixed_Crypto_Research_Agent_Intelligence_Agent.ipynb\u001b[0m:                                                        \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThis notebook is probably dedicated to cryptocurrency research. It might include data analysis, market    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mtrend predictions, or sentiment analysis related to cryptocurrencies.                                     \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mfixed_E_commerce_Shopping_Assistant.ipynb\u001b[0m:                                                                   \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThis agent likely serves as a shopping assistant, possibly providing product recommendations, price       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mcomparisons, or personalized shopping experiences for e-commerce platforms.                               \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 5 \u001b[0m\u001b[1mfixed_Home_Buying_Real_Estate_Agent.ipynb\u001b[0m:                                                                   \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThis notebook appears to be focused on the real estate market, potentially offering insights into         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mproperty values, market trends, or personalized home-buying recommendations.                              \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 6 \u001b[0m\u001b[1mfixed_YouTube_Influencer_Intelligence_Agent.ipynb\u001b[0m:                                                           \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThis file likely deals with analyzing YouTube influencers, possibly providing insights into influencer    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0mperformance, audience engagement, or content optimization strategies.                                     \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 7 \u001b[0m\u001b[1mfixed_voiGno_Restaurant_Agent_PraisonAI.ipynb\u001b[0m:                                                               \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m • \u001b[0mThis agent seems to be related to the restaurant industry, possibly offering services like menu           \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0m\u001b[1;33m   \u001b[0moptimization, customer feedback analysis, or operational efficiency improvements.                         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1mOverall Structure and Insights\u001b[0m:                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0mThe repository appears to focus on developing intelligent agents across various domains, each tailored to    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mspecific industry needs.                                                                                     \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0mThe use of Jupyter Notebooks suggests an emphasis on data analysis, visualization, and possibly machine      \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mlearning or AI model development.                                                                            \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0mThe prefix \"fixed_\" in the file names might indicate that these are refined or updated versions of previous  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0miterations.                                                                                                  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0mThe diversity of domains covered (environmental, cognitive, financial, e-commerce, real estate, social       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mmedia, and hospitality) suggests a broad application of AI and data-driven insights.                         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m These notebooks likely contain a mix of data preprocessing, model training, and evaluation, along with          \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m visualizations to support the findings and recommendations of each agent.                                       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "\n",
+            "🧠 Agent Insight:\n",
+            " The repository contains several Jupyter Notebook files, each seemingly focused on different specialized agents. Here's a breakdown of the key components and structure based on the file names:\n",
+            "\n",
+            "1. **Fuel_Emission_Agent_Intelligence_Agent.ipynb**:\n",
+            "   - This notebook likely focuses on analyzing and possibly predicting fuel emissions. It might include data analysis, machine learning models, or simulations to assess environmental impacts or optimize fuel usage.\n",
+            "\n",
+            "2. **fixed_Cognitive_Assistant_Agent_Team.ipynb**:\n",
+            "   - This file suggests a cognitive assistant, possibly designed to aid in decision-making or provide intelligent recommendations. The \"Team\" aspect might indicate collaborative features or multi-agent interactions.\n",
+            "\n",
+            "3. **fixed_Crypto_Research_Agent_Intelligence_Agent.ipynb**:\n",
+            "   - This notebook is probably dedicated to cryptocurrency research. It might include data analysis, market trend predictions, or sentiment analysis related to cryptocurrencies.\n",
+            "\n",
+            "4. **fixed_E_commerce_Shopping_Assistant.ipynb**:\n",
+            "   - This agent likely serves as a shopping assistant, possibly providing product recommendations, price comparisons, or personalized shopping experiences for e-commerce platforms.\n",
+            "\n",
+            "5. **fixed_Home_Buying_Real_Estate_Agent.ipynb**:\n",
+            "   - This notebook appears to be focused on the real estate market, potentially offering insights into property values, market trends, or personalized home-buying recommendations.\n",
+            "\n",
+            "6. **fixed_YouTube_Influencer_Intelligence_Agent.ipynb**:\n",
+            "   - This file likely deals with analyzing YouTube influencers, possibly providing insights into influencer performance, audience engagement, or content optimization strategies.\n",
+            "\n",
+            "7. **fixed_voiGno_Restaurant_Agent_PraisonAI.ipynb**:\n",
+            "   - This agent seems to be related to the restaurant industry, possibly offering services like menu optimization, customer feedback analysis, or operational efficiency improvements.\n",
+            "\n",
+            "**Overall Structure and Insights**:\n",
+            "- The repository appears to focus on developing intelligent agents across various domains, each tailored to specific industry needs.\n",
+            "- The use of Jupyter Notebooks suggests an emphasis on data analysis, visualization, and possibly machine learning or AI model development.\n",
+            "- The prefix \"fixed_\" in the file names might indicate that these are refined or updated versions of previous iterations.\n",
+            "- The diversity of domains covered (environmental, cognitive, financial, e-commerce, real estate, social media, and hospitality) suggests a broad application of AI and data-driven insights.\n",
+            "\n",
+            "These notebooks likely contain a mix of data preprocessing, model training, and evaluation, along with visualizations to support the findings and recommendations of each agent.\n"
+          ]
+        }
+      ],
+      "source": [
+        "repo = input(\"🔗 Enter GitHub repository URL: \")\n",
+        "print(\"\\n🧠 Agent Insight:\\n\", ask_agent(repo))"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.11"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

examples/cookbooks/personalized_learning_assistant.ipynb

@@ -0,0 +1,779 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "Ma_-6sDA-RaE"
+      },
+      "source": [
+        "# AI‑Powered Personalized Learning Assistant with Smart Content Chatbot\n",
+        "Powered by **praisonaiagents**, **OpenAI API**, and **Hugging Face Transformers**.\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "dSQ-cb--A7Ys"
+      },
+      "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/personalized_learning_assistant.ipynb)\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "mu7qWPtq_eOd"
+      },
+      "source": [
+        "# Dependencies"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "bPvUlNIV-RaK"
+      },
+      "outputs": [],
+      "source": [
+        "!pip install praisonaiagents openai transformers"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "Z_SH8eTwAf3v"
+      },
+      "source": [
+        "# Tools Used"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "ffqa_kI_ApwO"
+      },
+      "source": [
+        "✅ praisonaiagents – Builds the smart tutoring agent.\n",
+        "\n",
+        "✅ openai – Connects to OpenAI’s GPT for accurate responses.\n",
+        "\n",
+        "✅ Hugging Face transformers – Uses GPT-2 as a fallback if OpenAI isn’t available.\n",
+        "\n",
+        "✅Python I/O – Enables interactive chat using input() and print()."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "fYU4lvNV_jyp"
+      },
+      "source": [
+        "# Set Api Key"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "gXlxt_gz-RaL"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "os.environ['OPENAI_API_KEY'] = input('Enter your OpenAI API key: ')"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "yh4uKOB4_xQl"
+      },
+      "source": [
+        "# Main"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 258,
+          "referenced_widgets": [
+            "dc97b547b11b41c79f293032f84243a3",
+            "ff4335dceb3d4b3b8d13a04f5c0bff73",
+            "df648eb8626e40b5bc13ae58fff1b42e",
+            "c0061c2cf09c4d8f9d0dcd735e464c5d",
+            "bb1b511cc3b644bfa5ebcdc9fa3cc6b6",
+            "e204a3e4fd65431985317aa51287b15f",
+            "c884cfdd133e42fd8c8b54505b1494c6",
+            "b533995c6724481486c1a753ca1a1966",
+            "0b7c2014d0b3493c9b9d2325e0a846e1",
+            "16ade62581ac412dac0924574366e977",
+            "5e3ef88a547e418d9b5a26671c352fa6",
+            "7b71a29acb1f44ca93c962114163fcff",
+            "9723d0ca7c1f4abfb93bbbede0eb65d4",
+            "95a1b145785c4fd881a58961afd385e5",
+            "4a1acd18aad64a7a8d39bba617577ee4",
+            "0c82f0b829f049ab91fa9a81970917c5",
+            "c2f10a3ec48f41ad9c85941bdac0fdde",
+            "c1fd448e3cad48bc82f309eabd25d5c5",
+            "bb982458adec49608bf01c35ee6c36e5",
+            "843019e709cd40eb9afef212857f5dcb",
+            "c7d4261778a54645b1d3f793ddf25d19",
+            "f01403e275fb4ac7b90e4fc25695caa4",
+            "362e1762012341b180502fa68bb1d4c1",
+            "637a253c8a1049ceb3cb45eb38d435ff",
+            "3c583202d1ec4eac90387fad555c84c2",
+            "bad0f052849843f3a9b7c250da3a6138",
+            "8fdb3bee2379482fba84c8a8ee4b9950",
+            "5b5dc04fdd094565a49fd5df77455e81",
+            "806e3fc688704788a8350efae8175116",
+            "50ab46cbe06a42c1b6f7f2cc63af3ec2",
+            "47389688c19742f7b06f99ededd12890",
+            "d87a6ec5eeb44b2782350f44c7a7eb05",
+            "84f5fd3514e74389a333478bb9aa0f44",
+            "b9c7aa568136493797109b873ebe3616",
+            "ac18e246e59b4b2c82969d51c0f2298d",
+            "67d92a37e63b43b288aa4bdd552d61e1",
+            "0a033fe3fdf143dd804f04b9b97762d0",
+            "75975646a23c4196843aecc651cff6f1",
+            "e2458c89346541b29002f4fb92922488",
+            "7ca831df46234cb1b120ed6710998c22",
+            "eeadb7301f434e9fbcf0b38eb47336d7",
+            "d5225c830bf7456297fb69439bd43b54",
+            "03f44b7f997e4ef3a2b1054007ca4a4e",
+            "c63ed8fc81c54d7b92ecbbce9fdc950b",
+            "0808ee0189734b6ba992df2be9d4f15f",
+            "70fca3c1206a4bf9b442d8bf2e4368b8",
+            "e25e0dbf47e44d9cb22f309a83fe0707",
+            "e2a0fcc56c114159b931887a673c8bfe",
+            "a2d5263a5b6e4dd594d869e0a38c1fa1",
+            "715bbacb30d54d50ba6328e77bdbcffb",
+            "ecc05aff07b04b8fbce16dcea83008f8",
+            "9e0b0e71547e42ae91ba4d8e027744f4",
+            "1758ba511d564b9295cddf83f176d32b",
+            "3c6601ed2b494d01910e4f30043ef95d",
+            "de5a8ba940f742af8001f70c029b56b8",
+            "ea77452dd7d0402991cfadc717a47d19",
+            "a181f094d7184df5b747cafcdacb832a",
+            "dbf86357b88f485d816528361c8f31c7",
+            "6453702474fb4383889955a4ecda0168",
+            "2c380d372b394252a5b13fd5c9a7f4e8",
+            "0a92287900bf43e18df6d36ba17138cc",
+            "2dfd301479704b2eaa0784effa5be92f",
+            "301cd584eaa14333ab2e3c3b12181745",
+            "50f0b5c832a34c7ebfc9e9d741184786",
+            "7574fc34bcd14b059bb2d285fb147fe4",
+            "91cccc1c2d39422bb323da0d6f2448b0",
+            "db0c8ba302844fd5982c6ac996fbb868",
+            "52e1b827d7c84ed3b217d43cc014c22c",
+            "0187570a62f044eeb13426392ad173d9",
+            "050c6f7089d841abae0c85f656715dad",
+            "73d3092c22bb49a69984f190d002e2d0",
+            "f5f9136e41fa45a684eca1feebb84f07",
+            "9d9c38b4aa824b5ca456aff5bc469576",
+            "7514acf98dc54826a1e305caac9ec4d9",
+            "c8b83d6e35f4412d9990355105a0a65c",
+            "a0dfc6c2761846168663e689ecfa8752",
+            "d3687494bbd0465a99e7bb5fb62e36f8"
+          ]
+        },
+        "id": "XshcuLCO-RaM",
+        "outputId": "95d308ed-cb4a-402b-d755-afc8257afe34"
+      },
+      "outputs": [
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "dc97b547b11b41c79f293032f84243a3",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "config.json:   0%|          | 0.00/665 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "7b71a29acb1f44ca93c962114163fcff",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "model.safetensors:   0%|          | 0.00/548M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "362e1762012341b180502fa68bb1d4c1",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "generation_config.json:   0%|          | 0.00/124 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "b9c7aa568136493797109b873ebe3616",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer_config.json:   0%|          | 0.00/26.0 [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "0808ee0189734b6ba992df2be9d4f15f",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "vocab.json:   0%|          | 0.00/1.04M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "ea77452dd7d0402991cfadc717a47d19",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "merges.txt:   0%|          | 0.00/456k [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "db0c8ba302844fd5982c6ac996fbb868",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "tokenizer.json:   0%|          | 0.00/1.36M [00:00<?, ?B/s]"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stderr",
+          "output_type": "stream",
+          "text": [
+            "Device set to use cpu\n"
+          ]
+        }
+      ],
+      "source": [
+        "from praisonaiagents import Agent\n",
+        "from transformers import pipeline as hf_pipeline\n",
+        "import openai\n",
+        "\n",
+        "openai.api_key = os.getenv('OPENAI_API_KEY')\n",
+        "\n",
+        "# Fallback NLP tool\n",
+        "hf_chatbot = hf_pipeline('text-generation', model='gpt2')\n",
+        "\n",
+        "# Create smart Agent with praisonaiagents\n",
+        "agent = Agent(instructions='You are a friendly tutor. Answer learner questions clearly and helpfully.')\n",
+        "\n",
+        "def chat_with_ai(user_input):\n",
+        "    try:\n",
+        "        return agent.start(user_input)\n",
+        "    except Exception as e:\n",
+        "        print('[Fallback GPT-2] ', e)\n",
+        "        return hf_chatbot(user_input, max_length=100)[0]['generated_text']"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "colab": {
+          "base_uri": "https://localhost:8080/",
+          "height": 1000,
+          "referenced_widgets": [
+            "be1777343939486c941c1959f7632104",
+            "1e3a02318cb642cb9304dece111a70cc",
+            "7dca42e3bc724c6e9f63fd049a4539ea",
+            "5b4ade0a459e42d38bc3cf84f01f6538"
+          ]
+        },
+        "id": "vELE_tDT-RaN",
+        "outputId": "8ac6cf86-7894-47a0-b47b-cbc1cb474b41"
+      },
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "You: What is the Pythagorean theorem?\n"
+          ]
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Agent</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mAgent\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "be1777343939486c941c1959f7632104",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Output()"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+            ],
+            "text/plain": []
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 6.8s</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[2mResponse generated in 6.8s\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> What is the Pythagorean theorem?                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m What is the Pythagorean theorem?                                                                                \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> The Pythagorean theorem is a fundamental principle in geometry that relates to right-angled triangles. It       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> states that in a right-angled triangle, the square of the length of the hypotenuse (the side opposite the right <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> angle) is equal to the sum of the squares of the lengths of the other two sides. This can be expressed with the <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> formula:                                                                                                        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> [ a^2 + b^2 = c^2 ]                                                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Here, ( c ) represents the length of the hypotenuse, while ( a ) and ( b ) represent the lengths of the other   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> two sides. This theorem is useful for calculating the length of one side of a right triangle if the lengths of  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> the other two sides are known.                                                                                  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m The Pythagorean theorem is a fundamental principle in geometry that relates to right-angled triangles. It       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m states that in a right-angled triangle, the square of the length of the hypotenuse (the side opposite the right \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m angle) is equal to the sum of the squares of the lengths of the other two sides. This can be expressed with the \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m formula:                                                                                                        \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m [ a^2 + b^2 = c^2 ]                                                                                             \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m Here, ( c ) represents the length of the hypotenuse, while ( a ) and ( b ) represent the lengths of the other   \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m two sides. This theorem is useful for calculating the length of one side of a right triangle if the lengths of  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m the other two sides are known.                                                                                  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🤖 Tutor: The Pythagorean theorem is a fundamental principle in geometry that relates to right-angled triangles. It states that in a right-angled triangle, the square of the length of the hypotenuse (the side opposite the right angle) is equal to the sum of the squares of the lengths of the other two sides. This can be expressed with the formula:\n",
+            "\n",
+            "\\[ a^2 + b^2 = c^2 \\]\n",
+            "\n",
+            "Here, \\( c \\) represents the length of the hypotenuse, while \\( a \\) and \\( b \\) represent the lengths of the other two sides. This theorem is useful for calculating the length of one side of a right triangle if the lengths of the other two sides are known.\n",
+            "You: How does photosynthesis work?\n"
+          ]
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Agent</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mAgent\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "application/vnd.jupyter.widget-view+json": {
+              "model_id": "7dca42e3bc724c6e9f63fd049a4539ea",
+              "version_major": 2,
+              "version_minor": 0
+            },
+            "text/plain": [
+              "Output()"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+            ],
+            "text/plain": []
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 7.2s</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[2mResponse generated in 7.2s\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> How does photosynthesis work?                                                                                   <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m How does photosynthesis work?                                                                                   \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Photosynthesis is the process by which green plants, algae, and some bacteria convert light energy, usually     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> from the sun, into chemical energy stored in glucose. This process is essential for life on Earth as it         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> provides the oxygen we breathe and forms the base of the food chain. Here's how it works:                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 1 </span><span style=\"font-weight: bold\">Light Absorption</span>: Photosynthesis begins when chlorophyll, the green pigment in plant cells, absorbs          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>sunlight. This primarily occurs in the chloroplasts of plant cells.                                          <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 2 </span><span style=\"font-weight: bold\">Water Splitting (Photolysis)</span>: The absorbed light energy is used to split water molecules (H₂O) into oxygen,  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>protons, and electrons. This reaction releases oxygen as a byproduct, which is expelled into the atmosphere. <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 3 </span><span style=\"font-weight: bold\">Energy Conversion (Light Reactions)</span>: The electrons and protons generated from water splitting are used in    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>the light-dependent reactions. These reactions occur in the thylakoid membranes of the chloroplasts and      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>result in the production of ATP (adenosine triphosphate) and NADPH, which are energy carriers.               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 4 </span><span style=\"font-weight: bold\">Carbon Fixation (Calvin Cycle)</span>: In the light-independent reactions, also known as the Calvin Cycle, ATP and  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>NADPH produced in the light reactions are used to convert carbon dioxide (CO₂) from the atmosphere into      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>glucose (C₆H₁₂O₆). This process occurs in the stroma of the chloroplasts.                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> 5 </span><span style=\"font-weight: bold\">Glucose Formation</span>: The glucose produced can be used immediately by the plant for energy or can be converted  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\">   </span>into other carbohydrates, such as starch, for storage.                                                       <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Overall, the simplified equation for photosynthesis is:                                                         <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> [ 6CO₂ + 6H₂O + light \\ energy \\rightarrow C₆H₁₂O₆ + 6O₂ ]                                                      <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> This equation shows that carbon dioxide and water, in the presence of light energy, are transformed into        <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> glucose and oxygen.                                                                                             <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m Photosynthesis is the process by which green plants, algae, and some bacteria convert light energy, usually     \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m from the sun, into chemical energy stored in glucose. This process is essential for life on Earth as it         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m provides the oxygen we breathe and forms the base of the food chain. Here's how it works:                       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 1 \u001b[0m\u001b[1mLight Absorption\u001b[0m: Photosynthesis begins when chlorophyll, the green pigment in plant cells, absorbs          \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0msunlight. This primarily occurs in the chloroplasts of plant cells.                                          \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 2 \u001b[0m\u001b[1mWater Splitting (Photolysis)\u001b[0m: The absorbed light energy is used to split water molecules (H₂O) into oxygen,  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mprotons, and electrons. This reaction releases oxygen as a byproduct, which is expelled into the atmosphere. \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 3 \u001b[0m\u001b[1mEnergy Conversion (Light Reactions)\u001b[0m: The electrons and protons generated from water splitting are used in    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mthe light-dependent reactions. These reactions occur in the thylakoid membranes of the chloroplasts and      \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mresult in the production of ATP (adenosine triphosphate) and NADPH, which are energy carriers.               \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 4 \u001b[0m\u001b[1mCarbon Fixation (Calvin Cycle)\u001b[0m: In the light-independent reactions, also known as the Calvin Cycle, ATP and  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mNADPH produced in the light reactions are used to convert carbon dioxide (CO₂) from the atmosphere into      \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0mglucose (C₆H₁₂O₆). This process occurs in the stroma of the chloroplasts.                                    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m 5 \u001b[0m\u001b[1mGlucose Formation\u001b[0m: The glucose produced can be used immediately by the plant for energy or can be converted  \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m \u001b[1;33m   \u001b[0minto other carbohydrates, such as starch, for storage.                                                       \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m Overall, the simplified equation for photosynthesis is:                                                         \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m [ 6CO₂ + 6H₂O + light \\ energy \\rightarrow C₆H₁₂O₆ + 6O₂ ]                                                      \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m This equation shows that carbon dioxide and water, in the presence of light energy, are transformed into        \u001b[36m│\u001b[0m\n",
+              "\u001b[36m│\u001b[0m glucose and oxygen.                                                                                             \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🤖 Tutor: Photosynthesis is the process by which green plants, algae, and some bacteria convert light energy, usually from the sun, into chemical energy stored in glucose. This process is essential for life on Earth as it provides the oxygen we breathe and forms the base of the food chain. Here's how it works:\n",
+            "\n",
+            "1. **Light Absorption**: Photosynthesis begins when chlorophyll, the green pigment in plant cells, absorbs sunlight. This primarily occurs in the chloroplasts of plant cells.\n",
+            "\n",
+            "2. **Water Splitting (Photolysis)**: The absorbed light energy is used to split water molecules (H₂O) into oxygen, protons, and electrons. This reaction releases oxygen as a byproduct, which is expelled into the atmosphere.\n",
+            "\n",
+            "3. **Energy Conversion (Light Reactions)**: The electrons and protons generated from water splitting are used in the light-dependent reactions. These reactions occur in the thylakoid membranes of the chloroplasts and result in the production of ATP (adenosine triphosphate) and NADPH, which are energy carriers.\n",
+            "\n",
+            "4. **Carbon Fixation (Calvin Cycle)**: In the light-independent reactions, also known as the Calvin Cycle, ATP and NADPH produced in the light reactions are used to convert carbon dioxide (CO₂) from the atmosphere into glucose (C₆H₁₂O₆). This process occurs in the stroma of the chloroplasts.\n",
+            "\n",
+            "5. **Glucose Formation**: The glucose produced can be used immediately by the plant for energy or can be converted into other carbohydrates, such as starch, for storage.\n",
+            "\n",
+            "Overall, the simplified equation for photosynthesis is:\n",
+            "\n",
+            "\\[ 6CO₂ + 6H₂O + light \\ energy \\rightarrow C₆H₁₂O₆ + 6O₂ \\]\n",
+            "\n",
+            "This equation shows that carbon dioxide and water, in the presence of light energy, are transformed into glucose and oxygen.\n",
+            "You: stop\n"
+          ]
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Agent</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+              "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mAgent\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+              "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+            ],
+            "text/plain": []
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 0.5s</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[2mResponse generated in 0.5s\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> stop                                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m stop                                                                                                            \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "data": {
+            "text/html": [
+              "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> If you have any more questions or need further assistance, feel free to ask!                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+              "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+              "</pre>\n"
+            ],
+            "text/plain": [
+              "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+              "\u001b[36m│\u001b[0m If you have any more questions or need further assistance, feel free to ask!                                    \u001b[36m│\u001b[0m\n",
+              "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+            ]
+          },
+          "metadata": {},
+          "output_type": "display_data"
+        },
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "🤖 Tutor: If you have any more questions or need further assistance, feel free to ask!\n",
+            "You: exit\n",
+            "Goodbye! Happy learning!\n"
+          ]
+        }
+      ],
+      "source": [
+        "while True:\n",
+        "    user_input = input('You: ')\n",
+        "    if user_input.lower() in ['exit','quit']:\n",
+        "        print('Goodbye! Happy learning!')\n",
+        "        break\n",
+        "    response = chat_with_ai(user_input)\n",
+        "    print('🤖 Tutor:', response)"
+      ]
+    }
+  ],
+  "metadata": {
+    "colab": {
+      "provenance": []
+    },
+    "kernelspec": {
+      "display_name": "Python 3",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

examples/cookbooks/voiGno_Restaurant_Agent_PraisonAI.ipynb

@@ -0,0 +1,467 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "6068ab0d",
+   "metadata": {
+    "id": "6068ab0d"
+   },
+   "source": [
+    "# voiGno Restaurant Agent – Voice Booking System with Interruption Handling"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "Y9FkDzt1lF47",
+   "metadata": {
+    "id": "Y9FkDzt1lF47"
+   },
+   "source": [
+    "This notebook implements a conversational restaurant booking assistant using the Praison AI Agent framework. It handles natural interruptions such as modifying guest count or changing time mid-conversation. Built for Google Colab Free Tier, it uses OpenAI's GPT-4o model and follows a YAML-based agent design for clarity and modularity."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7Ik-GsSjlPza",
+   "metadata": {
+    "id": "7Ik-GsSjlPza"
+   },
+   "source": [
+    "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/voiGno_Restaurant_Agent_PraisonAI.ipynb)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "vOsFg5C0lNg8",
+   "metadata": {
+    "id": "vOsFg5C0lNg8"
+   },
+   "source": [
+    "# Dependencies"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "c5b33646",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "c5b33646",
+    "outputId": "3728c81a-e8f4-4fce-e2da-2723937df0b5"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[?25l   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/3.3 MB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K   \u001b[91m━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.3/3.3 MB\u001b[0m \u001b[31m9.9 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K   \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━\u001b[0m \u001b[32m2.4/3.3 MB\u001b[0m \u001b[31m35.4 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K   \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m3.3/3.3 MB\u001b[0m \u001b[31m32.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25h"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install -q openai duckduckgo_search praisonaiagents"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5wUAjCAwlX-k",
+   "metadata": {
+    "id": "5wUAjCAwlX-k"
+   },
+   "source": [
+    "# OpenAI API + Imports"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "c8dbd157",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/"
+    },
+    "id": "c8dbd157",
+    "outputId": "2d9209c8-87a1-4093-bcbe-6f53b83867a1"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Enter your OpenAI API key: ··········\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "from getpass import getpass\n",
+    "\n",
+    "os.environ[\"OPENAI_API_KEY\"] = getpass(\"Enter your OpenAI API key: \")\n",
+    "import openai\n",
+    "from praisonaiagents import Agent, Task, PraisonAIAgents\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1qEN4kLNlcMq",
+   "metadata": {
+    "id": "1qEN4kLNlcMq"
+   },
+   "source": [
+    "# YAML Prompt Configuration"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "7d20ac12",
+   "metadata": {
+    "id": "7d20ac12"
+   },
+   "outputs": [],
+   "source": [
+    "yaml_prompt = \"\"\"\n",
+    "name: voiGnoRestaurantAgent\n",
+    "role: Voice restaurant booking assistant with interruption handling\n",
+    "goal: Coordinate bookings—date, time, guest count—with dynamic corrections\n",
+    "backstory: You are a friendly, patient assistant that remembers and adapts conversation context.\n",
+    "skills:\n",
+    "  - Context management\n",
+    "  - Handling mid-conversation changes\n",
+    "  - Summarizing confirmed reservations\n",
+    "llm: gpt-4o\n",
+    "verbosity: true\n",
+    "format: markdown\n",
+    "\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "XcJsL2yple6S",
+   "metadata": {
+    "id": "XcJsL2yple6S"
+   },
+   "source": [
+    "# Define Agent"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "jPfTEPRkkvl8",
+   "metadata": {
+    "id": "jPfTEPRkkvl8"
+   },
+   "outputs": [],
+   "source": [
+    "agent = Agent(\n",
+    "    name=\"voiGnoRestaurantAgent\",\n",
+    "    instructions=\"\"\"\n",
+    "You are a restaurant booking assistant. Handle booking requests naturally,\n",
+    "manage corrections like “change to 3 guests” or “move to 8 PM,”\n",
+    "confirm the details once the user is satisfied. Respond in markdown.\n",
+    "\"\"\",\n",
+    "    llm=\"gpt-4o\",\n",
+    "    verbose=True,\n",
+    "    markdown=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "okUezUadlhl4",
+   "metadata": {
+    "id": "okUezUadlhl4"
+   },
+   "source": [
+    "# Define Task"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "e1de31ba",
+   "metadata": {
+    "id": "e1de31ba"
+   },
+   "outputs": [],
+   "source": [
+    "task = Task(\n",
+    "    name=\"VoiceBookingTask\",\n",
+    "    description=\"Assist user in making or updating a restaurant booking with interruptions.\",\n",
+    "    expected_output=\"A markdown-style conversation confirming updated booking details.\",\n",
+    "    agent=agent\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "TmgIxwgZlkI3",
+   "metadata": {
+    "id": "TmgIxwgZlkI3"
+   },
+   "source": [
+    "# Build Agent System"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "1ca36e92",
+   "metadata": {
+    "id": "1ca36e92"
+   },
+   "outputs": [],
+   "source": [
+    "booking_system = PraisonAIAgents(\n",
+    "    agents=[agent],\n",
+    "    tasks=[task],\n",
+    "    process=\"sequential\",\n",
+    "    verbose=True\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "D-OG_N_0loEw",
+   "metadata": {
+    "id": "D-OG_N_0loEw"
+   },
+   "source": [
+    "# Run Example Dialogue"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "A56Lhv0Lk5AT",
+   "metadata": {
+    "colab": {
+     "base_uri": "https://localhost:8080/",
+     "height": 1000,
+     "referenced_widgets": [
+      "c605e612d0c9466e90451701534dac7b",
+      "d77b8417c8c046fbb680d2f35c83a95b"
+     ]
+    },
+    "id": "A56Lhv0Lk5AT",
+    "outputId": "a8d64995-03c7-4faa-d08b-ce66757d47b4"
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "> You: I'd like to book a table for 2 at 7 PM tomorrow.\n"
+     ]
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╭─ </span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8; font-weight: bold\">Agent Info</span><span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\"> ────────────────────────────────────────────────────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #ff9b9b; text-decoration-color: #ff9b9b; font-weight: bold\">👤 Agent:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">voiGnoRestaurantAgent</span>                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>  <span style=\"color: #b4b4b3; text-decoration-color: #b4b4b3; font-weight: bold\">Role:</span> <span style=\"color: #ffe5e5; text-decoration-color: #ffe5e5\">Assistant</span>                                                                                                <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>                                                                                                                 <span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">│</span>\n",
+       "<span style=\"color: #d2e3c8; text-decoration-color: #d2e3c8\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[38;2;210;227;200m╭─\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[1;38;2;210;227;200mAgent Info\u001b[0m\u001b[38;2;210;227;200m \u001b[0m\u001b[38;2;210;227;200m───────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;210;227;200m─╮\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;255;155;155m👤 Agent:\u001b[0m \u001b[38;2;255;229;229mvoiGnoRestaurantAgent\u001b[0m                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m  \u001b[1;38;2;180;180;179mRole:\u001b[0m \u001b[38;2;255;229;229mAssistant\u001b[0m                                                                                                \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m│\u001b[0m                                                                                                                 \u001b[38;2;210;227;200m│\u001b[0m\n",
+       "\u001b[38;2;210;227;200m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "c605e612d0c9466e90451701534dac7b",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Output()"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"></pre>\n"
+      ],
+      "text/plain": []
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #7f7f7f; text-decoration-color: #7f7f7f\">Response generated in 2.9s</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[2mResponse generated in 2.9s\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭───────────────────────────────────────────────────── Task ──────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> You need to do the following task: Assist user in making or updating a restaurant booking with interruptions..  <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Expected Output: A markdown-style conversation confirming updated booking details.. Please provide only the     <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> final result of your work. Do not add any conversation or extra explanation.                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m────────────────────────────────────────────────────\u001b[0m\u001b[36m Task \u001b[0m\u001b[36m─────────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m You need to do the following task: Assist user in making or updating a restaurant booking with interruptions..  \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Expected Output: A markdown-style conversation confirming updated booking details.. Please provide only the     \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m final result of your work. Do not add any conversation or extra explanation.                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"color: #008080; text-decoration-color: #008080\">╭─────────────────────────────────────────────────── Response ────────────────────────────────────────────────────╮</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"font-weight: bold\">Booking Confirmation</span>                                                                                            <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> Your restaurant booking has been successfully updated. Here are the details:                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Date:</span> [Please specify the date]                                                                              <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Time:</span> 8:00 PM                                                                                                <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> <span style=\"color: #808000; text-decoration-color: #808000; font-weight: bold\"> • </span><span style=\"font-weight: bold\">Guests:</span> 3                                                                                                    <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span>                                                                                                                 <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">│</span> If you need further assistance, feel free to ask!                                                               <span style=\"color: #008080; text-decoration-color: #008080\">│</span>\n",
+       "<span style=\"color: #008080; text-decoration-color: #008080\">╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</span>\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[36m╭─\u001b[0m\u001b[36m──────────────────────────────────────────────────\u001b[0m\u001b[36m Response \u001b[0m\u001b[36m───────────────────────────────────────────────────\u001b[0m\u001b[36m─╮\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1mBooking Confirmation\u001b[0m                                                                                            \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m Your restaurant booking has been successfully updated. Here are the details:                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mDate:\u001b[0m [Please specify the date]                                                                              \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mTime:\u001b[0m 8:00 PM                                                                                                \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m \u001b[1;33m • \u001b[0m\u001b[1mGuests:\u001b[0m 3                                                                                                    \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m                                                                                                                 \u001b[36m│\u001b[0m\n",
+       "\u001b[36m│\u001b[0m If you need further assistance, feel free to ask!                                                               \u001b[36m│\u001b[0m\n",
+       "\u001b[36m╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\u001b[0m\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "**Booking Confirmation**\n",
+      "\n",
+      "Your restaurant booking has been successfully updated. Here are the details:\n",
+      "\n",
+      "- **Date:** [Please specify the date]\n",
+      "- **Time:** 8:00 PM\n",
+      "- **Guests:** 3\n",
+      "\n",
+      "If you need further assistance, feel free to ask! \n",
+      "\n",
+      "> You: Wait, actually make that 3 people instead.\n",
+      "**Booking Confirmation**\n",
+      "\n",
+      "Your restaurant booking has been successfully updated. Here are the details:\n",
+      "\n",
+      "- **Date:** [Please specify the date]\n",
+      "- **Time:** 8:00 PM\n",
+      "- **Guests:** 3\n",
+      "\n",
+      "If you need further assistance, feel free to ask! \n",
+      "\n",
+      "> You: Can we move it to 8 PM?\n",
+      "**Booking Confirmation**\n",
+      "\n",
+      "Your restaurant booking has been successfully updated. Here are the details:\n",
+      "\n",
+      "- **Date:** [Please specify the date]\n",
+      "- **Time:** 8:00 PM\n",
+      "- **Guests:** 3\n",
+      "\n",
+      "If you need further assistance, feel free to ask! \n",
+      "\n",
+      "> You: Great, that's perfect!\n",
+      "**Booking Confirmation**\n",
+      "\n",
+      "Your restaurant booking has been successfully updated. Here are the details:\n",
+      "\n",
+      "- **Date:** [Please specify the date]\n",
+      "- **Time:** 8:00 PM\n",
+      "- **Guests:** 3\n",
+      "\n",
+      "If you need further assistance, feel free to ask! \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "dialog = [\n",
+    "    \"I'd like to book a table for 2 at 7 PM tomorrow.\",\n",
+    "    \"Wait, actually make that 3 people instead.\",\n",
+    "    \"Can we move it to 8 PM?\",\n",
+    "    \"Great, that's perfect!\"\n",
+    "]\n",
+    "\n",
+    "for turn in dialog:\n",
+    "    print(f\"> You: {turn}\")\n",
+    "    response = booking_system.start(input=turn)\n",
+    "    print(response, \"\\n\")\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/python/api/secondary-market-research-api.py

@@ -269,7 +269,7 @@ async def generate_market_research_report(job_id: str, config: MarketResearchCon
         workflow = PraisonAIAgents(
             agents=list(agents.values()),
             tasks=tasks,
-            process="workflow",
+            process="sequential",
             verbose=False
         )
         
@@ -296,14 +296,92 @@ async def generate_market_research_report(job_id: str, config: MarketResearchCon
             "research_findings": {}
         }
         
-        # Extract results from each task
-        if "task_results" in results:
-            for task_name, result in results["task_results"].items():
-                if result:
-                    report_data["research_findings"][task_name] = {
-                        "content": result.raw,
-                        "agent": result.agent if hasattr(result, 'agent') else "Unknown"
-                    }
+        # Extract results from each task with comprehensive logging
+        print(f"DEBUG: Raw results type: {type(results)}")
+        print(f"DEBUG: Raw results content: {results}")
+        
+        if isinstance(results, str):
+            # Sequential process returns a string result directly
+            print("DEBUG: Sequential process returned string result")
+            report_data["research_findings"]["synthesis_report"] = {
+                "content": results,
+                "agent": "Research Report Synthesizer",
+                "section": "Complete Market Research Report"
+            }
+            print(f"DEBUG: Added synthesis_report with content length: {len(results)}")
+            
+        elif isinstance(results, dict):
+            print(f"DEBUG: Results is dict with keys: {list(results.keys())}")
+            
+            if "task_results" in results:
+                print(f"DEBUG: Found task_results: {results['task_results']}")
+                print(f"DEBUG: task_results type: {type(results['task_results'])}")
+                
+                for task_name, result in results["task_results"].items():
+                    print(f"DEBUG: Processing task '{task_name}', result type: {type(result)}")
+                    print(f"DEBUG: Result content: {result}")
+                    
+                    if result:
+                        # Try multiple ways to extract content
+                        content = None
+                        agent_name = "Unknown"
+                        
+                        if hasattr(result, 'raw'):
+                            content = result.raw
+                            print(f"DEBUG: Extracted content from result.raw")
+                        elif hasattr(result, 'content'):
+                            content = result.content
+                            print(f"DEBUG: Extracted content from result.content")
+                        elif isinstance(result, str):
+                            content = result
+                            print(f"DEBUG: Result is string, using directly")
+                        else:
+                            content = str(result)
+                            print(f"DEBUG: Converting result to string")
+                        
+                        if hasattr(result, 'agent'):
+                            agent_name = result.agent
+                        elif hasattr(result, 'agent_name'):
+                            agent_name = result.agent_name
+                            
+                        if content:
+                            report_data["research_findings"][task_name] = {
+                                "content": content,
+                                "agent": agent_name,
+                                "section": f"Task {task_name}"
+                            }
+                            print(f"DEBUG: Added task '{task_name}' with content length: {len(str(content))}")
+                        else:
+                            print(f"DEBUG: No content found for task '{task_name}'")
+                    else:
+                        print(f"DEBUG: Task '{task_name}' result is None or empty")
+            else:
+                print("DEBUG: No 'task_results' found in results dict")
+                # Try to use the whole results as content
+                report_data["research_findings"]["workflow_output"] = {
+                    "content": str(results),
+                    "agent": "PraisonAI Workflow",
+                    "section": "Complete Workflow Output"
+                }
+                print("DEBUG: Added entire results as workflow_output")
+        else:
+            print(f"DEBUG: Unexpected results type: {type(results)}")
+            report_data["research_findings"]["raw_output"] = {
+                "content": str(results),
+                "agent": "Unknown",
+                "section": "Raw Output"
+            }
+        
+        print(f"DEBUG: Final research_findings keys: {list(report_data['research_findings'].keys())}")
+        print(f"DEBUG: Final research_findings count: {len(report_data['research_findings'])}")
+        
+        # Generate executive summary from synthesis if available
+        if "synthesis_report" in report_data["research_findings"]:
+            content = report_data["research_findings"]["synthesis_report"]["content"]
+            # Extract first few sentences as executive summary
+            sentences = content.split('. ')[:3]
+            report_data["executive_summary"] = '. '.join(sentences) + '.' if sentences else "Market research analysis completed."
+            print("DEBUG: Generated executive summary from synthesis report")
         
         # Save report to file
         report_filename = f"market_research_{job_id}.json"

examples/python/providers/ollama/ollama-base-url-example.py

@@ -0,0 +1,34 @@
+# Example: Using Ollama with a remote host via base_url parameter
+# pip install praisonaiagents
+
+from praisonaiagents import Agent
+
+# Method 1: Using base_url parameter directly (NEW)
+agent = Agent(
+    instructions="You are a helpful assistant",
+    llm="ollama/llama3.2",
+    base_url="http://remote-host:11434"
+)
+
+response = agent.start("Why is the sky blue?")
+print(response)
+
+# Method 2: Using dict configuration
+agent2 = Agent(
+    instructions="You are a helpful assistant",
+    llm={
+        "model": "ollama/llama3.2",
+        "base_url": "http://remote-host:11434"
+    }
+)
+
+response2 = agent2.start("What is the capital of France?")
+print(response2)
+
+# Method 3: Using environment variable (existing method)
+# export OPENAI_BASE_URL=http://remote-host:11434
+# Then just:
+# agent3 = Agent(
+#     instructions="You are a helpful assistant",
+#     llm="ollama/llama3.2"
+# )

examples/python/remote/README.md

@@ -0,0 +1,170 @@
+# Remote Agent Connectivity
+
+This directory contains examples demonstrating PraisonAI's remote agent connectivity feature, which allows you to connect to agents running on different servers, similar to Google ADK's agent connectivity pattern.
+
+## Overview
+
+The remote agent connectivity feature enables:
+- **Direct agent-to-agent connectivity** across networks
+- **Session-based communication** with remote agents  
+- **Google ADK-like API patterns** for familiar usage
+- **Automatic connection management** and error handling
+
+## Quick Start
+
+### 1. Start a Remote Agent Server
+
+```bash
+# Start a simple remote agent server
+python remote_agent_server.py
+
+# Or start multiple agents on one server
+python remote_agent_server.py --multiple
+```
+
+### 2. Connect from Client
+
+```python
+from praisonaiagents import Session
+
+# Connect to remote agent (similar to Google ADK)
+session = Session(agent_url="192.168.1.10:8000/agent")
+
+# Send messages to the remote agent
+response = session.chat("Hello from the client!")
+print(response)
+
+# Alternative method (Google ADK pattern)  
+response = session.send_message("What can you help me with?")
+print(response)
+```
+
+## Examples
+
+- **`remote_agent_server.py`** - Set up agents as remote servers
+- **`remote_agent_example.py`** - Connect to and communicate with remote agents
+
+## API Comparison
+
+### Google ADK Pattern
+```python
+from adk.agent import Agent
+from adk.session import Session
+
+session = Session(agent_url="192.168.1.10:8000")
+response = session.send_message("Hello!")
+```
+
+### PraisonAI Pattern  
+```python
+from praisonaiagents import Session
+
+session = Session(agent_url="192.168.1.10:8000/agent")
+response = session.chat("Hello!")
+# OR
+response = session.send_message("Hello!")  # Google ADK compatibility
+```
+
+## Key Features
+
+### ✅ **Seamless Connectivity**
+- Automatic protocol detection (http/https)
+- Connection testing and validation
+- Configurable timeouts
+
+### ✅ **Error Handling**
+- Clear error messages for connection issues
+- Graceful handling of network problems
+- Appropriate fallbacks for unavailable services
+
+### ✅ **Backward Compatibility**
+- Existing local agent functionality unchanged
+- Session API works for both local and remote scenarios
+- No breaking changes to current code
+
+### ✅ **Flexible Configuration**
+- Support for IP:port format (`192.168.1.10:8000`)
+- Full URL format (`http://server.com:8000/agent`)
+- Customizable endpoints and paths
+
+## Usage Patterns
+
+### Single Remote Agent
+```python
+# Connect to a specific remote agent
+session = Session(agent_url="192.168.1.10:8000/agent")
+response = session.chat("Hello from remote client!")
+```
+
+### Multiple Remote Agents
+```python
+# Connect to different specialized agents
+research_session = Session(agent_url="192.168.1.10:8000/research")
+coding_session = Session(agent_url="192.168.1.10:8000/coding")
+
+research_response = research_session.chat("Find info about AI trends")
+coding_response = coding_session.chat("Help me debug this Python code")
+```
+
+### Error Handling
+```python
+try:
+    session = Session(agent_url="192.168.1.10:8000/agent")
+    response = session.chat("Test message")
+    print(f"Response: {response}")
+except ConnectionError as e:
+    print(f"Failed to connect: {e}")
+```
+
+## Network Configuration
+
+### Server Setup
+```python
+# Create and launch agent server
+agent = Agent(name="RemoteAgent", role="Assistant")
+agent.launch(path="/agent", port=8000, host="0.0.0.0")
+```
+
+### Client Connection
+```python
+# Connect from any network location
+session = Session(agent_url="<server-ip>:8000/agent")
+```
+
+## Limitations for Remote Sessions
+
+When using remote agent sessions, certain local operations are not available:
+- **Memory operations** (`session.memory.*`)
+- **Knowledge operations** (`session.knowledge.*`) 
+- **Local agent creation** (`session.Agent(...)`)
+- **State management** (`session.save_state/restore_state`)
+
+This design keeps remote and local operations clearly separated.
+
+## Testing
+
+Run the examples to test the functionality:
+
+```bash
+# Terminal 1: Start server
+python remote_agent_server.py
+
+# Terminal 2: Test client (update IP as needed)
+python remote_agent_example.py
+```
+
+## Integration with Existing Code
+
+The remote connectivity feature integrates seamlessly with existing PraisonAI code:
+
+```python
+# Existing local code works unchanged
+local_session = Session(session_id="local_chat")
+local_agent = local_session.Agent(name="LocalAgent", role="Assistant")
+
+# New remote connectivity
+remote_session = Session(agent_url="remote-server:8000/agent")
+remote_response = remote_session.chat("Hello from remote!")
+```
+
+This provides a smooth migration path for applications that need to scale across multiple servers.

examples/python/remote/remote_agent_example.py

@@ -0,0 +1,141 @@
+#!/usr/bin/env python3
+"""
+Remote Agent Connectivity Example
+
+This example demonstrates how to connect to agents running on remote servers,
+similar to Google ADK's agent connectivity pattern.
+
+Usage:
+1. First, start a remote agent server:
+   python remote_agent_server.py
+
+2. Then run this client to connect to it:
+   python remote_agent_example.py
+"""
+
+from praisonaiagents import Session
+import time
+
+def example_remote_agent_connection():
+    """
+    Example demonstrating remote agent connectivity similar to Google ADK.
+    """
+    print("🌐 Remote Agent Connectivity Example")
+    print("=" * 50)
+    
+    # Example 1: Connect to remote agent using IP:port format
+    try:
+        print("\n1. Connecting to remote agent at 192.168.1.10:8000...")
+        
+        # Create a session with remote agent URL (similar to Google ADK)
+        session = Session(agent_url="192.168.1.10:8000/agent")
+        
+        print(f"✅ Connected! Session: {session}")
+        
+        # Send a message to the remote agent
+        response = session.chat("Hello from the client!")
+        print(f"📨 Sent: 'Hello from the client!'")
+        print(f"📨 Received: {response}")
+        
+        # Send another message using the alias method (Google ADK pattern)
+        response = session.send_message("What can you help me with?")
+        print(f"📨 Sent: 'What can you help me with?'")
+        print(f"📨 Received: {response}")
+        
+    except ConnectionError as e:
+        print(f"❌ Connection failed: {e}")
+        print("💡 Make sure the remote agent server is running at 192.168.1.10:8000")
+    
+    # Example 2: Connect to localhost for testing
+    try:
+        print("\n2. Connecting to localhost for testing...")
+        
+        # Connect to local server (for testing)
+        session = Session(agent_url="localhost:8000/agent")
+        
+        print(f"✅ Connected! Session: {session}")
+        
+        # Test the connection
+        response = session.chat("Test message")
+        print(f"📨 Response: {response}")
+        
+    except ConnectionError as e:
+        print(f"❌ Connection failed: {e}")
+        print("💡 Start a local agent server first with: python remote_agent_server.py")
+
+def example_error_handling():
+    """
+    Example demonstrating error handling for remote sessions.
+    """
+    print("\n\n🚨 Error Handling Examples")
+    print("=" * 50)
+    
+    try:
+        # Create a remote session
+        session = Session(agent_url="localhost:8000/agent")
+        
+        # These operations are not available for remote sessions
+        print("\n❌ Attempting to access memory (should fail)...")
+        session.memory.store_short_term("test")
+        
+    except ConnectionError:
+        print("⚠️  Cannot connect to remote agent (expected if server not running)")
+    except ValueError as e:
+        print(f"✅ Correctly caught error: {e}")
+    
+    try:
+        session = Session(agent_url="localhost:8000/agent")
+        print("\n❌ Attempting to create local agent (should fail)...")
+        agent = session.Agent(name="Test", role="Assistant")
+        
+    except ConnectionError:
+        print("⚠️  Cannot connect to remote agent (expected if server not running)")
+    except ValueError as e:
+        print(f"✅ Correctly caught error: {e}")
+
+def comparison_with_google_adk():
+    """
+    Shows the comparison between Google ADK and PraisonAI patterns.
+    """
+    print("\n\n🔄 Comparison with Google ADK")
+    print("=" * 50)
+    
+    print("\n📋 Google ADK Pattern:")
+    print("""
+    from adk.agent import Agent
+    from adk.session import Session
+
+    # Connect to remote agent
+    session = Session(agent_url="192.168.1.10:8000")
+    response = session.send_message("Hello from client!")
+    """)
+    
+    print("📋 PraisonAI Pattern:")
+    print("""
+    from praisonaiagents import Session
+
+    # Connect to remote agent
+    session = Session(agent_url="192.168.1.10:8000/agent")
+    response = session.chat("Hello from client!")
+    # OR
+    response = session.send_message("Hello from client!")
+    """)
+    
+    print("✨ Key similarities:")
+    print("• Direct agent URL connectivity")
+    print("• Simple session-based API")
+    print("• Similar message sending patterns")
+    print("• Error handling for connection issues")
+
+if __name__ == "__main__":
+    example_remote_agent_connection()
+    example_error_handling()
+    comparison_with_google_adk()
+    
+    print("\n\n🎯 Summary")
+    print("=" * 50)
+    print("✅ Remote agent connectivity implemented")
+    print("✅ Google ADK-like API pattern supported")  
+    print("✅ Backward compatibility maintained")
+    print("✅ Proper error handling for remote sessions")
+    print("\n💡 To test with a real server, run remote_agent_server.py first!")

examples/python/remote/remote_agent_server.py

@@ -0,0 +1,103 @@
+#!/usr/bin/env python3
+"""
+Remote Agent Server Example
+
+This example demonstrates how to set up an agent as a remote server
+that can be accessed by other clients using the Session(agent_url=...) pattern.
+
+Usage:
+    python remote_agent_server.py
+
+Then connect from another machine/process:
+    python remote_agent_example.py
+"""
+
+from praisonaiagents import Agent
+import time
+
+def setup_remote_agent_server():
+    """
+    Set up an agent as a remote server accessible via HTTP API.
+    """
+    print("🚀 Setting up Remote Agent Server")
+    print("=" * 50)
+    
+    # Create an agent that will serve as the remote agent
+    agent = Agent(
+        name="RemoteAssistant",
+        role="Helpful Remote AI Assistant", 
+        goal="Assist users with their queries via remote connections",
+        backstory="I am an AI assistant running on a remote server, ready to help clients connect and interact with me.",
+        llm="gpt-4o-mini",  # or any other supported model
+        verbose=True
+    )
+    
+    print(f"📝 Created agent: {agent}")
+    print(f"🔧 Agent details:")
+    print(f"   • Name: {agent.name}")
+    print(f"   • Role: {agent.role}")
+    print(f"   • Goal: {agent.goal}")
+    
+    # Launch the agent as an HTTP API server
+    print(f"\n🌐 Launching agent server...")
+    print(f"📡 Server will be accessible at:")
+    print(f"   • Local: http://localhost:8000/agent")
+    print(f"   • Network: http://<your-ip>:8000/agent")
+    print(f"\n🔗 Clients can connect using:")
+    print(f"   session = Session(agent_url='<server-ip>:8000/agent')")
+    print(f"\n⏹️  Press Ctrl+C to stop the server")
+    print("=" * 50)
+    
+    # This will start the HTTP server and block until interrupted
+    try:
+        agent.launch(path="/agent", port=8000, host="0.0.0.0")
+    except KeyboardInterrupt:
+        print("\n\n🛑 Server stopped by user")
+    except Exception as e:
+        print(f"\n❌ Server error: {e}")
+
+def setup_multiple_agents():
+    """
+    Example of setting up multiple agents on the same server.
+    """
+    print("🚀 Setting up Multiple Remote Agents")
+    print("=" * 50)
+    
+    # Create different specialized agents
+    research_agent = Agent(
+        name="ResearchAgent",
+        role="Research Specialist",
+        instructions="You are a research specialist who helps with finding and analyzing information."
+    )
+    
+    coding_agent = Agent(
+        name="CodingAgent", 
+        role="Programming Assistant",
+        instructions="You are a programming assistant who helps with coding questions and debugging."
+    )
+    
+    # Launch them on different endpoints
+    print("🌐 Launching multiple agents:")
+    print("📡 Research Agent: http://localhost:8000/research")
+    print("📡 Coding Agent: http://localhost:8000/coding")
+    print("\n🔗 Connect using:")
+    print("   research_session = Session(agent_url='localhost:8000/research')")
+    print("   coding_session = Session(agent_url='localhost:8000/coding')")
+    
+    try:
+        # Launch both agents (this will start the server)
+        research_agent.launch(path="/research", port=8000, host="0.0.0.0")
+        coding_agent.launch(path="/coding", port=8000, host="0.0.0.0")
+    except KeyboardInterrupt:
+        print("\n\n🛑 Server stopped by user")
+
+if __name__ == "__main__":
+    import sys
+    
+    if len(sys.argv) > 1 and sys.argv[1] == "--multiple":
+        setup_multiple_agents()
+    else:
+        setup_remote_agent_server()
+        
+    print("\n\n✅ Remote agent server example completed!")
+    print("💡 Tip: Use --multiple flag to run multiple agents example")

examples/python/tools/exa-tool/Flow_Intelligent_Agent_PraisonAI.py

@@ -0,0 +1,76 @@
+# # -*- coding: utf-8 -*-
+# """Flow_Intelligent_Agent_PraisonAI.ipynb
+
+# Automatically generated by Colab.
+
+# Original file is located at
+#     https://colab.research.google.com/drive/1gm6zP1CbGU2d24iAaHhzVxTzWGs2oV43
+
+# # Flow – Intelligent Agent for Daily Efficiency
+
+# # Description
+
+# This agent uses a custom DuckDuckGo search tool to intelligently retrieve and summarize real-time information based on user queries.
+
+# [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/Flow_Intelligent_Agent_PraisonAI.ipynb)
+
+# ## Tools
+# - `praisonaiagents` – Intelligent Agent framework
+# - `duckduckgo-search` – Custom search tool
+# - `pyyaml` – YAML config
+# - `openai` – LLM backend
+
+# # Dependencies
+# """
+
+# pip install praisonaiagents duckduckgo-search pyyaml openai
+
+# """# Set your OpenAI API Key securely"""
+
+import os
+os.environ['OPENAI_API_KEY'] = 'your api key'  # Replace with your actual OpenAI key
+
+# """## YAML Prompt
+# Define multiple agents and their roles.
+# """
+
+import yaml
+
+yaml_prompt = '''
+agents:
+  - name: FlowAgent
+    description: Intelligent daily workflow assistant
+  - name: ChileAtiendeAI
+    description: Government support assistant for Chile
+  - name: ClinicalTrialMatcher
+    description: Match patients to trials using input medical info
+  - name: ChillWorkEmailAgent
+    description: Automate email replies and scheduling
+'''
+
+config = yaml.safe_load(yaml_prompt)
+
+# """## Main
+# Initialize agent with a custom DuckDuckGo tool and simulate a task.
+# """
+
+from praisonaiagents import Agent
+from duckduckgo_search import DDGS
+
+def internet_search_tool(query: str):
+    ddgs = DDGS()
+    results = []
+    for res in ddgs.text(keywords=query, max_results=3):
+        results.append(f"{res['title']} - {res['href']}")
+    return "\n".join(results)
+
+# Initialize the main agent (FlowAgent)
+flow_config = config['agents'][0]
+flow_agent = Agent(
+    name=flow_config['name'],
+    instructions=flow_config['description'],
+    tools=[internet_search_tool]
+)
+
+response = flow_agent.start("What's the latest open-source AI agent framework?")
+print(response)

examples/python/tools/exa-tool/github_repo_analyzer_agent.py

@@ -0,0 +1,69 @@
+# # -*- coding: utf-8 -*-
+# """github_repo_analyzer_agent.ipynb
+
+# Automatically generated by Colab.
+
+# Original file is located at
+#     https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/github_repo_analyzer_agent.ipynb
+
+# # 🤖 GitHub Repo Analyzer Agent
+# AI agent powered by PraisonAI and OpenAI to analyze GitHub repositories using GitHub API.
+
+# [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/github_repo_analyzer_agent.ipynb)
+
+# # 📦 Install dependencies
+# """
+
+# !pip install praisonaiagents openai requests
+
+# """# Tools Used
+
+# 🧠 praisonaiagents – Smart AI agent
+
+# 🔗 openai – GPT-powered responses
+
+# 📂 requests – GitHub repo analysis
+
+# 🖥️ Python I/O – Interactive CLI in notebook
+
+# # 🔐 Set OpenAI API Key
+# """
+
+import os
+if not os.getenv("OPENAI_API_KEY"):
+    os.environ["OPENAI_API_KEY"] = input("🔐 Enter your OpenAI API key: ")
+
+# """# 🧠 Imports"""
+
+import requests
+import openai
+from praisonaiagents import Agent
+
+openai.api_key = os.environ["OPENAI_API_KEY"]
+
+# """# 🤖 Create the Agent"""
+
+agent = Agent(instructions="""
+You are a GitHub codebase explainer. When given a repo URL, fetch summary of
+its files and provide insightful analysis. Be helpful and concise.
+""")
+
+# """# 📂 Fetch GitHub repo file names"""
+
+def fetch_repo_files(repo_url):
+    api_url = repo_url.replace("https://github.com", "https://api.github.com/repos") + "/contents"
+    r = requests.get(api_url)
+    return [f["name"] for f in r.json()] if r.status_code == 200 else []
+
+# """# 💬 Ask Agent"""
+
+def ask_agent(repo_url):
+    files = fetch_repo_files(repo_url)
+    if not files:
+        return "❌ Cannot fetch repo contents."
+    return agent.start(f"Repo contains files: {files}. Analyze key components and structure.")
+
+# """# 🧪 Run the agent"""
+
+repo = input("🔗 Enter GitHub repository URL: ")
+print("\n🧠 Agent Insight:\n", ask_agent(repo))

examples/python/tools/exa-tool/learning_assistant.py

@@ -0,0 +1,69 @@
+# ===============================
+# 1. 📘 Project Title & Purpose
+# ===============================
+# """
+# AI‑Powered Personalized Learning Assistant with Smart Content Chatbot
+
+# This assistant helps users learn any topic by chatting with an AI tutor. 
+# It uses PraisonAI Agents, OpenAI API, and Transformers to deliver answers clearly.
+# """
+
+# ============================
+# 2. 📦 Dependencies Required
+# ============================
+# """
+# Required Libraries:
+# - praisonaiagents
+# - openai
+# - transformers
+
+# Make sure to install these in Colab or terminal:
+# !pip install praisonaiagents openai transformers
+# """
+
+# =====================
+# 3. 🧰 Tools Used
+# =====================
+# """
+# ✅ praisonaiagents – Builds the smart tutoring agent  
+# ✅ openai – Uses OpenAI GPT for accurate answers  
+# ✅ transformers – Fallback model using GPT-2  
+# ✅ Python I/O – Simple interactive CLI using input/print
+# """
+
+# ============================
+# 4. 🔐 Set OpenAI API Key
+# ============================
+import os
+os.environ['OPENAI_API_KEY'] = input('Enter your OpenAI API key: ')
+
+# ================================
+# 5. 🧠 Initialize AI Agent + Fallback
+# ================================
+from praisonaiagents import Agent
+from transformers import pipeline as hf_pipeline
+import openai
+
+openai.api_key = os.getenv('OPENAI_API_KEY')
+hf_chatbot = hf_pipeline('text-generation', model='gpt2')
+
+agent = Agent(instructions='You are a friendly tutor. Answer learner questions clearly and helpfully.')
+
+def chat_with_ai(user_input):
+    try:
+        return agent.start(user_input)
+    except Exception as e:
+        print('[Fallback GPT-2]', e)
+        return hf_chatbot(user_input, max_length=100)[0]['generated_text']
+
+# ============================
+# 6. 💬 Interactive Chat Loop
+# ============================
+print("Start chatting with your AI tutor! Type 'exit' to quit.")
+while True:
+    user_input = input('You: ')
+    if user_input.lower() in ['exit', 'quit']:
+        print('Goodbye! Happy learning!')
+        break
+    response = chat_with_ai(user_input)
+    print('🤖 Tutor:', response)

examples/python/tools/exa-tool/personalized_learning_assistant.py

@@ -0,0 +1,69 @@
+# ===============================
+# 1. 📘 Project Title & Purpose
+# ===============================
+# """
+# AI‑Powered Personalized Learning Assistant with Smart Content Chatbot
+
+# This assistant helps users learn any topic by chatting with an AI tutor. 
+# It uses PraisonAI Agents, OpenAI API, and Transformers to deliver answers clearly.
+# """
+
+# ============================
+# 2. 📦 Dependencies Required
+# ============================
+# """
+# Required Libraries:
+# - praisonaiagents
+# - openai
+# - transformers
+
+# Make sure to install these in Colab or terminal:
+# !pip install praisonaiagents openai transformers
+# """
+
+# =====================
+# 3. 🧰 Tools Used
+# =====================
+# """
+# ✅ praisonaiagents – Builds the smart tutoring agent  
+# ✅ openai – Uses OpenAI GPT for accurate answers  
+# ✅ transformers – Fallback model using GPT-2  
+# ✅ Python I/O – Simple interactive CLI using input/print
+# """
+
+# ============================
+# 4. 🔐 Set OpenAI API Key
+# ============================
+import os
+os.environ['OPENAI_API_KEY'] = input('Enter your OpenAI API key: ')
+
+# ================================
+# 5. 🧠 Initialize AI Agent + Fallback
+# ================================
+from praisonaiagents import Agent
+from transformers import pipeline as hf_pipeline
+import openai
+
+openai.api_key = os.getenv('OPENAI_API_KEY')
+hf_chatbot = hf_pipeline('text-generation', model='gpt2')
+
+agent = Agent(instructions='You are a friendly tutor. Answer learner questions clearly and helpfully.')
+
+def chat_with_ai(user_input):
+    try:
+        return agent.start(user_input)
+    except Exception as e:
+        print('[Fallback GPT-2]', e)
+        return hf_chatbot(user_input, max_length=100)[0]['generated_text']
+
+# ============================
+# 6. 💬 Interactive Chat Loop
+# ============================
+print("Start chatting with your AI tutor! Type 'exit' to quit.")
+while True:
+    user_input = input('You: ')
+    if user_input.lower() in ['exit', 'quit']:
+        print('Goodbye! Happy learning!')
+        break
+    response = chat_with_ai(user_input)
+    print('🤖 Tutor:', response)

src/praisonai-agents/.cursorrules

@@ -5,146 +5,4 @@
 5. Make it minimal change as possible
 6. Firstly try not to make any modification to the existing code as possible
 7. Only modify the existing code if its highly required, without that if it cant be done, then add new code section. 
-8. If you are adding new code, make sure to add it in a way that it can be easily integrated with the existing codebase. 
-
-
-Below is a **detailed technical overview** of the issues that have been coming up in the workflow execution (specifically around loops, resetting tasks, and continuing on to subsequent tasks). It includes:
-
-1. **How the workflow currently flows**  
-2. **What logic marks a task as “completed”**  
-3. **What issues arose in `loop` tasks**  
-4. **Why the workflow can end up “stuck” or “looping indefinitely”**  
-
----
-
-## 1. Overall Workflow Flow
-
-### a. Building relationships among tasks
-
-- At startup, the code iterates through all `tasks`.  
-- For each `task`:
-  - It looks at `task.next_tasks`, and for each `next_task_name`:
-    - Finds the corresponding `Task` object
-    - Appends the current task’s name to the found `next_task`'s `previous_tasks` list.  
-- This means if Task A has `next_tasks=["B"]`, then Task B’s `previous_tasks` will include `"A"`.
-
-### b. Finding and starting with a “start task”
-
-- The workflow code tries to locate a task with `is_start=True`.  
-- If no such task is found, it uses the first item in the tasks dictionary instead.  
-- That “start task” is what the workflow tries to run first.
-
-### c. Execution loop in the method (e.g., `workflow()` or `aworkflow()`)
-
-- There is a `while current_task:` loop that processes tasks in sequence, or conditionally, based on `task.condition`.
-- Each time a task runs (if non-loop), it yields the `task_id` or triggers an agent to run. Once the agent finishes (with or without a final result), the workflow picks up again to see what to do next:
-  - If the `task` is a `loop` type, the code tries to create or manage sub-tasks for each row/line in an “input_file.”
-  - If the `task` is a normal (“decision” or “task” or “some-other-type”), it just executes once, sets `status="completed"`, and the code moves on.
-
-### d. Condition-based branching
-
-- If a task has a result that includes a “decision” (like `{"decision":"more"}` or `"done"`), the code checks `task.condition`. For example:
-  ```python
-  condition = {
-    "more": "generate_task",
-    "done": "evaluate_total_questions"
-  }
-  ```
-- If the result’s decision is `"done"`, it jumps to the task named `"evaluate_total_questions"`.  
-- If the result’s decision is `"more"`, it jumps right back to `"generate_task"`.  
-- If no condition matches, it can fallback to the first item in `task.next_tasks`.
-
-### e. Marking tasks as “completed”
-
-- After a task’s execution (like a typical “non-loop” task), the code sets `task.status = "completed"`.
-- Then the code has a snippet that says:
-  ```python
-  if self.tasks[task_id].status == "completed":
-      # Possibly reset to "not started" so we can re-run if needed
-  ```
-- By default, the system tries to “reset” tasks to `"not started"`, **unless** it is a loop task or a subtask of a loop.  
-
----
-
-## 2. How a “completed” task is marked
-
-Generally, tasks are marked `status="completed"` in two primary ways:
-
-1. **Non-Loop Execution**  
-   A normal task (like a “decision” or “task”) is executed once the code calls the agent, the agent returns a final result, and the system sets `task.status = "completed"`.
-2. **Loop Execution**  
-   A loop-type task is *programmatically* set to `status="completed"` when all of its sub-tasks have finished. That is:
-   - The code checks: “Have all child tasks of this loop finished?”  
-   - If `True`, the loop task is set to `completed`.
-
----
-
-## 3. Issues Specifically in `loop` Tasks
-
-### a. Re-Entering the Loop
-
-- Before, the same snippet that “resets completed tasks to ‘not started’ so they can re-run if needed” **also** tried to reset loop tasks or their subtasks.  
-- If a loop task got reset to `"not started"`, the code would eventually pick it back up again, leading to repeated creation of sub-tasks (or repeated attempts to re-run them).
-- This caused an **infinite loop** or repeating the same steps in the workflow, never truly exiting the loop stage.
-
-### b. Subtasks Not Marked or Overwritten
-
-- Another tricky scenario: If sub-tasks themselves got reset, the parent loop would see them as “not started” again, and might wait for them to “complete,” or might re-run them. That can lead to indefinite re-running of sub-tasks.
-
-### c. Not Proceeding to Next (e.g., “upload_to_huggingface”)
-
-- If the loop kept “restarting,” the workflow never ended up hitting the next tasks. For example, if your workflow is:
-  1. `generate_task`  
-  2. `evaluate_total_questions`  
-  3. `generate_cot` (loop)  
-  4. `upload_to_huggingface`
-- The system might get stuck in step #3 indefinitely (the sub-tasks keep getting reset, so it never actually transitions to step #4).
-
-### d. Condition Logic vs. Next Tasks
-
-- Another subtlety: If the loop tasks had a `condition` that pointed them back to a prior step, it might cause unintentional re-entry. Typically, you only want loop tasks to proceed once, **unless** you explicitly want to re-visit. But if it’s a data ingestion process, you usually want to do it once, then move on to the next step.
-
----
-
-## 4. Why the System Can End Up Stuck or “Looping Indefinitely”
-
-1. **Reset Mechanism**  
-   - The code tries to “reset tasks to ‘not started’ once they complete,” so they can be re-run in some dynamic multi-run scenario.  
-   - But that same logic can cause loop tasks to revert back to “not started” the moment they end. The system sees “Oh, a task is ‘not started’? Let’s run it!” and you’re in a cycle.
-
-2. **No Condition for Exit**  
-   - If the loop has a condition that leads back to a prior step (like `"more" -> generate_cot`), it can keep re-running.
-
-3. **Subtasks Not Marked**  
-   - If the subtask or the loop tries to “reactivate” each other, it never exits.
-
----
-
-## Summary of the “Core Problem”
-
-1. We want to keep the resetting mechanism for **non-loop tasks** – because in some advanced workflows, we like re-running them from a different path or after some condition.  
-2. But we want **loop tasks** to remain `"completed"` once all sub-tasks are done, so the code can seamlessly proceed to the next major step.  
-3. Before the fix, loop tasks or their sub-tasks got reset. This triggered the system to re-enter the loop, re-run the sub-tasks, etc., causing an infinite loop and preventing the workflow from reaching tasks like “upload_to_huggingface.”
-
----
-
-## Technical Highlights to Pass On
-
-- **In the reset snippet**:  
-  ```python
-  if self.tasks[task_id].status == "completed":
-      # never reset if loop or subtask-of-loop
-      # else reset to "not started"
-  ```
-  This is crucial to skipping re-runs on loop tasks.  
-- **Ensure** that once a loop’s sub-tasks are all “completed,” the loop’s status is set to “completed,” and it transitions to the next major tasks (like `upload_to_huggingface`).  
-- **Check** if the loop’s condition is correct. If you want a single pass, do not implement a condition that leads back to the same loop.  
-- Also, you can check you do not have “overlapping conditions” that cause re-entry.
-
----
-
-### Conclusion
-
-**Hence,** the main challenge is that the reset logic (meant to let normal tasks be re-run) conflicts with a loop task’s one-pass usage. Once you avoid resetting the loop tasks or sub-tasks, you can finish them once, mark them “completed,” and properly proceed to the next stage.
-
-Dont remove any logging or debug statements, as it will help you to understand the flow of the code.
+8. If you are adding new code, make sure to add it in a way that it can be easily integrated with the existing codebase. 

src/praisonai-agents/CLAUDE.md

@@ -0,0 +1,237 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+PraisonAI Agents is a hierarchical AI agent framework for completing complex tasks with self-reflection capabilities. It supports multi-agent collaboration, tool integration, and various execution patterns (sequential, hierarchical, parallel).
+
+## Development Commands
+
+### Installation and Setup
+```bash
+# Install core package
+pip install -e .
+
+# Install with specific features
+pip install -e .[all]          # All features
+pip install -e .[memory]       # Memory capabilities
+pip install -e .[knowledge]    # Document processing
+pip install -e .[mcp]          # MCP server support
+pip install -e .[llm]          # Extended LLM support
+pip install -e .[api]          # API server capabilities
+```
+
+### Testing
+```bash
+# Run individual test examples (no formal test runner configured)
+python tests/basic-agents.py
+python tests/async_example.py
+python tests/knowledge-agents.py
+
+# Test specific features
+python tests/mcp-agents.py           # MCP integration
+python tests/memory_example.py      # Memory functionality
+python tests/tools_example.py       # Tool system
+```
+
+### Running Examples
+```bash
+# Basic agent usage
+python tests/single-agent.py
+
+# Multi-agent workflows
+python tests/multi-agents-api.py
+
+# Async operations
+python tests/async_example_full.py
+
+# MCP server examples
+python tests/mcp-sse-direct-server.py  # Start MCP server
+python tests/mcp-sse-direct-client.py  # Connect to server
+```
+
+## Core Architecture
+
+### Agent System (`praisonaiagents/agent/`)
+- **Agent**: Core agent class with LLM integration, tool calling, and self-reflection
+- **ImageAgent**: Specialized multimodal agent for image processing
+- Self-reflection with configurable min/max iterations (default: 1-3)
+- Delegation support for hierarchical agent structures
+
+### Multi-Agent Orchestration (`praisonaiagents/agents/`)
+- **PraisonAIAgents**: Main orchestrator for managing multiple agents and tasks
+- **AutoAgents**: Automatic agent creation and management
+- Process types: `sequential`, `hierarchical`, `parallel`
+- Context passing between agents and task dependency management
+
+### Task System (`praisonaiagents/task/`)
+- **Task**: Core task definition with context, callbacks, and output specifications
+- Supports file output, JSON/Pydantic structured output, async execution
+- Conditional logic with `condition` parameter for task flow control
+- Context passing via `context` parameter for task dependencies
+- **Guardrails**: Built-in validation and safety mechanisms for task outputs
+  - Function-based guardrails for custom validation logic
+  - LLM-based guardrails using natural language descriptions
+  - Automatic retry with configurable `max_retries` parameter
+  - Compatible with CrewAI guardrail patterns
+
+### LLM Integration (`praisonaiagents/llm/`)
+- Unified wrapper for multiple LLM providers via LiteLLM
+- Supports OpenAI, Anthropic, Gemini, DeepSeek, local models (Ollama)
+- Context length management and tool calling capabilities
+- Set via `llm` parameter on agents or global `OPENAI_API_KEY`/`ANTHROPIC_API_KEY`
+
+### Tool System (`praisonaiagents/tools/`)
+Two implementation patterns:
+1. **Function-based**: Simple tools using `@tool` decorator
+2. **Class-based**: Complex tools inheriting from `BaseTool`
+
+Built-in tools include: DuckDuckGo search, file operations, calculator, Wikipedia, arXiv, data analysis tools, shell execution.
+
+### Memory & Knowledge Systems
+- **Memory** (`praisonaiagents/memory/`): Multi-layered memory with RAG support
+  - Types: short-term, long-term, entity, user memory
+  - Providers: ChromaDB, Mem0, custom implementations
+- **Knowledge** (`praisonaiagents/knowledge/`): Document processing with chunking
+  - Chunking strategies via `chonkie` library
+  - Embedding and retrieval capabilities
+
+### MCP (Model Context Protocol) Integration
+- **MCP Server**: Server-side tool protocol for distributed execution
+- **SSE Support**: Server-sent events for real-time communication
+- Tool discovery and dynamic registration
+
+## Development Patterns
+
+### Agent Creation
+```python
+agent = Agent(
+    name="Agent Name",
+    role="Agent Role",
+    goal="Agent Goal",
+    backstory="Agent Background",
+    llm="gpt-4o-mini",  # or other LLM
+    self_reflect=True,  # Enable self-reflection
+    min_reflect=1,      # Minimum reflection iterations
+    max_reflect=3,      # Maximum reflection iterations
+    tools=[tool1, tool2],  # Optional tools
+    guardrail=validate_function,  # Agent-level guardrail (function or string)
+    max_guardrail_retries=3  # Retry limit for guardrail failures
+)
+```
+
+### Task Definition
+```python
+task = Task(
+    name="task_name",
+    description="Task description",
+    expected_output="Expected output format",
+    agent=agent,
+    context=[previous_task],  # Task dependencies
+    output_pydantic=ResponseModel,  # Structured output
+    condition="condition_function"  # Conditional execution
+)
+```
+
+### Guardrails Usage
+
+#### Task-Level Guardrails
+```python
+from typing import Tuple, Any
+
+# Function-based guardrail
+def validate_output(task_output: TaskOutput) -> Tuple[bool, Any]:
+    """Custom validation function."""
+    if "error" in task_output.raw.lower():
+        return False, "Output contains errors"
+    if len(task_output.raw) < 10:
+        return False, "Output is too short"
+    return True, task_output
+
+task = Task(
+    description="Write a professional email",
+    expected_output="A well-formatted email",
+    agent=agent,
+    guardrail=validate_output,  # Function-based guardrail
+    max_retries=3  # Retry up to 3 times if guardrail fails
+)
+
+# LLM-based guardrail
+task = Task(
+    description="Generate marketing copy",
+    expected_output="Professional marketing content",
+    agent=agent,
+    guardrail="Ensure the content is professional, engaging, and free of errors",  # String description
+    max_retries=2
+)
+```
+
+#### Agent-Level Guardrails
+```python
+# Agent guardrails apply to ALL outputs from that agent
+def validate_professional_tone(task_output: TaskOutput) -> Tuple[bool, Any]:
+    """Ensure professional tone in all agent responses."""
+    content = task_output.raw.lower()
+    casual_words = ['yo', 'dude', 'awesome', 'cool']
+    for word in casual_words:
+        if word in content:
+            return False, f"Unprofessional language detected: {word}"
+    return True, task_output
+
+# Agent with function-based guardrail
+agent = Agent(
+    name="BusinessWriter",
+    instructions="You are a professional business writer",
+    guardrail=validate_professional_tone,  # Function guardrail
+    max_guardrail_retries=3
+)
+
+# Agent with LLM-based guardrail
+agent = Agent(
+    name="ContentWriter", 
+    instructions="You are a content writer",
+    guardrail="Ensure all responses are professional, accurate, and appropriate for business use",  # String guardrail
+    max_guardrail_retries=2
+)
+```
+
+### Multi-Agent Workflow
+```python
+workflow = PraisonAIAgents(
+    agents=[agent1, agent2],
+    tasks=[task1, task2],
+    process="sequential",  # or "hierarchical", "parallel"
+    verbose=True,
+    manager_agent=manager_agent  # For hierarchical process
+)
+result = workflow.start()
+```
+
+### Async Support
+All major components support async execution:
+```python
+result = await workflow.astart()
+result = await agent.aexecute(task)
+```
+
+## Key Dependencies
+
+- **Core**: `pydantic`, `rich`, `openai`, `mcp`
+- **Memory**: `chromadb`, `mem0ai`
+- **Knowledge**: `markitdown`, `chonkie`
+- **LLM**: `litellm` for unified provider access
+- **API**: `fastapi`, `uvicorn` for server capabilities
+
+## Error Handling
+
+- Global error logging via `error_logs` list
+- Callback system for real-time error reporting
+- Context length exception handling with automatic retry
+- Graceful degradation for optional dependencies
+
+## Testing Strategy
+
+The project uses example-driven testing with 100+ test files in `tests/` directory. Each test file demonstrates specific usage patterns and serves as both test and documentation. Run individual examples to test functionality rather than using a formal test runner.
+
+Use conda activate praisonai-agents to activate the environment.

src/praisonai-agents/TELEMETRY_SUMMARY.md

@@ -0,0 +1,33 @@
+# Telemetry Implementation Summary
+
+## What Was Fixed
+
+1. **PostHog initialization error** - Removed invalid `events_to_ignore` parameter
+2. **Missing imports** - Added `MinimalTelemetry` and `TelemetryCollector` imports to telemetry `__init__.py`
+3. **Wrong method instrumentation** - Changed from `agent.execute()` to `agent.chat()`
+4. **Task tracking** - Added instrumentation for `workflow.execute_task()`
+5. **Automatic setup** - Added `auto_instrument_all()` in main `__init__.py`
+6. **Automatic flush** - Added `atexit` handler to send data on program exit
+
+## Current Status
+
+✅ **Telemetry is now working automatically!**
+
+- Enabled by default (opt-out via environment variables)
+- Tracks agent executions and task completions
+- Sends anonymous data to PostHog on program exit
+- No manual setup required
+
+## Metrics Example
+```
+Telemetry metrics collected:
+- Agent executions: 4
+- Task completions: 2
+- Errors: 0
+- Session ID: 33873e62396d8b4c
+```
+
+## To Disable
+Set any of these environment variables:
+- `PRAISONAI_TELEMETRY_DISABLED=true`
+- `DO_NOT_TRACK=true`

src/praisonai-agents/agent_guardrails_example.py

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+"""
+Agent-level guardrails example.
+
+This example demonstrates how to use guardrails at the Agent level,
+which will apply to all tasks executed by that agent.
+"""
+
+from typing import Tuple, Any
+from praisonaiagents import Agent, TaskOutput
+
+def validate_content_length(task_output: TaskOutput) -> Tuple[bool, Any]:
+    """
+    Validate that task output content meets minimum length requirement.
+    
+    Args:
+        task_output: The task output to validate
+        
+    Returns:
+        Tuple of (success, result_or_error_message)
+    """
+    if len(task_output.raw) < 50:
+        return False, "Content too short - must be at least 50 characters"
+    return True, task_output
+
+def validate_professional_tone(task_output: TaskOutput) -> Tuple[bool, Any]:
+    """
+    Validate that the content has a professional tone.
+    
+    Args:
+        task_output: The task output to validate
+        
+    Returns:
+        Tuple of (success, result_or_error_message)
+    """
+    content = task_output.raw.lower()
+    unprofessional_words = ['yo', 'dude', 'awesome', 'cool', 'lol']
+    
+    for word in unprofessional_words:
+        if word in content:
+            return False, f"Content contains unprofessional word: '{word}'"
+    
+    return True, task_output
+
+def main():
+    """Demonstrate Agent-level guardrails with function-based and LLM-based validation."""
+    
+    print("=== Agent Guardrail Examples ===\n")
+    
+    # Example 1: Function-based guardrail
+    print("1. Function-based guardrail (content length validation):")
+    agent1 = Agent(
+        name="ContentWriter",
+        instructions="You are a professional content writer who creates detailed responses",
+        guardrail=validate_content_length,
+        max_guardrail_retries=2
+    )
+    
+    try:
+        result1 = agent1.start("Write a brief welcome message")
+        print(f"Result: {result1}\n")
+    except Exception as e:
+        print(f"Error: {e}\n")
+    
+    # Example 2: LLM-based guardrail (string description)
+    print("2. LLM-based guardrail (professional tone validation):")
+    agent2 = Agent(
+        name="BusinessWriter", 
+        instructions="You are a business communication expert",
+        guardrail="Ensure the content is professional, formal, and suitable for business communication. No casual language or slang.",
+        max_guardrail_retries=3
+    )
+    
+    try:
+        result2 = agent2.start("Write a welcome message for new employees")
+        print(f"Result: {result2}\n")
+    except Exception as e:
+        print(f"Error: {e}\n")
+    
+    # Example 3: Multiple agents with different guardrails
+    print("3. Professional tone function-based guardrail:")
+    agent3 = Agent(
+        name="ProfessionalWriter",
+        instructions="Write professional business content",
+        guardrail=validate_professional_tone,
+        max_guardrail_retries=2
+    )
+    
+    try:
+        result3 = agent3.start("Write a casual greeting message")
+        print(f"Result: {result3}\n")
+    except Exception as e:
+        print(f"Error: {e}\n")
+    
+    print("=== Agent Guardrails Demonstration Complete ===")
+
+if __name__ == "__main__":
+    main()

src/praisonai-agents/debug_auto_instrument.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""
+Debug auto-instrumentation.
+"""
+
+print("1. Import telemetry module...")
+import praisonaiagents.telemetry
+print("   Telemetry module imported")
+
+print("\n2. Check if auto_instrument_all was called...")
+print(f"   _initialized: {praisonaiagents.telemetry._initialized}")
+
+print("\n3. Import Agent and PraisonAIAgents...")
+from praisonaiagents import Agent, PraisonAIAgents
+print("   Classes imported")
+
+print("\n4. Check if classes are instrumented...")
+agent = Agent(name="Test", role="Test", goal="Test", instructions="Test")
+print(f"   Agent.__init__ name: {Agent.__init__.__name__}")
+print(f"   agent.execute exists: {hasattr(agent, 'execute')}")
+
+print("\n5. Manually call auto_instrument_all...")
+from praisonaiagents.telemetry.integration import auto_instrument_all
+auto_instrument_all()
+print("   auto_instrument_all() called")
+
+print("\n6. Create new agent after instrumentation...")
+agent2 = Agent(name="Test2", role="Test2", goal="Test2", instructions="Test2")
+print(f"   Agent.__init__ name after: {Agent.__init__.__name__}")
+print(f"   agent2.execute exists: {hasattr(agent2, 'execute')}")
+
+print("\n7. Check if execute is wrapped...")
+if hasattr(agent2, 'execute'):
+    print(f"   agent2.execute name: {agent2.execute.__name__}")
+    print(f"   agent2.execute wrapped: {hasattr(agent2.execute, '__wrapped__')}")
+
+print("\n8. Import telemetry and check if it's working...")
+from praisonaiagents.telemetry import get_telemetry
+telemetry = get_telemetry()
+print(f"   Telemetry enabled: {telemetry.enabled}")
+print(f"   PostHog available: {telemetry._posthog is not None}")
+
+# The key insight: auto_instrument_all needs to be called AFTER
+# the Agent and PraisonAIAgents classes are imported!

src/praisonai-agents/debug_comparison.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+
+import sys
+import traceback
+from praisonaiagents import Agent, MCP
+
+def test_agent_direct():
+    """Test gpt-4o-mini (agent.py path)"""
+    print("=" * 50)
+    print("TESTING: gpt-4o-mini (agent.py direct calls)")
+    print("=" * 50)
+    
+    try:
+        agent = Agent(
+            instructions="""You are a helpful assistant that can break down complex problems.
+            Use the available tools when relevant to perform step-by-step analysis.""",
+            llm="gpt-4o-mini",
+            tools=MCP("npx -y @modelcontextprotocol/server-sequential-thinking")
+        )
+        
+        print("✅ Agent created successfully")
+        print(f"✅ Agent LLM: {getattr(agent, 'llm', 'Not set')}")
+        print(f"✅ Agent using custom LLM: {getattr(agent, '_using_custom_llm', False)}")
+        
+        result = agent.start("What are 3 steps to make coffee?")
+        print("✅ Agent execution completed successfully")
+        return True, result
+        
+    except Exception as e:
+        print(f"❌ Error in agent direct: {e}")
+        traceback.print_exc()
+        return False, str(e)
+
+def test_llm_class():
+    """Test openai/gpt-4o-mini (llm.py path)"""
+    print("\n" + "=" * 50)
+    print("TESTING: openai/gpt-4o-mini (llm.py LiteLLM)")
+    print("=" * 50)
+    
+    try:
+        agent = Agent(
+            instructions="""You are a helpful assistant that can break down complex problems.
+            Use the available tools when relevant to perform step-by-step analysis.""",
+            llm="openai/gpt-4o-mini",
+            tools=MCP("npx -y @modelcontextprotocol/server-sequential-thinking")
+        )
+        
+        print("✅ Agent created successfully")
+        print(f"✅ Agent LLM instance: {getattr(agent, 'llm_instance', 'Not set')}")
+        print(f"✅ Agent using custom LLM: {getattr(agent, '_using_custom_llm', False)}")
+        
+        result = agent.start("What are 3 steps to make coffee?")
+        print("✅ Agent execution completed successfully")
+        return True, result
+        
+    except Exception as e:
+        print(f"❌ Error in llm class: {e}")
+        traceback.print_exc()
+        return False, str(e)
+
+if __name__ == "__main__":
+    print("🔍 DEBUGGING: Comparing both LLM approaches\n")
+    
+    # Test agent direct
+    success1, result1 = test_agent_direct()
+    
+    # Test LLM class
+    success2, result2 = test_llm_class()
+    
+    print("\n" + "=" * 50)
+    print("FINAL RESULTS")
+    print("=" * 50)
+    
+    if success1:
+        print("✅ gpt-4o-mini (agent.py) - SUCCESS")
+    else:
+        print("❌ gpt-4o-mini (agent.py) - FAILED")
+        print(f"   Error: {result1}")
+    
+    if success2:
+        print("✅ openai/gpt-4o-mini (llm.py) - SUCCESS")
+    else:
+        print("❌ openai/gpt-4o-mini (llm.py) - FAILED")
+        print(f"   Error: {result2}")
+    
+    if success1 and success2:
+        print("\n🎉 BOTH FORMATS WORK CORRECTLY!")
+        print("📝 The issue mentioned might be resolved or was a different problem.")
+    elif success1 and not success2:
+        print("\n⚠️  CONFIRMED: LLM class path has issues")
+        print("📝 Need to debug the LLM class implementation")
+    elif success2 and not success1:
+        print("\n⚠️  CONFIRMED: Agent direct path has issues")
+        print("📝 Need to debug the agent direct implementation")
+    else:
+        print("\n💥 BOTH PATHS FAILED - Something is fundamentally wrong")

src/praisonai-agents/debug_telemetry.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""
+Debug telemetry instrumentation to see what's happening.
+"""
+
+import os
+# Make sure telemetry is enabled
+if 'PRAISONAI_TELEMETRY_DISABLED' in os.environ:
+    del os.environ['PRAISONAI_TELEMETRY_DISABLED']
+
+print("1. Importing modules...")
+from praisonaiagents import Agent, Task, PraisonAIAgents
+from praisonaiagents.telemetry import get_telemetry
+
+print("\n2. Checking telemetry status...")
+telemetry = get_telemetry()
+print(f"Telemetry enabled: {telemetry.enabled}")
+print(f"PostHog available: {telemetry._posthog is not None}")
+
+print("\n3. Creating agent...")
+agent = Agent(
+    name="TestAgent",
+    role="Test Role",
+    goal="Test Goal",
+    instructions="Test instructions"
+)
+
+# Check if agent.execute is instrumented
+print(f"\n4. Checking agent instrumentation...")
+print(f"Agent has execute method: {hasattr(agent, 'execute')}")
+if hasattr(agent, 'execute'):
+    print(f"Execute method type: {type(agent.execute)}")
+    print(f"Execute method name: {agent.execute.__name__ if hasattr(agent.execute, '__name__') else 'No name'}")
+    print(f"Is wrapped: {'instrumented' in str(agent.execute.__name__) if hasattr(agent.execute, '__name__') else 'Unknown'}")
+
+print("\n5. Creating task...")
+task = Task(
+    description="Test task",
+    expected_output="Test output",
+    agent=agent
+)
+
+print("\n6. Creating workflow...")
+workflow = PraisonAIAgents(
+    agents=[agent],
+    tasks=[task],
+    process="sequential"
+)
+
+# Check if workflow.start is instrumented
+print(f"\n7. Checking workflow instrumentation...")
+print(f"Workflow has start method: {hasattr(workflow, 'start')}")
+if hasattr(workflow, 'start'):
+    print(f"Start method type: {type(workflow.start)}")
+    print(f"Start method name: {workflow.start.__name__ if hasattr(workflow.start, '__name__') else 'No name'}")
+    print(f"Is wrapped: {'instrumented' in str(workflow.start.__name__) if hasattr(workflow.start, '__name__') else 'Unknown'}")
+
+print("\n8. Running workflow...")
+result = workflow.start()
+
+print("\n9. Checking metrics...")
+metrics = telemetry.get_metrics()
+print(f"Metrics: {metrics}")
+
+print("\n10. Manually tracking to verify telemetry works...")
+telemetry.track_agent_execution("ManualTest", success=True)
+telemetry.track_task_completion("ManualTask", success=True)
+manual_metrics = telemetry.get_metrics()
+print(f"After manual tracking: {manual_metrics['metrics']}")

src/praisonai-agents/debug_telemetry_double.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""
+Debug double-counting in telemetry.
+"""
+
+from praisonaiagents import Agent, Task, PraisonAIAgents
+from praisonaiagents.telemetry import get_telemetry
+
+# Get telemetry instance
+telemetry = get_telemetry()
+
+# Clear any existing metrics by flushing
+telemetry.flush()
+
+print("Starting fresh telemetry tracking...\n")
+
+# Create ONE agent
+print("Creating 1 agent...")
+agent = Agent(
+    name="SingleAgent",
+    role="Test Role",
+    goal="Test Goal",
+    instructions="Test instructions"
+)
+
+# Create ONE task
+print("Creating 1 task...")
+task = Task(
+    description="Single test task",
+    expected_output="Test output",
+    agent=agent
+)
+
+# Create workflow with ONE agent and ONE task
+print("Creating workflow with 1 agent and 1 task...")
+workflow = PraisonAIAgents(
+    agents=[agent],
+    tasks=[task],
+    process="sequential"
+)
+
+# Check metrics before running
+metrics_before = telemetry.get_metrics()
+print(f"\nMetrics BEFORE running workflow:")
+print(f"  Agent executions: {metrics_before['metrics']['agent_executions']}")
+print(f"  Task completions: {metrics_before['metrics']['task_completions']}")
+
+# Run the workflow
+print("\nRunning workflow...")
+result = workflow.start()
+
+# Check metrics after running
+metrics_after = telemetry.get_metrics()
+print(f"\nMetrics AFTER running workflow:")
+print(f"  Agent executions: {metrics_after['metrics']['agent_executions']} (expected: 1)")
+print(f"  Task completions: {metrics_after['metrics']['task_completions']} (expected: 1)")
+
+if metrics_after['metrics']['agent_executions'] > 1:
+    print("\n❌ ISSUE: Agent executions are being double-counted!")
+    print("   Possible causes:")
+    print("   - Agent method is being called multiple times")
+    print("   - Instrumentation is being applied twice")
+    print("   - Multiple tracking calls for same execution")
+
+if metrics_after['metrics']['task_completions'] > 1:
+    print("\n❌ ISSUE: Task completions are being double-counted!")
+    print("   Possible causes:")
+    print("   - Task completion is tracked in multiple places")
+    print("   - Instrumentation is being applied twice")

src/praisonai-agents/guardrail_agent_example.py

@@ -0,0 +1,14 @@
+from praisonaiagents import Agent
+
+def validate_content(data):
+    if len(str(data)) < 50:
+        return False, "Content too short"
+    return True, data
+
+agent = Agent(
+    instructions="You are a writer",
+    guardrail=validate_content,
+    max_guardrail_retries=1
+)
+
+agent.start("Write a welcome message with 5 words")

src/praisonai-agents/guardrail_agents_example.py

@@ -0,0 +1,21 @@
+from praisonaiagents import Agent, Task, TaskOutput, PraisonAIAgents
+from typing import Tuple, Any
+
+def validate_content(task_output: TaskOutput) -> Tuple[bool, Any]:
+    if len(task_output.raw) < 50:
+        return False, "Content too short"
+    return True, task_output
+
+agent = Agent(
+    instructions="You are a writer",
+)
+
+task = Task(
+    description="Write a welcome message",
+    guardrail=validate_content,
+    agent=agent
+)
+
+praison_agents = PraisonAIAgents(agents=[agent], tasks=[task])
+
+praison_agents.start()

src/praisonai-agents/guardrails_example.py

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+"""
+Example demonstrating guardrails functionality in PraisonAI Agents.
+
+This example shows both function-based and LLM-based guardrails
+for validating task outputs.
+"""
+
+import sys
+import os
+from typing import Tuple, Any
+
+from praisonaiagents import Agent, Task, TaskOutput
+
+
+def email_validator(task_output: TaskOutput) -> Tuple[bool, Any]:
+    """
+    Function-based guardrail to validate email content.
+    
+    Args:
+        task_output: The task output to validate
+        
+    Returns:
+        Tuple of (success, result_or_error)
+    """
+    content = task_output.raw.lower()
+    
+    # Check for required email components
+    if "subject:" not in content:
+        return False, "Email must include a subject line"
+    
+    if "dear" not in content and "hello" not in content:
+        return False, "Email must include a proper greeting"
+    
+    if len(content) < 50:
+        return False, "Email content is too short"
+        
+    if "error" in content or "problem" in content:
+        return False, "Email should not mention errors or problems"
+        
+    return True, task_output
+
+
+def main():
+    """Run the guardrails example."""
+    print("PraisonAI Agents - Guardrails Example")
+    print("=====================================\n")
+    
+    # Create an agent
+    agent = Agent(
+        name="Email Assistant",
+        role="Professional Email Writer",
+        goal="Write clear, professional emails",
+        backstory="I am an AI assistant specialized in writing professional emails"
+    )
+    
+    print("1. Testing Function-based Guardrail")
+    print("------------------------------------")
+    
+    # Create task with function-based guardrail
+    task_with_function_guardrail = Task(
+        description="Write a professional email to a client about project completion",
+        expected_output="A well-formatted professional email",
+        agent=agent,
+        guardrail=email_validator,  # Function-based guardrail
+        max_retries=2
+    )
+    
+    print(f"Task created with function guardrail: {email_validator.__name__}")
+    print(f"Max retries: {task_with_function_guardrail.max_retries}")
+    
+    # Simulate a task output that should pass
+    good_output = TaskOutput(
+        description="Email task",
+        raw="""Subject: Project Completion Update
+
+Dear Client,
+
+I am pleased to inform you that your project has been completed successfully. 
+All deliverables have been reviewed and are ready for your review. 
+Please let me know if you have any questions.
+
+Best regards,
+Project Team""",
+        agent="Email Assistant"
+    )
+    
+    result = task_with_function_guardrail._process_guardrail(good_output)
+    print(f"Good email result: {'PASSED' if result.success else 'FAILED'}")
+    if not result.success:
+        print(f"Error: {result.error}")
+    
+    # Simulate a task output that should fail
+    bad_output = TaskOutput(
+        description="Email task",
+        raw="Hi there, there was an error with your project.",
+        agent="Email Assistant"
+    )
+    
+    result = task_with_function_guardrail._process_guardrail(bad_output)
+    print(f"Bad email result: {'PASSED' if result.success else 'FAILED'}")
+    if not result.success:
+        print(f"Error: {result.error}")
+    
+    print("\n2. Testing String-based LLM Guardrail")
+    print("-------------------------------------")
+    
+    # Create task with string-based guardrail
+    task_with_llm_guardrail = Task(
+        description="Write a marketing email for a new product launch",
+        expected_output="Engaging marketing content",
+        agent=agent,
+        guardrail="Ensure the content is professional, engaging, includes a clear call-to-action, and is free of errors",
+        max_retries=3
+    )
+    
+    print("Task created with LLM-based guardrail")
+    print("Guardrail description: 'Ensure the content is professional, engaging, includes a clear call-to-action, and is free of errors'")
+    print(f"Max retries: {task_with_llm_guardrail.max_retries}")
+    
+    print("\n3. Backward Compatibility")
+    print("-------------------------")
+    
+    # Create task without guardrail (backward compatible)
+    task_without_guardrail = Task(
+        description="Write a simple thank you note",
+        expected_output="A brief thank you message",
+        agent=agent
+    )
+    
+    print("Task created without guardrail (backward compatible)")
+    print(f"Guardrail function: {task_without_guardrail._guardrail_fn}")
+    
+    # Test that it doesn't break existing functionality
+    simple_output = TaskOutput(
+        description="Thank you task",
+        raw="Thank you for your business!",
+        agent="Email Assistant"
+    )
+    
+    result = task_without_guardrail._process_guardrail(simple_output)
+    print(f"No guardrail result: {'PASSED' if result.success else 'FAILED'}")
+    
+    print("\n✅ Guardrails example completed successfully!")
+    print("\nKey Features Demonstrated:")
+    print("- Function-based guardrails with custom validation logic")
+    print("- String-based LLM guardrails using natural language")
+    print("- Configurable retry mechanism")
+    print("- Backward compatibility with existing tasks")
+    print("- Integration with TaskOutput validation")
+
+
+if __name__ == "__main__":
+    main()

src/praisonai-agents/praisonaiagents/__init__.py

@@ -12,6 +12,8 @@ from .knowledge.knowledge import Knowledge
 from .knowledge.chunking import Chunking
 from .mcp.mcp import MCP
 from .session import Session
+from .memory.memory import Memory
+from .guardrails import GuardrailResult, LLMGuardrail
 from .main import (
     TaskOutput,
     ReflectionOutput,
@@ -28,9 +30,50 @@ from .main import (
     async_display_callbacks,
 )
 
+# Telemetry support (lazy loaded)
+try:
+    from .telemetry import (
+        get_telemetry,
+        enable_telemetry,
+        disable_telemetry,
+        MinimalTelemetry,
+        TelemetryCollector
+    )
+    _telemetry_available = True
+except ImportError:
+    # Telemetry not available - provide stub functions
+    _telemetry_available = False
+    def get_telemetry():
+        return None
+    
+    def enable_telemetry(*args, **kwargs):
+        import logging
+        logging.warning(
+            "Telemetry not available. Install with: pip install praisonaiagents[telemetry]"
+        )
+        return None
+    
+    def disable_telemetry():
+        pass
+    
+    MinimalTelemetry = None
+    TelemetryCollector = None
+
 # Add Agents as an alias for PraisonAIAgents
 Agents = PraisonAIAgents
 
+# Apply telemetry auto-instrumentation after all imports
+if _telemetry_available:
+    try:
+        # Only instrument if telemetry is enabled
+        _telemetry = get_telemetry()
+        if _telemetry and _telemetry.enabled:
+            from .telemetry.integration import auto_instrument_all
+            auto_instrument_all(_telemetry)
+    except Exception:
+        # Silently fail if there are any issues
+        pass
+
 __all__ = [
     'Agent',
     'ImageAgent',
@@ -42,6 +85,7 @@ __all__ = [
     'ReflectionOutput',
     'AutoAgents',
     'Session',
+    'Memory',
     'display_interaction',
     'display_self_reflection',
     'display_instruction',
@@ -55,5 +99,12 @@ __all__ = [
     'async_display_callbacks',
     'Knowledge',
     'Chunking',
-    'MCP'
+    'MCP',
+    'GuardrailResult',
+    'LLMGuardrail',
+    'get_telemetry',
+    'enable_telemetry',
+    'disable_telemetry',
+    'MinimalTelemetry',
+    'TelemetryCollector'
 ] 

src/praisonai-agents/praisonaiagents/agent/agent.py

@@ -3,7 +3,7 @@ import time
 import json
 import logging
 import asyncio
-from typing import List, Optional, Any, Dict, Union, Literal, TYPE_CHECKING
+from typing import List, Optional, Any, Dict, Union, Literal, TYPE_CHECKING, Callable, Tuple
 from rich.console import Console
 from rich.live import Live
 from openai import AsyncOpenAI
@@ -32,6 +32,7 @@ _shared_apps = {}  # Dict of port -> FastAPI app
 
 if TYPE_CHECKING:
     from ..task.task import Task
+    from ..main import TaskOutput
 
 @dataclass
 class ChatCompletionMessage:
@@ -363,13 +364,110 @@ class Agent:
         knowledge_config: Optional[Dict[str, Any]] = None,
         use_system_prompt: Optional[bool] = True,
         markdown: bool = True,
+        stream: bool = True,
         self_reflect: bool = False,
         max_reflect: int = 3,
         min_reflect: int = 1,
         reflect_llm: Optional[str] = None,
+        reflect_prompt: Optional[str] = None,
         user_id: Optional[str] = None,
-        reasoning_steps: bool = False
+        reasoning_steps: bool = False,
+        guardrail: Optional[Union[Callable[['TaskOutput'], Tuple[bool, Any]], str]] = None,
+        max_guardrail_retries: int = 3,
+        base_url: Optional[str] = None,
+        api_key: Optional[str] = None
     ):
+        """Initialize an Agent instance.
+
+        Args:
+            name (Optional[str], optional): Name of the agent used for identification and logging.
+                If None, defaults to "Agent". Defaults to None.
+            role (Optional[str], optional): Role or job title that defines the agent's expertise
+                and behavior patterns. Examples: "Data Analyst", "Content Writer". Defaults to None.
+            goal (Optional[str], optional): Primary objective or goal the agent aims to achieve.
+                Defines the agent's purpose and success criteria. Defaults to None.
+            backstory (Optional[str], optional): Background story or context that shapes the agent's
+                personality and decision-making approach. Defaults to None.
+            instructions (Optional[str], optional): Direct instructions that override role, goal,
+                and backstory when provided. Used for simple, task-specific agents. Defaults to None.
+            llm (Optional[Union[str, Any]], optional): Language model configuration. Can be a model
+                name string (e.g., "gpt-4o", "anthropic/claude-3-sonnet") or a configured LLM object.
+                Defaults to environment variable OPENAI_MODEL_NAME or "gpt-4o".
+            tools (Optional[List[Any]], optional): List of tools, functions, or capabilities
+                available to the agent for task execution. Can include callables, tool objects,
+                or MCP instances. Defaults to None.
+            function_calling_llm (Optional[Any], optional): Dedicated language model for function
+                calling operations. If None, uses the main llm parameter. Defaults to None.
+            max_iter (int, optional): Maximum number of iterations the agent can perform during
+                task execution to prevent infinite loops. Defaults to 20.
+            max_rpm (Optional[int], optional): Maximum requests per minute to rate limit API calls
+                and prevent quota exhaustion. If None, no rate limiting is applied. Defaults to None.
+            max_execution_time (Optional[int], optional): Maximum execution time in seconds for
+                agent operations before timeout. If None, no time limit is enforced. Defaults to None.
+            memory (Optional[Any], optional): Memory system for storing and retrieving information
+                across conversations. Requires memory dependencies to be installed. Defaults to None.
+            verbose (bool, optional): Enable detailed logging and status updates during agent
+                execution for debugging and monitoring. Defaults to True.
+            allow_delegation (bool, optional): Allow the agent to delegate tasks to other agents
+                or sub-processes when appropriate. Defaults to False.
+            step_callback (Optional[Any], optional): Callback function called after each step
+                of agent execution for custom monitoring or intervention. Defaults to None.
+            cache (bool, optional): Enable caching of responses and computations to improve
+                performance and reduce API costs. Defaults to True.
+            system_template (Optional[str], optional): Custom template for system prompts that
+                overrides the default system prompt generation. Defaults to None.
+            prompt_template (Optional[str], optional): Template for formatting user prompts
+                before sending to the language model. Defaults to None.
+            response_template (Optional[str], optional): Template for formatting agent responses
+                before returning to the user. Defaults to None.
+            allow_code_execution (Optional[bool], optional): Enable the agent to execute code
+                snippets during task completion. Use with caution for security. Defaults to False.
+            max_retry_limit (int, optional): Maximum number of retry attempts for failed operations
+                before giving up. Helps handle transient errors. Defaults to 2.
+            respect_context_window (bool, optional): Automatically manage context window size
+                to prevent token limit errors with large conversations. Defaults to True.
+            code_execution_mode (Literal["safe", "unsafe"], optional): Safety mode for code execution.
+                "safe" restricts dangerous operations, "unsafe" allows full code execution. Defaults to "safe".
+            embedder_config (Optional[Dict[str, Any]], optional): Configuration dictionary for
+                text embedding models used in knowledge retrieval and similarity search. Defaults to None.
+            knowledge (Optional[List[str]], optional): List of knowledge sources (file paths, URLs,
+                or text content) to be processed and made available to the agent. Defaults to None.
+            knowledge_config (Optional[Dict[str, Any]], optional): Configuration for knowledge
+                processing and retrieval system including chunking and indexing parameters. Defaults to None.
+            use_system_prompt (Optional[bool], optional): Whether to include system prompts in
+                conversations to establish agent behavior and context. Defaults to True.
+            markdown (bool, optional): Enable markdown formatting in agent responses for better
+                readability and structure. Defaults to True.
+            stream (bool, optional): Enable streaming responses from the language model. Set to False
+                for LLM providers that don't support streaming. Defaults to True.
+            self_reflect (bool, optional): Enable self-reflection capabilities where the agent
+                evaluates and improves its own responses. Defaults to False.
+            max_reflect (int, optional): Maximum number of self-reflection iterations to prevent
+                excessive reflection loops. Defaults to 3.
+            min_reflect (int, optional): Minimum number of self-reflection iterations required
+                before accepting a response as satisfactory. Defaults to 1.
+            reflect_llm (Optional[str], optional): Dedicated language model for self-reflection
+                operations. If None, uses the main llm parameter. Defaults to None.
+            reflect_prompt (Optional[str], optional): Custom prompt template for self-reflection
+                that guides the agent's self-evaluation process. Defaults to None.
+            user_id (Optional[str], optional): Unique identifier for the user or session to
+                enable personalized responses and memory isolation. Defaults to "praison".
+            reasoning_steps (bool, optional): Enable step-by-step reasoning output to show the
+                agent's thought process during problem solving. Defaults to False.
+            guardrail (Optional[Union[Callable[['TaskOutput'], Tuple[bool, Any]], str]], optional):
+                Safety mechanism to validate agent outputs. Can be a validation function or
+                description string for LLM-based validation. Defaults to None.
+            max_guardrail_retries (int, optional): Maximum number of retry attempts when guardrail
+                validation fails before giving up. Defaults to 3.
+            base_url (Optional[str], optional): Base URL for custom LLM endpoints (e.g., Ollama).
+                If provided, automatically creates a custom LLM instance. Defaults to None.
+            api_key (Optional[str], optional): API key for LLM provider. If not provided,
+                falls back to environment variables. Defaults to None.
+
+        Raises:
+            ValueError: If all of name, role, goal, backstory, and instructions are None.
+            ImportError: If memory or LLM features are requested but dependencies are not installed.
+        """
         # Add check at start if memory is requested
         if memory is not None:
             try:
@@ -411,10 +509,40 @@ class Agent:
         # Check for model name in environment variable if not provided
         self._using_custom_llm = False
 
-        # If the user passes a dictionary (for advanced configuration)
-        if isinstance(llm, dict) and "model" in llm:
+        # If base_url is provided, always create a custom LLM instance
+        if base_url:
             try:
                 from ..llm.llm import LLM
+                # Handle different llm parameter types with base_url
+                if isinstance(llm, dict):
+                    # Merge base_url and api_key into the dict
+                    llm_config = llm.copy()
+                    llm_config['base_url'] = base_url
+                    if api_key:
+                        llm_config['api_key'] = api_key
+                    self.llm_instance = LLM(**llm_config)
+                else:
+                    # Create LLM with model string and base_url
+                    model_name = llm or os.getenv('OPENAI_MODEL_NAME', 'gpt-4o')
+                    self.llm_instance = LLM(
+                        model=model_name,
+                        base_url=base_url,
+                        api_key=api_key
+                    )
+                self._using_custom_llm = True
+            except ImportError as e:
+                raise ImportError(
+                    "LLM features requested but dependencies not installed. "
+                    "Please install with: pip install \"praisonaiagents[llm]\""
+                ) from e
+        # If the user passes a dictionary (for advanced configuration)
+        elif isinstance(llm, dict) and "model" in llm:
+            try:
+                from ..llm.llm import LLM
+                # Add api_key if provided and not in dict
+                if api_key and 'api_key' not in llm:
+                    llm = llm.copy()
+                    llm['api_key'] = api_key
                 self.llm_instance = LLM(**llm)  # Pass all dict items as kwargs
                 self._using_custom_llm = True
             except ImportError as e:
@@ -427,7 +555,10 @@ class Agent:
             try:
                 from ..llm.llm import LLM
                 # Pass the entire string so LiteLLM can parse provider/model
-                self.llm_instance = LLM(model=llm)
+                llm_params = {'model': llm}
+                if api_key:
+                    llm_params['api_key'] = api_key
+                self.llm_instance = LLM(**llm_params)
                 self._using_custom_llm = True
                 
                 # Ensure tools are properly accessible when using custom LLM
@@ -465,8 +596,10 @@ class Agent:
         self.use_system_prompt = use_system_prompt
         self.chat_history = []
         self.markdown = markdown
+        self.stream = stream
         self.max_reflect = max_reflect
         self.min_reflect = min_reflect
+        self.reflect_prompt = reflect_prompt
         # Use the same model selection logic for reflect_llm
         self.reflect_llm = reflect_llm or os.getenv('OPENAI_MODEL_NAME', 'gpt-4o')
         self.console = Console()  # Create a single console instance for the agent
@@ -483,6 +616,12 @@ Your Goal: {self.goal}
         # Store user_id
         self.user_id = user_id or "praison"
         self.reasoning_steps = reasoning_steps
+        
+        # Initialize guardrail settings
+        self.guardrail = guardrail
+        self.max_guardrail_retries = max_guardrail_retries
+        self._guardrail_fn = None
+        self._setup_guardrail()
 
         # Check if knowledge parameter has any values
         if not knowledge:
@@ -512,6 +651,149 @@ Your Goal: {self.goal}
         except Exception as e:
             logging.error(f"Error processing knowledge item: {knowledge_item}, error: {e}")
 
+    def _setup_guardrail(self):
+        """Setup the guardrail function based on the provided guardrail parameter."""
+        if self.guardrail is None:
+            self._guardrail_fn = None
+            return
+            
+        if callable(self.guardrail):
+            # Validate function signature
+            sig = inspect.signature(self.guardrail)
+            positional_args = [
+                param for param in sig.parameters.values()
+                if param.default is inspect.Parameter.empty
+            ]
+            if len(positional_args) != 1:
+                raise ValueError("Agent guardrail function must accept exactly one parameter (TaskOutput)")
+            
+            # Check return annotation if present
+            from typing import get_args, get_origin
+            return_annotation = sig.return_annotation
+            if return_annotation != inspect.Signature.empty:
+                return_annotation_args = get_args(return_annotation)
+                if not (
+                    get_origin(return_annotation) is tuple
+                    and len(return_annotation_args) == 2
+                    and return_annotation_args[0] is bool
+                    and (
+                        return_annotation_args[1] is Any
+                        or return_annotation_args[1] is str
+                        or str(return_annotation_args[1]).endswith('TaskOutput')
+                        or str(return_annotation_args[1]).startswith('typing.Union')
+                    )
+                ):
+                    raise ValueError(
+                        "If return type is annotated, it must be Tuple[bool, Any] or Tuple[bool, Union[str, TaskOutput]]"
+                    )
+            
+            self._guardrail_fn = self.guardrail
+        elif isinstance(self.guardrail, str):
+            # Create LLM-based guardrail
+            from ..guardrails import LLMGuardrail
+            llm = getattr(self, 'llm', None) or getattr(self, 'llm_instance', None)
+            self._guardrail_fn = LLMGuardrail(description=self.guardrail, llm=llm)
+        else:
+            raise ValueError("Agent guardrail must be either a callable or a string description")
+
+    def _process_guardrail(self, task_output):
+        """Process the guardrail validation for a task output.
+        
+        Args:
+            task_output: The task output to validate
+            
+        Returns:
+            GuardrailResult: The result of the guardrail validation
+        """
+        from ..guardrails import GuardrailResult
+        
+        if not self._guardrail_fn:
+            return GuardrailResult(success=True, result=task_output)
+        
+        try:
+            # Call the guardrail function
+            result = self._guardrail_fn(task_output)
+            
+            # Convert the result to a GuardrailResult
+            return GuardrailResult.from_tuple(result)
+            
+        except Exception as e:
+            logging.error(f"Agent {self.name}: Error in guardrail validation: {e}")
+            # On error, return failure
+            return GuardrailResult(
+                success=False,
+                result=None,
+                error=f"Agent guardrail validation error: {str(e)}"
+            )
+
+    def _apply_guardrail_with_retry(self, response_text, prompt, temperature=0.2, tools=None):
+        """Apply guardrail validation with retry logic.
+        
+        Args:
+            response_text: The response to validate
+            prompt: Original prompt for regeneration if needed
+            temperature: Temperature for regeneration
+            tools: Tools for regeneration
+            
+        Returns:
+            str: The validated response text or None if validation fails after retries
+        """
+        if not self._guardrail_fn:
+            return response_text
+            
+        from ..main import TaskOutput
+        
+        retry_count = 0
+        current_response = response_text
+        
+        while retry_count <= self.max_guardrail_retries:
+            # Create TaskOutput object
+            task_output = TaskOutput(
+                description="Agent response output",
+                raw=current_response,
+                agent=self.name
+            )
+            
+            # Process guardrail
+            guardrail_result = self._process_guardrail(task_output)
+            
+            if guardrail_result.success:
+                logging.info(f"Agent {self.name}: Guardrail validation passed")
+                # Return the potentially modified result
+                if guardrail_result.result and hasattr(guardrail_result.result, 'raw'):
+                    return guardrail_result.result.raw
+                elif guardrail_result.result:
+                    return str(guardrail_result.result)
+                else:
+                    return current_response
+            
+            # Guardrail failed
+            if retry_count >= self.max_guardrail_retries:
+                raise Exception(
+                    f"Agent {self.name} response failed guardrail validation after {self.max_guardrail_retries} retries. "
+                    f"Last error: {guardrail_result.error}"
+                )
+            
+            retry_count += 1
+            logging.warning(f"Agent {self.name}: Guardrail validation failed (retry {retry_count}/{self.max_guardrail_retries}): {guardrail_result.error}")
+            
+            # Regenerate response for retry
+            try:
+                retry_prompt = f"{prompt}\n\nNote: Previous response failed validation due to: {guardrail_result.error}. Please provide an improved response."
+                response = self._chat_completion([{"role": "user", "content": retry_prompt}], temperature, tools)
+                if response and response.choices:
+                    current_response = response.choices[0].message.content.strip()
+                else:
+                    raise Exception("Failed to generate retry response")
+            except Exception as e:
+                logging.error(f"Agent {self.name}: Error during guardrail retry: {e}")
+                # If we can't regenerate, fail the guardrail
+                raise Exception(
+                    f"Agent {self.name} guardrail retry failed: {e}"
+                )
+        
+        return current_response
+
     def generate_task(self) -> 'Task':
         """Generate a Task object from the agent's instructions"""
         from ..task.task import Task
@@ -763,7 +1045,7 @@ Your Goal: {self.goal}
                         tools=formatted_tools if formatted_tools else None,
                         verbose=self.verbose,
                         markdown=self.markdown,
-                        stream=True,
+                        stream=stream,
                         console=self.console,
                         execute_tool_fn=self.execute_tool,
                         agent_name=self.name,
@@ -779,7 +1061,7 @@ Your Goal: {self.goal}
                         tools=formatted_tools if formatted_tools else None,
                         verbose=self.verbose,
                         markdown=self.markdown,
-                        stream=False,
+                        stream=stream,
                         console=self.console,
                         execute_tool_fn=self.execute_tool,
                         agent_name=self.name,
@@ -788,69 +1070,92 @@ Your Goal: {self.goal}
                     )
             else:
                 # Use the standard OpenAI client approach
-                if stream:
-                    # Process as streaming response with formatted tools
-                    final_response = self._process_stream_response(
-                        messages, 
-                        temperature, 
-                        start_time, 
-                        formatted_tools=formatted_tools if formatted_tools else None,
-                        reasoning_steps=reasoning_steps
-                    )
-                else:
-                    # Process as regular non-streaming response
-                    final_response = client.chat.completions.create(
-                        model=self.llm,
-                        messages=messages,
-                        temperature=temperature,
-                        tools=formatted_tools if formatted_tools else None,
-                        stream=False
-                    )
+                # Continue tool execution loop until no more tool calls are needed
+                max_iterations = 10  # Prevent infinite loops
+                iteration_count = 0
+                
+                while iteration_count < max_iterations:
+                    if stream:
+                        # Process as streaming response with formatted tools
+                        final_response = self._process_stream_response(
+                            messages, 
+                            temperature, 
+                            start_time, 
+                            formatted_tools=formatted_tools if formatted_tools else None,
+                            reasoning_steps=reasoning_steps
+                        )
+                    else:
+                        # Process as regular non-streaming response
+                        final_response = client.chat.completions.create(
+                            model=self.llm,
+                            messages=messages,
+                            temperature=temperature,
+                            tools=formatted_tools if formatted_tools else None,
+                            stream=False
+                        )
 
-            tool_calls = getattr(final_response.choices[0].message, 'tool_calls', None)
+                    tool_calls = getattr(final_response.choices[0].message, 'tool_calls', None)
 
-            if tool_calls:
-                messages.append({
-                    "role": "assistant", 
-                    "content": final_response.choices[0].message.content,
-                    "tool_calls": tool_calls
-                })
+                    if tool_calls:
+                        messages.append({
+                            "role": "assistant", 
+                            "content": final_response.choices[0].message.content,
+                            "tool_calls": tool_calls
+                        })
 
-                for tool_call in tool_calls:
-                    function_name = tool_call.function.name
-                    arguments = json.loads(tool_call.function.arguments)
+                        for tool_call in tool_calls:
+                            function_name = tool_call.function.name
+                            arguments = json.loads(tool_call.function.arguments)
 
-                    if self.verbose:
-                        display_tool_call(f"Agent {self.name} is calling function '{function_name}' with arguments: {arguments}")
+                            if self.verbose:
+                                display_tool_call(f"Agent {self.name} is calling function '{function_name}' with arguments: {arguments}")
 
-                    tool_result = self.execute_tool(function_name, arguments)
-                    results_str = json.dumps(tool_result) if tool_result else "Function returned an empty output"
+                            tool_result = self.execute_tool(function_name, arguments)
+                            results_str = json.dumps(tool_result) if tool_result else "Function returned an empty output"
 
-                    if self.verbose:
-                        display_tool_call(f"Function '{function_name}' returned: {results_str}")
+                            if self.verbose:
+                                display_tool_call(f"Function '{function_name}' returned: {results_str}")
 
-                    messages.append({
-                        "role": "tool",
-                        "tool_call_id": tool_call.id,
-                        "content": results_str
-                    })
+                            messages.append({
+                                "role": "tool",
+                                "tool_call_id": tool_call.id,
+                                "content": results_str
+                            })
 
-                # Get final response after tool calls
-                if stream:
-                    final_response = self._process_stream_response(
-                        messages, 
-                        temperature, 
-                        start_time,
-                        formatted_tools=formatted_tools if formatted_tools else None,
-                        reasoning_steps=reasoning_steps
-                    )
-                else:
-                    final_response = client.chat.completions.create(
-                        model=self.llm,
-                        messages=messages,
-                        temperature=temperature,
-                        stream=False
-                    )
+                        # Check if we should continue (for tools like sequential thinking)
+                        should_continue = False
+                        for tool_call in tool_calls:
+                            function_name = tool_call.function.name
+                            arguments = json.loads(tool_call.function.arguments)
+                            
+                            # For sequential thinking tool, check if nextThoughtNeeded is True
+                            if function_name == "sequentialthinking" and arguments.get("nextThoughtNeeded", False):
+                                should_continue = True
+                                break
+
+                        if not should_continue:
+                            # Get final response after tool calls
+                            if stream:
+                                final_response = self._process_stream_response(
+                                    messages, 
+                                    temperature, 
+                                    start_time,
+                                    formatted_tools=formatted_tools if formatted_tools else None,
+                                    reasoning_steps=reasoning_steps
+                                )
+                            else:
+                                final_response = client.chat.completions.create(
+                                    model=self.llm,
+                                    messages=messages,
+                                    temperature=temperature,
+                                    stream=False
+                                )
+                            break
+                        
+                        iteration_count += 1
+                    else:
+                        # No tool calls, we're done
+                        break
 
             return final_response
 
@@ -944,7 +1249,13 @@ Your Goal: {self.goal}
                     total_time = time.time() - start_time
                     logging.debug(f"Agent.chat completed in {total_time:.2f} seconds")
 
-                return response_text
+                # Apply guardrail validation for custom LLM response
+                try:
+                    validated_response = self._apply_guardrail_with_retry(response_text, prompt, temperature, tools)
+                    return validated_response
+                except Exception as e:
+                    logging.error(f"Agent {self.name}: Guardrail validation failed for custom LLM: {e}")
+                    return None
             except Exception as e:
                 display_error(f"Error in LLM chat: {e}")
                 return None
@@ -1008,7 +1319,7 @@ Your Goal: {self.goal}
                                 agent_tools=agent_tools
                             )
 
-                    response = self._chat_completion(messages, temperature=temperature, tools=tools if tools else None, reasoning_steps=reasoning_steps, stream=stream)
+                    response = self._chat_completion(messages, temperature=temperature, tools=tools if tools else None, reasoning_steps=reasoning_steps, stream=self.stream)
                     if not response:
                         return None
 
@@ -1032,12 +1343,24 @@ Your Goal: {self.goal}
                         display_interaction(original_prompt, response_text, markdown=self.markdown, generation_time=time.time() - start_time, console=self.console)
                         # Return only reasoning content if reasoning_steps is True
                         if reasoning_steps and hasattr(response.choices[0].message, 'reasoning_content'):
-                            return response.choices[0].message.reasoning_content
-                        return response_text
+                            # Apply guardrail to reasoning content
+                            try:
+                                validated_reasoning = self._apply_guardrail_with_retry(response.choices[0].message.reasoning_content, original_prompt, temperature, tools)
+                                return validated_reasoning
+                            except Exception as e:
+                                logging.error(f"Agent {self.name}: Guardrail validation failed for reasoning content: {e}")
+                                return None
+                        # Apply guardrail to regular response
+                        try:
+                            validated_response = self._apply_guardrail_with_retry(response_text, original_prompt, temperature, tools)
+                            return validated_response
+                        except Exception as e:
+                            logging.error(f"Agent {self.name}: Guardrail validation failed: {e}")
+                            return None
 
                     reflection_prompt = f"""
 Reflect on your previous response: '{response_text}'.
-Identify any flaws, improvements, or actions.
+{self.reflect_prompt if self.reflect_prompt else "Identify any flaws, improvements, or actions."}
 Provide a "satisfactory" status ('yes' or 'no').
 Output MUST be JSON with 'reflection' and 'satisfactory'.
                     """
@@ -1066,7 +1389,13 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                             self.chat_history.append({"role": "user", "content": prompt})
                             self.chat_history.append({"role": "assistant", "content": response_text})
                             display_interaction(prompt, response_text, markdown=self.markdown, generation_time=time.time() - start_time, console=self.console)
-                            return response_text
+                            # Apply guardrail validation after satisfactory reflection
+                            try:
+                                validated_response = self._apply_guardrail_with_retry(response_text, prompt, temperature, tools)
+                                return validated_response
+                            except Exception as e:
+                                logging.error(f"Agent {self.name}: Guardrail validation failed after reflection: {e}")
+                                return None
 
                         # Check if we've hit max reflections
                         if reflection_count >= self.max_reflect - 1:
@@ -1075,11 +1404,17 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                             self.chat_history.append({"role": "user", "content": prompt})
                             self.chat_history.append({"role": "assistant", "content": response_text})
                             display_interaction(prompt, response_text, markdown=self.markdown, generation_time=time.time() - start_time, console=self.console)
-                            return response_text
+                            # Apply guardrail validation after max reflections
+                            try:
+                                validated_response = self._apply_guardrail_with_retry(response_text, prompt, temperature, tools)
+                                return validated_response
+                            except Exception as e:
+                                logging.error(f"Agent {self.name}: Guardrail validation failed after max reflections: {e}")
+                                return None
 
                         logging.debug(f"{self.name} reflection count {reflection_count + 1}, continuing reflection process")
                         messages.append({"role": "user", "content": "Now regenerate your response using the reflection you made"})
-                        response = self._chat_completion(messages, temperature=temperature, tools=None, stream=stream)
+                        response = self._chat_completion(messages, temperature=temperature, tools=None, stream=self.stream)
                         response_text = response.choices[0].message.content.strip()
                         reflection_count += 1
                         continue  # Continue the loop for more reflections
@@ -1099,8 +1434,16 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
         if logging.getLogger().getEffectiveLevel() == logging.DEBUG:
             total_time = time.time() - start_time
             logging.debug(f"Agent.chat completed in {total_time:.2f} seconds")
-            
-        return response_text
+        
+        # Apply guardrail validation before returning    
+        try:
+            validated_response = self._apply_guardrail_with_retry(response_text, prompt, temperature, tools)
+            return validated_response
+        except Exception as e:
+            logging.error(f"Agent {self.name}: Guardrail validation failed: {e}")
+            if self.verbose:
+                display_error(f"Guardrail validation failed: {e}", console=self.console)
+            return None
 
     def clean_json_output(self, output: str) -> str:
         """Clean and extract JSON from response text."""
@@ -1115,7 +1458,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
         return cleaned  
 
     async def achat(self, prompt: str, temperature=0.2, tools=None, output_json=None, output_pydantic=None, reasoning_steps=False):
-        """Async version of chat method. TODO: Requires Syncing with chat method.""" 
+        """Async version of chat method with self-reflection support.""" 
         # Log all parameter values when in debug mode
         if logging.getLogger().getEffectiveLevel() == logging.DEBUG:
             param_info = {
@@ -1288,10 +1631,79 @@ Your Goal: {self.goal}
                             messages=messages,
                             temperature=temperature
                         )
+                        
+                        response_text = response.choices[0].message.content
+                        
+                        # Handle self-reflection if enabled
+                        if self.self_reflect:
+                            reflection_count = 0
+                            
+                            while True:
+                                reflection_prompt = f"""
+Reflect on your previous response: '{response_text}'.
+{self.reflect_prompt if self.reflect_prompt else "Identify any flaws, improvements, or actions."}
+Provide a "satisfactory" status ('yes' or 'no').
+Output MUST be JSON with 'reflection' and 'satisfactory'.
+                                """
+                                
+                                # Add reflection prompt to messages
+                                reflection_messages = messages + [
+                                    {"role": "assistant", "content": response_text},
+                                    {"role": "user", "content": reflection_prompt}
+                                ]
+                                
+                                try:
+                                    reflection_response = await async_client.beta.chat.completions.parse(
+                                        model=self.reflect_llm if self.reflect_llm else self.llm,
+                                        messages=reflection_messages,
+                                        temperature=temperature,
+                                        response_format=ReflectionOutput
+                                    )
+                                    
+                                    reflection_output = reflection_response.choices[0].message.parsed
+                                    
+                                    if self.verbose:
+                                        display_self_reflection(f"Agent {self.name} self reflection (using {self.reflect_llm if self.reflect_llm else self.llm}): reflection='{reflection_output.reflection}' satisfactory='{reflection_output.satisfactory}'", console=self.console)
+                                    
+                                    # Only consider satisfactory after minimum reflections
+                                    if reflection_output.satisfactory == "yes" and reflection_count >= self.min_reflect - 1:
+                                        if self.verbose:
+                                            display_self_reflection("Agent marked the response as satisfactory after meeting minimum reflections", console=self.console)
+                                        break
+                                    
+                                    # Check if we've hit max reflections
+                                    if reflection_count >= self.max_reflect - 1:
+                                        if self.verbose:
+                                            display_self_reflection("Maximum reflection count reached, returning current response", console=self.console)
+                                        break
+                                    
+                                    # Regenerate response based on reflection
+                                    regenerate_messages = reflection_messages + [
+                                        {"role": "assistant", "content": f"Self Reflection: {reflection_output.reflection} Satisfactory?: {reflection_output.satisfactory}"},
+                                        {"role": "user", "content": "Now regenerate your response using the reflection you made"}
+                                    ]
+                                    
+                                    new_response = await async_client.chat.completions.create(
+                                        model=self.llm,
+                                        messages=regenerate_messages,
+                                        temperature=temperature
+                                    )
+                                    response_text = new_response.choices[0].message.content
+                                    reflection_count += 1
+                                    
+                                except Exception as e:
+                                    if self.verbose:
+                                        display_error(f"Error in parsing self-reflection json {e}. Retrying", console=self.console)
+                                    logging.error("Reflection parsing failed.", exc_info=True)
+                                    reflection_count += 1
+                                    if reflection_count >= self.max_reflect:
+                                        break
+                                    continue
+                        
                         if logging.getLogger().getEffectiveLevel() == logging.DEBUG:
                             total_time = time.time() - start_time
                             logging.debug(f"Agent.achat completed in {total_time:.2f} seconds")
-                        return response.choices[0].message.content
+                        return response_text
                 except Exception as e:
                     display_error(f"Error in chat completion: {e}")
                     if logging.getLogger().getEffectiveLevel() == logging.DEBUG:
@@ -1670,6 +2082,7 @@ Your Goal: {self.goal}
                 import threading
                 import time
                 import inspect
+                import asyncio  # Import asyncio in the MCP scope
                 # logging is already imported at the module level
                 
             except ImportError as e:

src/praisonai-agents/praisonaiagents/guardrails/__init__.py

@@ -0,0 +1,11 @@
+"""
+Guardrails module for PraisonAI Agents.
+
+This module provides validation and safety mechanisms for task outputs,
+including both function-based and LLM-based guardrails.
+"""
+
+from .guardrail_result import GuardrailResult
+from .llm_guardrail import LLMGuardrail
+
+__all__ = ["GuardrailResult", "LLMGuardrail"]

src/praisonai-agents/praisonaiagents/guardrails/guardrail_result.py

@@ -0,0 +1,43 @@
+"""
+Guardrail result classes for PraisonAI Agents.
+
+This module provides the result types for guardrail validation,
+following the same pattern as CrewAI for consistency.
+"""
+
+from typing import Any, Tuple, Union
+from pydantic import BaseModel, Field
+from ..main import TaskOutput
+
+
+class GuardrailResult(BaseModel):
+    """Result of a guardrail validation."""
+    
+    success: bool = Field(description="Whether the guardrail check passed")
+    result: Union[str, TaskOutput, None] = Field(description="The result if modified, or None if unchanged")
+    error: str = Field(default="", description="Error message if validation failed")
+    
+    @classmethod
+    def from_tuple(cls, result: Tuple[bool, Any]) -> "GuardrailResult":
+        """Create a GuardrailResult from a tuple returned by a guardrail function.
+        
+        Args:
+            result: Tuple of (success, result_or_error)
+            
+        Returns:
+            GuardrailResult: The structured result
+        """
+        success, data = result
+        
+        if success:
+            return cls(
+                success=True,
+                result=data,
+                error=""
+            )
+        else:
+            return cls(
+                success=False,
+                result=None,
+                error=str(data) if data else "Guardrail validation failed"
+            )

src/praisonai-agents/praisonaiagents/guardrails/llm_guardrail.py

@@ -0,0 +1,88 @@
+"""
+LLM-based guardrail implementation for PraisonAI Agents.
+
+This module provides LLM-powered guardrails that can validate task outputs
+using natural language descriptions, similar to CrewAI's implementation.
+"""
+
+import logging
+from typing import Any, Tuple, Union, Optional
+from pydantic import BaseModel
+from ..main import TaskOutput
+
+
+class LLMGuardrail:
+    """An LLM-powered guardrail that validates task outputs using natural language."""
+    
+    def __init__(self, description: str, llm: Any = None):
+        """Initialize the LLM guardrail.
+        
+        Args:
+            description: Natural language description of what to validate
+            llm: The LLM instance to use for validation
+        """
+        self.description = description
+        self.llm = llm
+        self.logger = logging.getLogger(__name__)
+    
+    def __call__(self, task_output: TaskOutput) -> Tuple[bool, Union[str, TaskOutput]]:
+        """Validate the task output using the LLM.
+        
+        Args:
+            task_output: The task output to validate
+            
+        Returns:
+            Tuple of (success, result) where result is the output or error message
+        """
+        try:
+            if not self.llm:
+                self.logger.warning("No LLM provided for guardrail validation")
+                return True, task_output
+            
+            # Create validation prompt
+            validation_prompt = f"""
+You are a quality assurance validator. Your task is to evaluate the following output against specific criteria.
+
+Validation Criteria: {self.description}
+
+Output to Validate:
+{task_output.raw}
+
+Please evaluate if this output meets the criteria. Respond with:
+1. "PASS" if the output meets all criteria
+2. "FAIL: [specific reason]" if the output does not meet criteria
+
+Your response:"""
+
+            # Get LLM response
+            if hasattr(self.llm, 'chat'):
+                # For Agent's LLM interface
+                response = self.llm.chat(validation_prompt, temperature=0.1)
+            elif hasattr(self.llm, 'get_response'):
+                # For custom LLM instances
+                response = self.llm.get_response(validation_prompt, temperature=0.1)
+            elif callable(self.llm):
+                # For simple callable LLMs
+                response = self.llm(validation_prompt)
+            else:
+                self.logger.error(f"Unsupported LLM type: {type(self.llm)}")
+                return True, task_output
+            
+            # Parse response
+            response = str(response).strip()
+            
+            if response.upper().startswith("PASS"):
+                return True, task_output
+            elif response.upper().startswith("FAIL"):
+                # Extract the reason
+                reason = response[5:].strip(": ")
+                return False, f"Guardrail validation failed: {reason}"
+            else:
+                # Unclear response, log and pass through
+                self.logger.warning(f"Unclear guardrail response: {response}")
+                return True, task_output
+                
+        except Exception as e:
+            self.logger.error(f"Error in LLM guardrail validation: {str(e)}")
+            # On error, pass through the original output
+            return True, task_output

src/praisonai-agents/praisonaiagents/llm/__init__.py

@@ -1,5 +1,9 @@
 import logging
 import warnings
+import os
+
+# Disable litellm telemetry before any imports
+os.environ["LITELLM_TELEMETRY"] = "False"
 
 # Suppress all relevant logs at module level
 logging.getLogger("litellm").setLevel(logging.ERROR)
@@ -17,4 +21,11 @@ logging.basicConfig(level=logging.WARNING)
 # Import after suppressing warnings
 from .llm import LLM, LLMContextLengthExceededException
 
+# Ensure telemetry is disabled after import as well
+try:
+    import litellm
+    litellm.telemetry = False
+except ImportError:
+    pass
+
 __all__ = ["LLM", "LLMContextLengthExceededException"]

src/praisonai-agents/praisonaiagents/llm/llm.py

@@ -17,6 +17,9 @@ from ..main import (
 from rich.console import Console
 from rich.live import Live
 
+# Disable litellm telemetry before any imports
+os.environ["LITELLM_TELEMETRY"] = "False"
+
 # TODO: Include in-build tool calling in LLM class
 # TODO: Restructure so that duplicate calls are not made (Sync with agent.py)
 class LLMContextLengthExceededException(Exception):
@@ -108,6 +111,9 @@ class LLM:
     ):
         try:
             import litellm
+            # Disable telemetry
+            litellm.telemetry = False
+            
             # Set litellm options globally
             litellm.set_verbose = False
             litellm.success_callback = []
@@ -290,6 +296,7 @@ class LLM:
         agent_role: Optional[str] = None,
         agent_tools: Optional[List[str]] = None,
         execute_tool_fn: Optional[Callable] = None,
+        stream: bool = True,
         **kwargs
     ) -> str:
         """Enhanced get_response with all OpenAI-like features"""
@@ -413,24 +420,30 @@ class LLM:
             start_time = time.time()
             reflection_count = 0
 
-            while True:
-                try:
-                    if verbose:
-                        display_text = prompt
-                        if isinstance(prompt, list):
-                            display_text = next((item["text"] for item in prompt if item["type"] == "text"), "")
-                        
-                        if display_text and str(display_text).strip():
-                            display_instruction(
-                                f"Agent {agent_name} is processing prompt: {display_text}",
-                                console=console,
-                                agent_name=agent_name,
-                                agent_role=agent_role,
-                                agent_tools=agent_tools
-                            )
+            # Display initial instruction once
+            if verbose:
+                display_text = prompt
+                if isinstance(prompt, list):
+                    display_text = next((item["text"] for item in prompt if item["type"] == "text"), "")
+                
+                if display_text and str(display_text).strip():
+                    display_instruction(
+                        f"Agent {agent_name} is processing prompt: {display_text}",
+                        console=console,
+                        agent_name=agent_name,
+                        agent_role=agent_role,
+                        agent_tools=agent_tools
+                    )
 
+            # Sequential tool calling loop - similar to agent.py
+            max_iterations = 10  # Prevent infinite loops
+            iteration_count = 0
+            final_response_text = ""
+
+            while iteration_count < max_iterations:
+                try:
                     # Get response from LiteLLM
-                    start_time = time.time()
+                    current_time = time.time()
 
                     # If reasoning_steps is True, do a single non-streaming call
                     if reasoning_steps:
@@ -445,6 +458,7 @@ class LLM:
                         )
                         reasoning_content = resp["choices"][0]["message"].get("provider_specific_fields", {}).get("reasoning_content")
                         response_text = resp["choices"][0]["message"]["content"]
+                        final_response = resp
                         
                         # Optionally display reasoning if present
                         if verbose and reasoning_content:
@@ -452,7 +466,7 @@ class LLM:
                                 original_prompt,
                                 f"Reasoning:\n{reasoning_content}\n\nAnswer:\n{response_text}",
                                 markdown=markdown,
-                                generation_time=time.time() - start_time,
+                                generation_time=time.time() - current_time,
                                 console=console
                             )
                         else:
@@ -460,28 +474,28 @@ class LLM:
                                 original_prompt,
                                 response_text,
                                 markdown=markdown,
-                                generation_time=time.time() - start_time,
+                                generation_time=time.time() - current_time,
                                 console=console
                             )
                     
                     # Otherwise do the existing streaming approach
                     else:
                         if verbose:
-                            with Live(display_generating("", start_time), console=console, refresh_per_second=4) as live:
+                            with Live(display_generating("", current_time), console=console, refresh_per_second=4) as live:
                                 response_text = ""
                                 for chunk in litellm.completion(
                                     **self._build_completion_params(
                                         messages=messages,
                                         tools=formatted_tools,
                                         temperature=temperature,
-                                        stream=True,
+                                        stream=stream,
                                         **kwargs
                                     )
                                 ):
                                     if chunk and chunk.choices and chunk.choices[0].delta.content:
                                         content = chunk.choices[0].delta.content
                                         response_text += content
-                                        live.update(display_generating(response_text, start_time))
+                                        live.update(display_generating(response_text, current_time))
                         else:
                             # Non-verbose mode, just collect the response
                             response_text = ""
@@ -490,7 +504,7 @@ class LLM:
                                     messages=messages,
                                     tools=formatted_tools,
                                     temperature=temperature,
-                                    stream=True,
+                                    stream=stream,
                                     **kwargs
                                 )
                             ):
@@ -499,20 +513,20 @@ class LLM:
 
                         response_text = response_text.strip()
 
-                    # Get final completion to check for tool calls
-                    final_response = litellm.completion(
-                        **self._build_completion_params(
-                            messages=messages,
-                            tools=formatted_tools,
-                            temperature=temperature,
-                            stream=False,  # No streaming for tool call check
-                            **kwargs
+                        # Get final completion to check for tool calls
+                        final_response = litellm.completion(
+                            **self._build_completion_params(
+                                messages=messages,
+                                tools=formatted_tools,
+                                temperature=temperature,
+                                stream=False,  # No streaming for tool call check
+                                **kwargs
+                            )
                         )
-                    )
                     
                     tool_calls = final_response["choices"][0]["message"].get("tool_calls")
                     
-                    # Handle tool calls
+                    # Handle tool calls - Sequential tool calling logic
                     if tool_calls and execute_tool_fn:
                         # Convert tool_calls to a serializable format for all providers
                         serializable_tool_calls = []
@@ -535,6 +549,8 @@ class LLM:
                             "tool_calls": serializable_tool_calls
                         })
                         
+                        should_continue = False
+                        tool_results = []  # Store all tool results
                         for tool_call in tool_calls:
                             # Handle both object and dict access patterns
                             if isinstance(tool_call, dict):
@@ -555,6 +571,7 @@ class LLM:
                             logging.debug(f"[TOOL_EXEC_DEBUG] About to execute tool {function_name} with args: {arguments}")
                             tool_result = execute_tool_fn(function_name, arguments)
                             logging.debug(f"[TOOL_EXEC_DEBUG] Tool execution result: {tool_result}")
+                            tool_results.append(tool_result)  # Store the result
 
                             if verbose:
                                 display_message = f"Agent {agent_name} called function '{function_name}' with arguments: {arguments}\n"
@@ -574,8 +591,21 @@ class LLM:
                                 "content": json.dumps(tool_result) if tool_result is not None else "Function returned an empty output"
                             })
 
+                            # Check if we should continue (for tools like sequential thinking)
+                            # This mimics the logic from agent.py lines 1004-1007
+                            if function_name == "sequentialthinking" and arguments.get("nextThoughtNeeded", False):
+                                should_continue = True
+                        
+                        # If we should continue, increment iteration and continue loop
+                        if should_continue:
+                            iteration_count += 1
+                            continue
+
+                        # If we reach here, no more tool calls needed - get final response
+                        # Make one more call to get the final summary response
                         # Special handling for Ollama models that don't automatically process tool results
-                        if self.model and self.model.startswith("ollama/") and tool_result:
+                        ollama_handled = False
+                        if self.model and self.model.startswith("ollama/") and tool_results:
                             # For Ollama models, we need to explicitly ask the model to process the tool results
                             # First, check if the response is just a JSON tool call
                             try:
@@ -588,13 +618,30 @@ class LLM:
                                     # Create a prompt that asks the model to process the tool results based on original context
                                     # Extract the original user query from messages
                                     original_query = ""
-                                    for msg in messages:
+                                    for msg in reversed(messages):  # Look from the end to find the most recent user message
                                         if msg.get("role") == "user":
-                                            original_query = msg.get("content", "")
-                                            break
+                                            content = msg.get("content", "")
+                                            # Handle list content (multimodal)
+                                            if isinstance(content, list):
+                                                for item in content:
+                                                    if isinstance(item, dict) and item.get("type") == "text":
+                                                        original_query = item.get("text", "")
+                                                        break
+                                            else:
+                                                original_query = content
+                                            if original_query:
+                                                break
                                     
-                                    # Create a shorter follow-up prompt
-                                    follow_up_prompt = f"Results:\n{json.dumps(tool_result, indent=2)}\nProvide Answer to this Original Question based on the above results: '{original_query}'"
+                                    # Create a shorter follow-up prompt with all tool results
+                                    # If there's only one result, use it directly; otherwise combine them
+                                    if len(tool_results) == 1:
+                                        results_text = json.dumps(tool_results[0], indent=2)
+                                    else:
+                                        results_text = json.dumps(tool_results, indent=2)
+                                    
+                                    follow_up_prompt = f"Results:\n{results_text}\nProvide Answer to this Original Question based on the above results: '{original_query}'"
+                                    logging.debug(f"[OLLAMA_DEBUG] Original query extracted: {original_query}")
+                                    logging.debug(f"[OLLAMA_DEBUG] Follow-up prompt: {follow_up_prompt[:200]}...")
                                     
                                     # Make a follow-up call to process the results
                                     follow_up_messages = [
@@ -609,7 +656,7 @@ class LLM:
                                                 **self._build_completion_params(
                                                     messages=follow_up_messages,
                                                     temperature=temperature,
-                                                    stream=True
+                                                    stream=stream
                                                 )
                                             ):
                                                 if chunk and chunk.choices and chunk.choices[0].delta.content:
@@ -622,17 +669,38 @@ class LLM:
                                             **self._build_completion_params(
                                                 messages=follow_up_messages,
                                                 temperature=temperature,
-                                                stream=True
+                                                stream=stream
                                             )
                                         ):
                                             if chunk and chunk.choices and chunk.choices[0].delta.content:
                                                 response_text += chunk.choices[0].delta.content
+                                    
+                                    # Set flag to indicate Ollama was handled
+                                    ollama_handled = True
+                                    final_response_text = response_text.strip()
+                                    logging.debug(f"[OLLAMA_DEBUG] Ollama follow-up response: {final_response_text[:200]}...")
+                                    
+                                    # Display the response if we got one
+                                    if final_response_text and verbose:
+                                        display_interaction(
+                                            original_prompt,
+                                            final_response_text,
+                                            markdown=markdown,
+                                            generation_time=time.time() - start_time,
+                                            console=console
+                                        )
+                                    
+                                    # Return the final response after processing Ollama's follow-up
+                                    if final_response_text:
+                                        return final_response_text
+                                    else:
+                                        logging.warning("[OLLAMA_DEBUG] Ollama follow-up returned empty response")
                             except (json.JSONDecodeError, KeyError):
                                 # Not a JSON response or not a tool call format, continue normally
                                 pass
                         
-                        # If reasoning_steps is True, do a single non-streaming call
-                        elif reasoning_steps:
+                        # If reasoning_steps is True and we haven't handled Ollama already, do a single non-streaming call
+                        if reasoning_steps and not ollama_handled:
                             resp = litellm.completion(
                                 **self._build_completion_params(
                                     messages=messages,
@@ -662,172 +730,252 @@ class LLM:
                                     console=console
                                 )
                         
-                        # Otherwise do the existing streaming approach
-                        else:
+                        # Otherwise do the existing streaming approach if not already handled
+                        elif not ollama_handled:
                             # Get response after tool calls with streaming
                             if verbose:
-                                with Live(display_generating("", start_time), console=console, refresh_per_second=4) as live:
-                                    response_text = ""
+                                with Live(display_generating("", current_time), console=console, refresh_per_second=4) as live:
+                                    final_response_text = ""
                                     for chunk in litellm.completion(
                                         **self._build_completion_params(
                                             messages=messages,
+                                            tools=formatted_tools,
                                             temperature=temperature,
-                                            stream=True
+                                            stream=True,
+                                            **kwargs
                                         )
                                     ):
                                         if chunk and chunk.choices and chunk.choices[0].delta.content:
                                             content = chunk.choices[0].delta.content
-                                            response_text += content
-                                            live.update(display_generating(response_text, start_time))
+                                            final_response_text += content
+                                            live.update(display_generating(final_response_text, current_time))
                             else:
-                                response_text = ""
+                                final_response_text = ""
                                 for chunk in litellm.completion(
                                     **self._build_completion_params(
                                         messages=messages,
+                                        tools=formatted_tools,
                                         temperature=temperature,
-                                        stream=True
+                                        stream=stream,
+                                        **kwargs
                                     )
                                 ):
                                     if chunk and chunk.choices and chunk.choices[0].delta.content:
-                                        response_text += chunk.choices[0].delta.content
-
-                            response_text = response_text.strip()
-
-                    # Handle output formatting
-                    if output_json or output_pydantic:
-                        self.chat_history.append({"role": "user", "content": original_prompt})
-                        self.chat_history.append({"role": "assistant", "content": response_text})
+                                        final_response_text += chunk.choices[0].delta.content
+                            
+                            final_response_text = final_response_text.strip()
+                        
+                        # Display final response
                         if verbose:
-                            display_interaction(original_prompt, response_text, markdown=markdown,
-                                             generation_time=time.time() - start_time, console=console)
-                        return response_text
+                            display_interaction(
+                                original_prompt,
+                                final_response_text,
+                                markdown=markdown,
+                                generation_time=time.time() - start_time,
+                                console=console
+                            )
+                        
+                        return final_response_text
+                    else:
+                        # No tool calls, we're done with this iteration
+                        break
+                        
+                except Exception as e:
+                    logging.error(f"Error in LLM iteration {iteration_count}: {e}")
+                    break
+                    
+            # End of while loop - return final response
+            if final_response_text:
+                return final_response_text
+            
+            # No tool calls were made in this iteration, return the response
+            if verbose:
+                display_interaction(
+                    original_prompt,
+                    response_text,
+                    markdown=markdown,
+                    generation_time=time.time() - start_time,
+                    console=console
+                )
+            
+            response_text = response_text.strip()
+            
+            # Handle output formatting
+            if output_json or output_pydantic:
+                self.chat_history.append({"role": "user", "content": original_prompt})
+                self.chat_history.append({"role": "assistant", "content": response_text})
+                if verbose:
+                    display_interaction(original_prompt, response_text, markdown=markdown,
+                                     generation_time=time.time() - start_time, console=console)
+                return response_text
 
-                    if not self_reflect:
-                        if verbose:
-                            display_interaction(original_prompt, response_text, markdown=markdown,
-                                             generation_time=time.time() - start_time, console=console)
-                        # Return reasoning content if reasoning_steps is True
-                        if reasoning_steps and reasoning_content:
-                            return reasoning_content
-                        return response_text
+            if not self_reflect:
+                if verbose:
+                    display_interaction(original_prompt, response_text, markdown=markdown,
+                                     generation_time=time.time() - start_time, console=console)
+                # Return reasoning content if reasoning_steps is True
+                if reasoning_steps and reasoning_content:
+                    return reasoning_content
+                return response_text
 
-                    # Handle self-reflection
-                    reflection_prompt = f"""
+            # Handle self-reflection loop
+            while reflection_count < max_reflect:
+                # Handle self-reflection
+                reflection_prompt = f"""
 Reflect on your previous response: '{response_text}'.
 Identify any flaws, improvements, or actions.
 Provide a "satisfactory" status ('yes' or 'no').
 Output MUST be JSON with 'reflection' and 'satisfactory'.
-                    """
-                    
-                    reflection_messages = messages + [
-                        {"role": "assistant", "content": response_text},
-                        {"role": "user", "content": reflection_prompt}
-                    ]
+                """
+                
+                reflection_messages = messages + [
+                    {"role": "assistant", "content": response_text},
+                    {"role": "user", "content": reflection_prompt}
+                ]
 
-                    # If reasoning_steps is True, do a single non-streaming call to capture reasoning
-                    if reasoning_steps:
-                        reflection_resp = litellm.completion(
-                            **self._build_completion_params(
-                                messages=reflection_messages,
-                                temperature=temperature,
-                                stream=False,  # Force non-streaming
-                                response_format={"type": "json_object"},
-                                **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
-                            )
+                # If reasoning_steps is True, do a single non-streaming call to capture reasoning
+                if reasoning_steps:
+                    reflection_resp = litellm.completion(
+                        **self._build_completion_params(
+                            messages=reflection_messages,
+                            temperature=temperature,
+                            stream=False,  # Force non-streaming
+                            response_format={"type": "json_object"},
+                            **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
                         )
-                        # Grab reflection text and optional reasoning
-                        reasoning_content = reflection_resp["choices"][0]["message"].get("provider_specific_fields", {}).get("reasoning_content")
-                        reflection_text = reflection_resp["choices"][0]["message"]["content"]
+                    )
+                    # Grab reflection text and optional reasoning
+                    reasoning_content = reflection_resp["choices"][0]["message"].get("provider_specific_fields", {}).get("reasoning_content")
+                    reflection_text = reflection_resp["choices"][0]["message"]["content"]
 
-                        # Optionally display reasoning if present
-                        if verbose and reasoning_content:
-                            display_interaction(
-                                "Reflection reasoning:",
-                                f"{reasoning_content}\n\nReflection result:\n{reflection_text}",
-                                markdown=markdown,
-                                generation_time=time.time() - start_time,
-                                console=console
-                            )
-                        elif verbose:
-                            display_interaction(
-                                "Self-reflection (non-streaming):",
-                                reflection_text,
-                                markdown=markdown,
-                                generation_time=time.time() - start_time,
-                                console=console
-                            )
-                    else:
-                        # Existing streaming approach
-                        if verbose:
-                            with Live(display_generating("", start_time), console=console, refresh_per_second=4) as live:
-                                reflection_text = ""
-                                for chunk in litellm.completion(
-                                    **self._build_completion_params(
-                                        messages=reflection_messages,
-                                        temperature=temperature,
-                                        stream=True,
-                                        response_format={"type": "json_object"},
-                                        **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
-                                    )
-                                ):
-                                    if chunk and chunk.choices and chunk.choices[0].delta.content:
-                                        content = chunk.choices[0].delta.content
-                                        reflection_text += content
-                                        live.update(display_generating(reflection_text, start_time))
-                        else:
+                    # Optionally display reasoning if present
+                    if verbose and reasoning_content:
+                        display_interaction(
+                            "Reflection reasoning:",
+                            f"{reasoning_content}\n\nReflection result:\n{reflection_text}",
+                            markdown=markdown,
+                            generation_time=time.time() - start_time,
+                            console=console
+                        )
+                    elif verbose:
+                        display_interaction(
+                            "Self-reflection (non-streaming):",
+                            reflection_text,
+                            markdown=markdown,
+                            generation_time=time.time() - start_time,
+                            console=console
+                        )
+                else:
+                    # Existing streaming approach
+                    if verbose:
+                        with Live(display_generating("", start_time), console=console, refresh_per_second=4) as live:
                             reflection_text = ""
                             for chunk in litellm.completion(
                                 **self._build_completion_params(
                                     messages=reflection_messages,
                                     temperature=temperature,
-                                    stream=True,
+                                    stream=stream,
                                     response_format={"type": "json_object"},
                                     **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
                                 )
                             ):
                                 if chunk and chunk.choices and chunk.choices[0].delta.content:
-                                    reflection_text += chunk.choices[0].delta.content
-
-                    try:
-                        reflection_data = json.loads(reflection_text)
-                        satisfactory = reflection_data.get("satisfactory", "no").lower() == "yes"
-
-                        if verbose:
-                            display_self_reflection(
-                                f"Agent {agent_name} self reflection: reflection='{reflection_data['reflection']}' satisfactory='{reflection_data['satisfactory']}'",
-                                console=console
+                                    content = chunk.choices[0].delta.content
+                                    reflection_text += content
+                                    live.update(display_generating(reflection_text, start_time))
+                    else:
+                        reflection_text = ""
+                        for chunk in litellm.completion(
+                            **self._build_completion_params(
+                                messages=reflection_messages,
+                                temperature=temperature,
+                                stream=stream,
+                                response_format={"type": "json_object"},
+                                **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
                             )
+                        ):
+                            if chunk and chunk.choices and chunk.choices[0].delta.content:
+                                reflection_text += chunk.choices[0].delta.content
 
-                        if satisfactory and reflection_count >= min_reflect - 1:
-                            if verbose:
-                                display_interaction(prompt, response_text, markdown=markdown,
-                                                 generation_time=time.time() - start_time, console=console)
-                            return response_text
+                try:
+                    reflection_data = json.loads(reflection_text)
+                    satisfactory = reflection_data.get("satisfactory", "no").lower() == "yes"
 
-                        if reflection_count >= max_reflect - 1:
-                            if verbose:
-                                display_interaction(prompt, response_text, markdown=markdown,
-                                                 generation_time=time.time() - start_time, console=console)
-                            return response_text
+                    if verbose:
+                        display_self_reflection(
+                            f"Agent {agent_name} self reflection: reflection='{reflection_data['reflection']}' satisfactory='{reflection_data['satisfactory']}'",
+                            console=console
+                        )
 
-                        reflection_count += 1
-                        messages.extend([
-                            {"role": "assistant", "content": response_text},
-                            {"role": "user", "content": reflection_prompt},
-                            {"role": "assistant", "content": reflection_text},
-                            {"role": "user", "content": "Now regenerate your response using the reflection you made"}
-                        ])
-                        continue
+                    if satisfactory and reflection_count >= min_reflect - 1:
+                        if verbose:
+                            display_interaction(prompt, response_text, markdown=markdown,
+                                             generation_time=time.time() - start_time, console=console)
+                        return response_text
 
-                    except json.JSONDecodeError:
-                        reflection_count += 1
-                        if reflection_count >= max_reflect:
-                            return response_text
-                        continue
+                    if reflection_count >= max_reflect - 1:
+                        if verbose:
+                            display_interaction(prompt, response_text, markdown=markdown,
+                                             generation_time=time.time() - start_time, console=console)
+                        return response_text
 
+                    reflection_count += 1
+                    messages.extend([
+                        {"role": "assistant", "content": response_text},
+                        {"role": "user", "content": reflection_prompt},
+                        {"role": "assistant", "content": reflection_text},
+                        {"role": "user", "content": "Now regenerate your response using the reflection you made"}
+                    ])
+                    
+                    # Get new response after reflection
+                    if verbose:
+                        with Live(display_generating("", time.time()), console=console, refresh_per_second=4) as live:
+                            response_text = ""
+                            for chunk in litellm.completion(
+                                **self._build_completion_params(
+                                    messages=messages,
+                                    temperature=temperature,
+                                    stream=True,
+                                    **kwargs
+                                )
+                            ):
+                                if chunk and chunk.choices and chunk.choices[0].delta.content:
+                                    content = chunk.choices[0].delta.content
+                                    response_text += content
+                                    live.update(display_generating(response_text, time.time()))
+                    else:
+                        response_text = ""
+                        for chunk in litellm.completion(
+                            **self._build_completion_params(
+                                messages=messages,
+                                temperature=temperature,
+                                stream=True,
+                                **kwargs
+                            )
+                        ):
+                            if chunk and chunk.choices and chunk.choices[0].delta.content:
+                                response_text += chunk.choices[0].delta.content
+                    
+                    response_text = response_text.strip()
+                    continue
+
+                except json.JSONDecodeError:
+                    reflection_count += 1
+                    if reflection_count >= max_reflect:
+                        if verbose:
+                            display_interaction(prompt, response_text, markdown=markdown,
+                                             generation_time=time.time() - start_time, console=console)
+                        return response_text
+                    continue
                 except Exception as e:
                     display_error(f"Error in LLM response: {str(e)}")
                     return None
+            
+            # If we've exhausted reflection attempts
+            if verbose:
+                display_interaction(prompt, response_text, markdown=markdown,
+                                 generation_time=time.time() - start_time, console=console)
+            return response_text
 
         except Exception as error:
             display_error(f"Error in get_response: {str(error)}")
@@ -857,6 +1005,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
         agent_role: Optional[str] = None,
         agent_tools: Optional[List[str]] = None,
         execute_tool_fn: Optional[Callable] = None,
+        stream: bool = True,
         **kwargs
     ) -> str:
         """Async version of get_response with identical functionality."""
@@ -1057,7 +1206,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                         **self._build_completion_params(
                             messages=messages,
                             temperature=temperature,
-                            stream=True,
+                            stream=stream,
                             **kwargs
                         )
                     ):
@@ -1071,7 +1220,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                         **self._build_completion_params(
                             messages=messages,
                             temperature=temperature,
-                            stream=True,
+                            stream=stream,
                             **kwargs
                         )
                     ):
@@ -1119,6 +1268,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                         "tool_calls": serializable_tool_calls
                     })
                     
+                    tool_results = []  # Store all tool results
                     for tool_call in tool_calls:
                         # Handle both object and dict access patterns
                         if isinstance(tool_call, dict):
@@ -1137,6 +1287,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                                 tool_call_id = f"tool_{id(tool_call)}"
 
                         tool_result = await execute_tool_fn(function_name, arguments)
+                        tool_results.append(tool_result)  # Store the result
 
                         if verbose:
                             display_message = f"Agent {agent_name} called function '{function_name}' with arguments: {arguments}\n"
@@ -1155,7 +1306,8 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                     response_text = ""
                     
                     # Special handling for Ollama models that don't automatically process tool results
-                    if self._is_ollama_provider() and tool_result:
+                    ollama_handled = False
+                    if self._is_ollama_provider() and tool_results:
                         # For Ollama models, we need to explicitly ask the model to process the tool results
                         # First, check if the response is just a JSON tool call
                         try:
@@ -1168,13 +1320,30 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                                 # Create a prompt that asks the model to process the tool results based on original context
                                 # Extract the original user query from messages
                                 original_query = ""
-                                for msg in messages:
+                                for msg in reversed(messages):  # Look from the end to find the most recent user message
                                     if msg.get("role") == "user":
-                                        original_query = msg.get("content", "")
-                                        break
+                                        content = msg.get("content", "")
+                                        # Handle list content (multimodal)
+                                        if isinstance(content, list):
+                                            for item in content:
+                                                if isinstance(item, dict) and item.get("type") == "text":
+                                                    original_query = item.get("text", "")
+                                                    break
+                                        else:
+                                            original_query = content
+                                        if original_query:
+                                            break
                                 
-                                # Create a shorter follow-up prompt
-                                follow_up_prompt = f"Results:\n{json.dumps(tool_result, indent=2)}\nProvide Answer to this Original Question based on the above results: '{original_query}'"
+                                # Create a shorter follow-up prompt with all tool results
+                                # If there's only one result, use it directly; otherwise combine them
+                                if len(tool_results) == 1:
+                                    results_text = json.dumps(tool_results[0], indent=2)
+                                else:
+                                    results_text = json.dumps(tool_results, indent=2)
+                                
+                                follow_up_prompt = f"Results:\n{results_text}\nProvide Answer to this Original Question based on the above results: '{original_query}'"
+                                logging.debug(f"[OLLAMA_DEBUG] Original query extracted: {original_query}")
+                                logging.debug(f"[OLLAMA_DEBUG] Follow-up prompt: {follow_up_prompt[:200]}...")
                                 
                                 # Make a follow-up call to process the results
                                 follow_up_messages = [
@@ -1188,7 +1357,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                                         **self._build_completion_params(
                                             messages=follow_up_messages,
                                             temperature=temperature,
-                                            stream=True
+                                            stream=stream
                                         )
                                     ):
                                         if chunk and chunk.choices and chunk.choices[0].delta.content:
@@ -1202,17 +1371,38 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                                         **self._build_completion_params(
                                             messages=follow_up_messages,
                                             temperature=temperature,
-                                            stream=True
+                                            stream=stream
                                         )
                                     ):
                                         if chunk and chunk.choices and chunk.choices[0].delta.content:
                                             response_text += chunk.choices[0].delta.content
+                                
+                                # Set flag to indicate Ollama was handled
+                                ollama_handled = True
+                                final_response_text = response_text.strip()
+                                logging.debug(f"[OLLAMA_DEBUG] Ollama follow-up response: {final_response_text[:200]}...")
+                                
+                                # Display the response if we got one
+                                if final_response_text and verbose:
+                                    display_interaction(
+                                        original_prompt,
+                                        final_response_text,
+                                        markdown=markdown,
+                                        generation_time=time.time() - start_time,
+                                        console=console
+                                    )
+                                
+                                # Return the final response after processing Ollama's follow-up
+                                if final_response_text:
+                                    return final_response_text
+                                else:
+                                    logging.warning("[OLLAMA_DEBUG] Ollama follow-up returned empty response")
                         except (json.JSONDecodeError, KeyError):
                             # Not a JSON response or not a tool call format, continue normally
                             pass
                     
                     # If no special handling was needed or if it's not an Ollama model
-                    elif reasoning_steps:
+                    if reasoning_steps and not ollama_handled:
                         # Non-streaming call to capture reasoning
                         resp = await litellm.acompletion(
                             **self._build_completion_params(
@@ -1242,14 +1432,14 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                                 generation_time=time.time() - start_time,
                                 console=console
                             )
-                    else:
-                        # Get response after tool calls with streaming
+                    elif not ollama_handled:
+                        # Get response after tool calls with streaming if not already handled
                         if verbose:
                             async for chunk in await litellm.acompletion(
                                 **self._build_completion_params(
                                     messages=messages,
                                     temperature=temperature,
-                                    stream=True,
+                                    stream=stream,
                                     tools=formatted_tools,
                                     **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
                                 )
@@ -1265,7 +1455,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                                 **self._build_completion_params(
                                     messages=messages,
                                     temperature=temperature,
-                                    stream=True,
+                                    stream=stream,
                                     **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
                                 )
                             ):
@@ -1346,7 +1536,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                             **self._build_completion_params(
                                 messages=reflection_messages,
                                 temperature=temperature,
-                                stream=True,
+                                stream=stream,
                                 response_format={"type": "json_object"},
                                 **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
                             )
@@ -1361,7 +1551,7 @@ Output MUST be JSON with 'reflection' and 'satisfactory'.
                         **self._build_completion_params(
                             messages=reflection_messages,
                             temperature=temperature,
-                            stream=True,
+                            stream=stream,
                             response_format={"type": "json_object"},
                             **{k:v for k,v in kwargs.items() if k != 'reasoning_steps'}
                         )

src/praisonai-agents/praisonaiagents/mcp/mcp.py

@@ -379,6 +379,43 @@ class MCP:
         """
         return iter(self._tools)
     
+    def _fix_array_schemas(self, schema):
+        """
+        Fix array schemas by adding missing 'items' attribute required by OpenAI.
+        
+        This ensures compatibility with OpenAI's function calling format which
+        requires array types to specify the type of items they contain.
+        
+        Args:
+            schema: The schema dictionary to fix
+            
+        Returns:
+            dict: The fixed schema
+        """
+        if not isinstance(schema, dict):
+            return schema
+            
+        # Create a copy to avoid modifying the original
+        fixed_schema = schema.copy()
+        
+        # Fix array types at the current level
+        if fixed_schema.get("type") == "array" and "items" not in fixed_schema:
+            # Add a default items schema for arrays without it
+            fixed_schema["items"] = {"type": "string"}
+            
+        # Recursively fix nested schemas
+        if "properties" in fixed_schema:
+            fixed_properties = {}
+            for prop_name, prop_schema in fixed_schema["properties"].items():
+                fixed_properties[prop_name] = self._fix_array_schemas(prop_schema)
+            fixed_schema["properties"] = fixed_properties
+            
+        # Fix items schema if it exists
+        if "items" in fixed_schema:
+            fixed_schema["items"] = self._fix_array_schemas(fixed_schema["items"])
+            
+        return fixed_schema
+    
     def to_openai_tool(self):
         """Convert the MCP tool to an OpenAI-compatible tool definition.
         
@@ -404,7 +441,8 @@ class MCP:
             # Create OpenAI tool definition
             parameters = {}
             if hasattr(tool, 'inputSchema') and tool.inputSchema:
-                parameters = tool.inputSchema
+                # Fix array schemas to include 'items' attribute
+                parameters = self._fix_array_schemas(tool.inputSchema)
             else:
                 # Create a minimal schema if none exists
                 parameters = {

src/praisonai-agents/praisonaiagents/mcp/mcp_sse.py

@@ -88,14 +88,54 @@ class SSEMCPTool:
             logger.error(f"Error in _async_call for {self.name}: {e}")
             raise
     
+    def _fix_array_schemas(self, schema):
+        """
+        Fix array schemas by adding missing 'items' attribute required by OpenAI.
+        
+        This ensures compatibility with OpenAI's function calling format which
+        requires array types to specify the type of items they contain.
+        
+        Args:
+            schema: The schema dictionary to fix
+            
+        Returns:
+            dict: The fixed schema
+        """
+        if not isinstance(schema, dict):
+            return schema
+            
+        # Create a copy to avoid modifying the original
+        fixed_schema = schema.copy()
+        
+        # Fix array types at the current level
+        if fixed_schema.get("type") == "array" and "items" not in fixed_schema:
+            # Add a default items schema for arrays without it
+            fixed_schema["items"] = {"type": "string"}
+            
+        # Recursively fix nested schemas
+        if "properties" in fixed_schema:
+            fixed_properties = {}
+            for prop_name, prop_schema in fixed_schema["properties"].items():
+                fixed_properties[prop_name] = self._fix_array_schemas(prop_schema)
+            fixed_schema["properties"] = fixed_properties
+            
+        # Fix items schema if it exists
+        if "items" in fixed_schema:
+            fixed_schema["items"] = self._fix_array_schemas(fixed_schema["items"])
+            
+        return fixed_schema
+    
     def to_openai_tool(self):
         """Convert the tool to OpenAI format."""
+        # Fix array schemas to include 'items' attribute
+        fixed_schema = self._fix_array_schemas(self.input_schema)
+        
         return {
             "type": "function",
             "function": {
                 "name": self.name,
                 "description": self.description,
-                "parameters": self.input_schema
+                "parameters": fixed_schema
             }
         }
 

src/praisonai-agents/praisonaiagents/memory/memory.py

@@ -6,6 +6,9 @@ import shutil
 from typing import Any, Dict, List, Optional, Union, Literal
 import logging
 
+# Disable litellm telemetry before any imports
+os.environ["LITELLM_TELEMETRY"] = "False"
+
 # Set up logger
 logger = logging.getLogger(__name__)
 
@@ -29,6 +32,13 @@ try:
 except ImportError:
     OPENAI_AVAILABLE = False
 
+try:
+    import litellm
+    litellm.telemetry = False  # Disable telemetry
+    LITELLM_AVAILABLE = True
+except ImportError:
+    LITELLM_AVAILABLE = False
+
 
 
 
@@ -340,14 +350,28 @@ class Memory:
             
         elif self.use_rag and hasattr(self, "chroma_col"):
             try:
-                from openai import OpenAI
-                client = OpenAI()
-                
-                response = client.embeddings.create(
-                    input=query,
-                    model="text-embedding-3-small"
-                )
-                query_embedding = response.data[0].embedding
+                if LITELLM_AVAILABLE:
+                    # Use LiteLLM for consistency with the rest of the codebase
+                    import litellm
+                    
+                    response = litellm.embedding(
+                        model="text-embedding-3-small",
+                        input=query
+                    )
+                    query_embedding = response.data[0]["embedding"]
+                elif OPENAI_AVAILABLE:
+                    # Fallback to OpenAI client
+                    from openai import OpenAI
+                    client = OpenAI()
+                    
+                    response = client.embeddings.create(
+                        input=query,
+                        model="text-embedding-3-small"
+                    )
+                    query_embedding = response.data[0].embedding
+                else:
+                    self._log_verbose("Neither litellm nor openai available for embeddings", logging.WARNING)
+                    return []
                 
                 resp = self.chroma_col.query(
                     query_embeddings=[query_embedding],
@@ -464,19 +488,39 @@ class Memory:
         # Store in vector database if enabled
         if self.use_rag and hasattr(self, "chroma_col"):
             try:
-                from openai import OpenAI
-                client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))  # Ensure API key is correctly set
-                
-                logger.info("Getting embeddings from OpenAI...")
-                logger.debug(f"Embedding input text: {text}")  # Log the input text
-                
-                response = client.embeddings.create(
-                    input=text,
-                    model="text-embedding-3-small"
-                )
-                embedding = response.data[0].embedding
-                logger.info("Successfully got embeddings")
-                logger.debug(f"Received embedding of length: {len(embedding)}")  # Log embedding details
+                if LITELLM_AVAILABLE:
+                    # Use LiteLLM for consistency with the rest of the codebase
+                    import litellm
+                    
+                    logger.info("Getting embeddings from LiteLLM...")
+                    logger.debug(f"Embedding input text: {text}")
+                    
+                    response = litellm.embedding(
+                        model="text-embedding-3-small",
+                        input=text
+                    )
+                    embedding = response.data[0]["embedding"]
+                    logger.info("Successfully got embeddings from LiteLLM")
+                    logger.debug(f"Received embedding of length: {len(embedding)}")
+                    
+                elif OPENAI_AVAILABLE:
+                    # Fallback to OpenAI client
+                    from openai import OpenAI
+                    client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
+                    
+                    logger.info("Getting embeddings from OpenAI...")
+                    logger.debug(f"Embedding input text: {text}")
+                    
+                    response = client.embeddings.create(
+                        input=text,
+                        model="text-embedding-3-small"
+                    )
+                    embedding = response.data[0].embedding
+                    logger.info("Successfully got embeddings from OpenAI")
+                    logger.debug(f"Received embedding of length: {len(embedding)}")
+                else:
+                    logger.warning("Neither litellm nor openai available for embeddings")
+                    return
                 
                 # Sanitize metadata for ChromaDB
                 sanitized_metadata = self._sanitize_metadata(metadata)
@@ -527,15 +571,28 @@ class Memory:
 
         elif self.use_rag and hasattr(self, "chroma_col"):
             try:
-                from openai import OpenAI
-                client = OpenAI()
-                
-                # Get query embedding
-                response = client.embeddings.create(
-                    input=query,
-                    model="text-embedding-3-small"  # Using consistent model
-                )
-                query_embedding = response.data[0].embedding
+                if LITELLM_AVAILABLE:
+                    # Use LiteLLM for consistency with the rest of the codebase
+                    import litellm
+                    
+                    response = litellm.embedding(
+                        model="text-embedding-3-small",
+                        input=query
+                    )
+                    query_embedding = response.data[0]["embedding"]
+                elif OPENAI_AVAILABLE:
+                    # Fallback to OpenAI client
+                    from openai import OpenAI
+                    client = OpenAI()
+                    
+                    response = client.embeddings.create(
+                        input=query,
+                        model="text-embedding-3-small"
+                    )
+                    query_embedding = response.data[0].embedding
+                else:
+                    self._log_verbose("Neither litellm nor openai available for embeddings", logging.WARNING)
+                    return []
                 
                 # Search ChromaDB with embedding
                 resp = self.chroma_col.query(
@@ -910,18 +967,44 @@ class Memory:
         """
 
         try:
-            # Use OpenAI client from main.py
-            from ..main import client
-            
-            response = client.chat.completions.create(
-                model=llm or "gpt-4o",
-                messages=[{
-                    "role": "user", 
-                    "content": custom_prompt or default_prompt
-                }],
-                response_format={"type": "json_object"},
-                temperature=0.3
-            )
+            if LITELLM_AVAILABLE:
+                # Use LiteLLM for consistency with the rest of the codebase
+                import litellm
+                
+                # Convert model name if it's in litellm format
+                model_name = llm or "gpt-4o-mini"
+                
+                response = litellm.completion(
+                    model=model_name,
+                    messages=[{
+                        "role": "user", 
+                        "content": custom_prompt or default_prompt
+                    }],
+                    response_format={"type": "json_object"},
+                    temperature=0.3
+                )
+            elif OPENAI_AVAILABLE:
+                # Fallback to OpenAI client
+                from openai import OpenAI
+                client = OpenAI()
+                
+                response = client.chat.completions.create(
+                    model=llm or "gpt-4o-mini",
+                    messages=[{
+                        "role": "user", 
+                        "content": custom_prompt or default_prompt
+                    }],
+                    response_format={"type": "json_object"},
+                    temperature=0.3
+                )
+            else:
+                logger.error("Neither litellm nor openai available for quality calculation")
+                return {
+                    "completeness": 0.0,
+                    "relevance": 0.0,
+                    "clarity": 0.0,
+                    "accuracy": 0.0
+                }
             
             metrics = json.loads(response.choices[0].message.content)
             

src/praisonai-agents/praisonaiagents/session.py

@@ -7,6 +7,9 @@ session API for developers building stateful agent applications.
 
 import os
 import uuid
+import requests
+import json
+import time
 from typing import Any, Dict, List, Optional
 from .agent import Agent
 from .memory import Memory
@@ -22,68 +25,90 @@ class Session:
     - Memory operations (short-term, long-term, user-specific)
     - Knowledge base operations
     - Agent state management
+    - Remote agent connectivity
     
-    Example:
+    Examples:
+        # Local session with agent
         session = Session(session_id="chat_123", user_id="user_456")
+        agent = session.Agent(name="Assistant", role="Helpful AI")
         
-        # Create stateful agent
-        agent = session.Agent(
-            name="Assistant", 
-            role="Helpful AI",
-            memory=True
-        )
+        # Remote agent session (similar to Google ADK)
+        session = Session(agent_url="192.168.1.10:8000/agent")
+        response = session.chat("Hello from remote client!")
         
         # Save session state
         session.save_state({"conversation_topic": "AI research"})
-        
-        # Restore state later
-        session.restore_state()
     """
 
     def __init__(
         self, 
         session_id: Optional[str] = None,
         user_id: Optional[str] = None,
+        agent_url: Optional[str] = None,
         memory_config: Optional[Dict[str, Any]] = None,
-        knowledge_config: Optional[Dict[str, Any]] = None
+        knowledge_config: Optional[Dict[str, Any]] = None,
+        timeout: int = 30
     ):
         """
-        Initialize a new session with optional persistence.
+        Initialize a new session with optional persistence or remote agent connectivity.
         
         Args:
             session_id: Unique session identifier. Auto-generated if None.
             user_id: User identifier for user-specific memory operations.
+            agent_url: URL of remote agent for direct connectivity (e.g., "192.168.1.10:8000/agent")
             memory_config: Configuration for memory system (defaults to RAG)
-            knowledge_config: Configuration for knowledge base system
+            knowledge_config: Configuration for knowledge base system  
+            timeout: HTTP timeout for remote agent calls (default: 30 seconds)
         """
         self.session_id = session_id or str(uuid.uuid4())[:8]
         self.user_id = user_id or "default_user"
+        self.agent_url = agent_url
+        self.timeout = timeout
+        self.is_remote = agent_url is not None
 
-        # Initialize memory with sensible defaults
-        default_memory_config = {
-            "provider": "rag",
-            "use_embedding": True,
-            "rag_db_path": f".praison/sessions/{self.session_id}/chroma_db"
-        }
-        if memory_config:
-            default_memory_config.update(memory_config)
-        self.memory_config = default_memory_config
+        # Validate agent_url format
+        if self.is_remote:
+            if not self.agent_url.startswith(('http://', 'https://')):
+                # Assume http if no protocol specified
+                self.agent_url = f"http://{self.agent_url}"
+            # Test connectivity to remote agent
+            self._test_remote_connection()
 
-        # Initialize knowledge with session-specific config
-        default_knowledge_config = knowledge_config or {}
-        self.knowledge_config = default_knowledge_config
+        # Initialize memory with sensible defaults (only for local sessions)
+        if not self.is_remote:
+            default_memory_config = {
+                "provider": "rag",
+                "use_embedding": True,
+                "rag_db_path": f".praison/sessions/{self.session_id}/chroma_db"
+            }
+            if memory_config:
+                default_memory_config.update(memory_config)
+            self.memory_config = default_memory_config
 
-        # Create session directory
-        os.makedirs(f".praison/sessions/{self.session_id}", exist_ok=True)
+            # Initialize knowledge with session-specific config
+            default_knowledge_config = knowledge_config or {}
+            self.knowledge_config = default_knowledge_config
 
-        # Initialize components lazily
-        self._memory = None
-        self._knowledge = None
-        self._agents_instance = None
+            # Create session directory
+            os.makedirs(f".praison/sessions/{self.session_id}", exist_ok=True)
+
+            # Initialize components lazily
+            self._memory = None
+            self._knowledge = None
+            self._agents_instance = None
+        else:
+            # For remote sessions, disable local memory/knowledge
+            self.memory_config = {}
+            self.knowledge_config = {}
+            self._memory = None
+            self._knowledge = None
+            self._agents_instance = None
 
     @property
     def memory(self) -> Memory:
         """Lazy-loaded memory instance"""
+        if self.is_remote:
+            raise ValueError("Memory operations are not available for remote agent sessions")
         if self._memory is None:
             self._memory = Memory(config=self.memory_config)
         return self._memory
@@ -91,6 +116,8 @@ class Session:
     @property
     def knowledge(self) -> Knowledge:
         """Lazy-loaded knowledge instance"""
+        if self.is_remote:
+            raise ValueError("Knowledge operations are not available for remote agent sessions")
         if self._knowledge is None:
             self._knowledge = Knowledge(config=self.knowledge_config)
         return self._knowledge
@@ -119,7 +146,13 @@ class Session:
         
         Returns:
             Configured Agent instance
+            
+        Raises:
+            ValueError: If this is a remote session (use chat() instead)
         """
+        if self.is_remote:
+            raise ValueError("Cannot create local agents in remote sessions. Use chat() to communicate with the remote agent.")
+
         agent_kwargs = {
             "name": name,
             "role": role,
@@ -150,7 +183,12 @@ class Session:
         
         Args:
             state_data: Dictionary of state data to save
+            
+        Raises:
+            ValueError: If this is a remote session
         """
+        if self.is_remote:
+            raise ValueError("State operations are not available for remote agent sessions")
         state_text = f"Session state: {state_data}"
         self.memory.store_short_term(
             text=state_text,
@@ -168,7 +206,12 @@ class Session:
         
         Returns:
             Dictionary of restored state data
+            
+        Raises:
+            ValueError: If this is a remote session
         """
+        if self.is_remote:
+            raise ValueError("State operations are not available for remote agent sessions")
         # Use metadata-based search for better SQLite compatibility
         results = self.memory.search_short_term(
             query=f"type:session_state",
@@ -284,7 +327,105 @@ class Session:
             max_items=max_items
         )
 
+    def _test_remote_connection(self) -> None:
+        """
+        Test connectivity to the remote agent.
+        
+        Raises:
+            ConnectionError: If unable to connect to the remote agent
+        """
+        try:
+            # Try a simple GET request to check if the server is responding
+            test_url = self.agent_url.rstrip('/') + '/health' if '/health' not in self.agent_url else self.agent_url
+            response = requests.get(test_url, timeout=self.timeout)
+            if response.status_code != 200:
+                # If health endpoint fails, try the main endpoint
+                response = requests.head(self.agent_url, timeout=self.timeout)
+                if response.status_code not in [200, 405]:  # 405 = Method Not Allowed is OK
+                    raise ConnectionError(f"Remote agent returned status code: {response.status_code}")
+            print(f"✅ Successfully connected to remote agent at {self.agent_url}")
+        except requests.exceptions.Timeout:
+            raise ConnectionError(f"Timeout connecting to remote agent at {self.agent_url}")
+        except requests.exceptions.ConnectionError:
+            raise ConnectionError(f"Failed to connect to remote agent at {self.agent_url}")
+        except Exception as e:
+            raise ConnectionError(f"Error connecting to remote agent: {str(e)}")
+
+    def chat(self, message: str, **kwargs) -> str:
+        """
+        Send a message to the remote agent or handle local session.
+        
+        Args:
+            message: The message to send to the agent
+            **kwargs: Additional parameters for the request
+            
+        Returns:
+            The agent's response
+            
+        Raises:
+            ValueError: If this is not a remote session
+            ConnectionError: If unable to communicate with remote agent
+        """
+        if not self.is_remote:
+            raise ValueError("chat() method is only available for remote agent sessions. Use Agent.chat() for local agents.")
+        
+        try:
+            # Prepare the request payload
+            payload = {
+                "query": message,
+                "session_id": self.session_id,
+                "user_id": self.user_id,
+                **kwargs
+            }
+            
+            # Send POST request to the remote agent
+            response = requests.post(
+                self.agent_url,
+                json=payload,
+                headers={"Content-Type": "application/json"},
+                timeout=self.timeout
+            )
+            
+            # Check if request was successful
+            response.raise_for_status()
+            
+            # Parse the response
+            result = response.json()
+            
+            # Extract the agent's response
+            if isinstance(result, dict):
+                return result.get("response", str(result))
+            else:
+                return str(result)
+                
+        except requests.exceptions.Timeout:
+            raise ConnectionError(f"Timeout communicating with remote agent at {self.agent_url}")
+        except requests.exceptions.ConnectionError:
+            raise ConnectionError(f"Failed to communicate with remote agent at {self.agent_url}")
+        except requests.exceptions.HTTPError as e:
+            raise ConnectionError(f"HTTP error from remote agent: {e}")
+        except json.JSONDecodeError:
+            # If response is not JSON, return the raw text
+            return response.text
+        except Exception as e:
+            raise ConnectionError(f"Error communicating with remote agent: {str(e)}")
+
+    def send_message(self, message: str, **kwargs) -> str:
+        """
+        Alias for chat() method to match Google ADK pattern.
+        
+        Args:
+            message: The message to send to the agent
+            **kwargs: Additional parameters for the request
+            
+        Returns:
+            The agent's response
+        """
+        return self.chat(message, **kwargs)
+
     def __str__(self) -> str:
+        if self.is_remote:
+            return f"Session(id='{self.session_id}', user='{self.user_id}', remote_agent='{self.agent_url}')"
         return f"Session(id='{self.session_id}', user='{self.user_id}')"
 
     def __repr__(self) -> str:

src/praisonai-agents/praisonaiagents/task/task.py

@@ -1,6 +1,7 @@
 import logging
 import asyncio
-from typing import List, Optional, Dict, Any, Type, Callable, Union, Coroutine, Literal
+import inspect
+from typing import List, Optional, Dict, Any, Type, Callable, Union, Coroutine, Literal, Tuple, get_args, get_origin
 from pydantic import BaseModel
 from ..main import TaskOutput
 from ..agent.agent import Agent
@@ -40,7 +41,10 @@ class Task:
         quality_check=True,
         input_file: Optional[str] = None,
         rerun: bool = False, # Renamed from can_rerun and logic inverted, default True for backward compatibility
-        retain_full_context: bool = False # By default, only use previous task output, not all previous tasks
+        retain_full_context: bool = False, # By default, only use previous task output, not all previous tasks
+        guardrail: Optional[Union[Callable[[TaskOutput], Tuple[bool, Any]], str]] = None,
+        max_retries: int = 3,
+        retry_count: int = 0
     ):
         # Add check if memory config is provided
         if memory is not None or (config and config.get('memory_config')):
@@ -80,6 +84,10 @@ class Task:
         self.quality_check = quality_check
         self.rerun = rerun # Assigning the rerun parameter
         self.retain_full_context = retain_full_context
+        self.guardrail = guardrail
+        self.max_retries = max_retries
+        self.retry_count = retry_count
+        self._guardrail_fn = None
 
         # Set logger level based on config verbose level
         verbose = self.config.get("verbose", 0)
@@ -141,6 +149,55 @@ class Task:
 
             self.output_pydantic = LoopModel
 
+        # Initialize guardrail
+        self._setup_guardrail()
+
+    def _setup_guardrail(self):
+        """Setup the guardrail function based on the provided guardrail parameter."""
+        if self.guardrail is None:
+            self._guardrail_fn = None
+            return
+            
+        if callable(self.guardrail):
+            # Validate function signature
+            sig = inspect.signature(self.guardrail)
+            positional_args = [
+                param for param in sig.parameters.values()
+                if param.default is inspect.Parameter.empty
+            ]
+            if len(positional_args) != 1:
+                raise ValueError("Guardrail function must accept exactly one parameter (TaskOutput)")
+            
+            # Check return annotation if present
+            return_annotation = sig.return_annotation
+            if return_annotation != inspect.Signature.empty:
+                return_annotation_args = get_args(return_annotation)
+                if not (
+                    get_origin(return_annotation) is tuple
+                    and len(return_annotation_args) == 2
+                    and return_annotation_args[0] is bool
+                    and (
+                        return_annotation_args[1] is Any
+                        or return_annotation_args[1] is str
+                        or return_annotation_args[1] is TaskOutput
+                        or return_annotation_args[1] == Union[str, TaskOutput]
+                    )
+                ):
+                    raise ValueError(
+                        "If return type is annotated, it must be Tuple[bool, Any]"
+                    )
+            
+            self._guardrail_fn = self.guardrail
+        elif isinstance(self.guardrail, str):
+            # Create LLM-based guardrail
+            from ..guardrails import LLMGuardrail
+            if not self.agent:
+                raise ValueError("Agent is required for string-based guardrails")
+            llm = getattr(self.agent, 'llm', None) or getattr(self.agent, 'llm_instance', None)
+            self._guardrail_fn = LLMGuardrail(description=self.guardrail, llm=llm)
+        else:
+            raise ValueError("Guardrail must be either a callable or a string description")
+
     def __str__(self):
         return f"Task(name='{self.name if self.name else 'None'}', description='{self.description}', agent='{self.agent.name if self.agent else 'None'}', status='{self.status}')"
 
@@ -187,6 +244,37 @@ class Task:
         logger.info(f"Task {self.id}: execute_callback called")
         logger.info(f"Quality check enabled: {self.quality_check}")
 
+        # Process guardrail if configured
+        if self._guardrail_fn:
+            try:
+                guardrail_result = self._process_guardrail(task_output)
+                if not guardrail_result.success:
+                    if self.retry_count >= self.max_retries:
+                        raise Exception(
+                            f"Task failed guardrail validation after {self.max_retries} retries. "
+                            f"Last error: {guardrail_result.error}"
+                        )
+                    
+                    self.retry_count += 1
+                    logger.warning(f"Task {self.id}: Guardrail validation failed (retry {self.retry_count}/{self.max_retries}): {guardrail_result.error}")
+                    # Note: In a real execution, this would trigger a retry, but since this is a callback
+                    # the retry logic would need to be handled at the agent/execution level
+                    return
+                
+                # If guardrail passed and returned a modified result
+                if guardrail_result.result is not None:
+                    if isinstance(guardrail_result.result, str):
+                        # Update the task output with the modified result
+                        task_output.raw = guardrail_result.result
+                    elif isinstance(guardrail_result.result, TaskOutput):
+                        # Replace with the new task output
+                        task_output = guardrail_result.result
+                
+                logger.info(f"Task {self.id}: Guardrail validation passed")
+            except Exception as e:
+                logger.error(f"Task {self.id}: Error in guardrail processing: {e}")
+                # Continue execution even if guardrail fails to avoid breaking the task
+
         # Initialize memory if not already initialized
         if not self.memory:
             self.memory = self.initialize_memory()
@@ -220,7 +308,11 @@ class Task:
                 if self.agent:
                     if getattr(self.agent, '_using_custom_llm', False) and hasattr(self.agent, 'llm_instance'):
                         # For custom LLM instances (like Ollama)
-                        llm_model = self.agent.llm_instance
+                        # Extract the model name from the LLM instance
+                        if hasattr(self.agent.llm_instance, 'model'):
+                            llm_model = self.agent.llm_instance.model
+                        else:
+                            llm_model = "gpt-4o-mini"  # Default fallback
                     elif hasattr(self.agent, 'llm') and self.agent.llm:
                         # For standard model strings
                         llm_model = self.agent.llm
@@ -334,4 +426,34 @@ Context:
                 loop.run_until_complete(self.execute_callback(task_output))
         except RuntimeError:
             # If no loop is running in this context
-            asyncio.run(self.execute_callback(task_output))
+            asyncio.run(self.execute_callback(task_output))
+
+    def _process_guardrail(self, task_output: TaskOutput):
+        """Process the guardrail validation for a task output.
+        
+        Args:
+            task_output: The task output to validate
+            
+        Returns:
+            GuardrailResult: The result of the guardrail validation
+        """
+        from ..guardrails import GuardrailResult
+        
+        if not self._guardrail_fn:
+            return GuardrailResult(success=True, result=task_output)
+        
+        try:
+            # Call the guardrail function
+            result = self._guardrail_fn(task_output)
+            
+            # Convert the result to a GuardrailResult
+            return GuardrailResult.from_tuple(result)
+            
+        except Exception as e:
+            logger.error(f"Task {self.id}: Error in guardrail validation: {e}")
+            # On error, return failure
+            return GuardrailResult(
+                success=False,
+                result=None,
+                error=f"Guardrail validation error: {str(e)}"
+            )

src/praisonai-agents/praisonaiagents/telemetry/README.md

@@ -0,0 +1,108 @@
+# PraisonAI Agents Telemetry
+
+This module provides minimal, privacy-focused telemetry for PraisonAI Agents.
+
+## Privacy Guarantees
+
+- **No personal data is collected** - No prompts, responses, or user content
+- **Anonymous metrics only** - Usage counts and feature adoption
+- **Opt-out by default** - Respects standard privacy preferences
+- **Transparent collection** - See exactly what's tracked below
+
+## What We Collect
+
+We collect only anonymous usage metrics:
+- Number of agent executions
+- Number of task completions  
+- Tool usage (names only, no arguments)
+- Error types (no error messages)
+- Framework version and OS type
+- Anonymous session ID (regenerated each run)
+
+## Disabling Telemetry
+
+Telemetry can be disabled in three ways:
+
+### 1. Environment Variables (Recommended)
+
+Set any of these environment variables:
+```bash
+export PRAISONAI_TELEMETRY_DISABLED=true
+export PRAISONAI_DISABLE_TELEMETRY=true
+export DO_NOT_TRACK=true  # Universal standard
+```
+
+### 2. Programmatically
+
+```python
+from praisonaiagents.telemetry import disable_telemetry
+disable_telemetry()
+```
+
+### 3. At Runtime
+
+```python
+from praisonaiagents.telemetry import get_telemetry
+telemetry = get_telemetry()
+telemetry.enabled = False
+```
+
+## Usage
+
+The telemetry module integrates automatically with PraisonAI Agents:
+
+```python
+from praisonaiagents import Agent, Task, PraisonAIAgents
+
+# Telemetry is automatically enabled (unless disabled by environment)
+agent = Agent(name="MyAgent", role="Assistant")
+task = Task(description="Help user", agent=agent)
+
+workflow = PraisonAIAgents(agents=[agent], tasks=[task])
+result = workflow.start()
+
+# Check telemetry metrics
+from praisonaiagents.telemetry import get_telemetry
+telemetry = get_telemetry()
+print(telemetry.get_metrics())
+```
+
+## Implementation Details
+
+The telemetry implementation is minimal and lightweight:
+- No external dependencies required
+- No network calls in current implementation
+- Metrics stored in memory only
+- Future versions may send to PostHog or similar privacy-focused services
+
+## Backward Compatibility
+
+The module maintains compatibility with the previous telemetry interface:
+
+```python
+from praisonaiagents.telemetry import TelemetryCollector
+
+collector = TelemetryCollector()
+collector.start()
+
+with collector.trace_agent_execution("MyAgent"):
+    # Agent execution code
+    pass
+
+collector.stop()
+```
+
+## Contributing
+
+When contributing to telemetry:
+1. Never collect personal data or user content
+2. Always make new metrics opt-out
+3. Document what's collected
+4. Keep the implementation minimal
+
+## Future Plans
+
+- Integration with PostHog for anonymous analytics
+- Aggregate usage statistics dashboard
+- Opt-in detailed performance metrics
+- Self-hosted telemetry endpoint option

src/praisonai-agents/praisonaiagents/telemetry/__init__.py

@@ -0,0 +1,102 @@
+"""
+PraisonAI Agents Minimal Telemetry Module
+
+This module provides anonymous usage tracking with privacy-first design.
+Telemetry is opt-out and can be disabled via environment variables:
+- PRAISONAI_TELEMETRY_DISABLED=true
+- PRAISONAI_DISABLE_TELEMETRY=true  
+- DO_NOT_TRACK=true
+
+No personal data, prompts, or responses are collected.
+"""
+
+import os
+import atexit
+from typing import Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .telemetry import MinimalTelemetry, TelemetryCollector
+
+# Import the classes for real (not just type checking)
+from .telemetry import MinimalTelemetry, TelemetryCollector
+
+__all__ = [
+    'get_telemetry',
+    'enable_telemetry',
+    'disable_telemetry',
+    'MinimalTelemetry',
+    'TelemetryCollector',  # For backward compatibility
+]
+
+
+def get_telemetry() -> 'MinimalTelemetry':
+    """Get the global telemetry instance."""
+    from .telemetry import get_telemetry as _get_telemetry
+    return _get_telemetry()
+
+
+def enable_telemetry():
+    """Enable telemetry (if not disabled by environment)."""
+    from .telemetry import enable_telemetry as _enable_telemetry
+    _enable_telemetry()
+
+
+def disable_telemetry():
+    """Disable telemetry."""
+    from .telemetry import disable_telemetry as _disable_telemetry
+    _disable_telemetry()
+
+
+# Auto-instrumentation and cleanup setup
+_initialized = False
+_atexit_registered = False
+
+def _ensure_atexit():
+    """Ensure atexit handler is registered."""
+    global _atexit_registered
+    if _atexit_registered:
+        return
+    
+    # Check if telemetry should be disabled
+    telemetry_disabled = any([
+        os.environ.get('PRAISONAI_TELEMETRY_DISABLED', '').lower() in ('true', '1', 'yes'),
+        os.environ.get('PRAISONAI_DISABLE_TELEMETRY', '').lower() in ('true', '1', 'yes'),
+        os.environ.get('DO_NOT_TRACK', '').lower() in ('true', '1', 'yes'),
+    ])
+    
+    if not telemetry_disabled:
+        # Register atexit handler to flush telemetry on exit
+        atexit.register(lambda: get_telemetry().flush())
+        _atexit_registered = True
+
+def _initialize_telemetry():
+    """Initialize telemetry with auto-instrumentation and cleanup."""
+    global _initialized
+    if _initialized:
+        return
+    
+    # Ensure atexit is registered
+    _ensure_atexit()
+    
+    # Check if telemetry should be disabled
+    telemetry_disabled = any([
+        os.environ.get('PRAISONAI_TELEMETRY_DISABLED', '').lower() in ('true', '1', 'yes'),
+        os.environ.get('PRAISONAI_DISABLE_TELEMETRY', '').lower() in ('true', '1', 'yes'),
+        os.environ.get('DO_NOT_TRACK', '').lower() in ('true', '1', 'yes'),
+    ])
+    
+    if not telemetry_disabled:
+        try:
+            # Defer the actual instrumentation to avoid circular imports
+            # This will be called when get_telemetry() is first accessed
+            _initialized = True
+        except Exception:
+            # Silently fail if there are any issues
+            pass
+
+
+# No need for lazy auto-instrumentation here since main __init__.py handles it
+
+
+# Initialize atexit handler early
+_ensure_atexit()

src/praisonai-agents/praisonaiagents/telemetry/integration.py

@@ -0,0 +1,242 @@
+"""
+Simplified integration module for adding telemetry to core PraisonAI components.
+"""
+
+from typing import Any, Optional, TYPE_CHECKING
+from functools import wraps
+import time
+
+if TYPE_CHECKING:
+    from .telemetry import MinimalTelemetry
+    from ..agent.agent import Agent
+    from ..task.task import Task
+    from ..agents.agents import PraisonAIAgents
+
+
+def instrument_agent(agent: 'Agent', telemetry: Optional['MinimalTelemetry'] = None):
+    """
+    Instrument an Agent instance with minimal telemetry.
+    
+    Args:
+        agent: The Agent instance to instrument
+        telemetry: Optional telemetry instance (uses global if not provided)
+    """
+    if not telemetry:
+        from .telemetry import get_telemetry
+        telemetry = get_telemetry()
+    
+    if not telemetry.enabled:
+        return agent
+    
+    # Check if agent is already instrumented to avoid double-counting
+    if hasattr(agent, '_telemetry_instrumented'):
+        return agent
+    
+    # Store original methods
+    original_chat = agent.chat if hasattr(agent, 'chat') else None
+    original_start = agent.start if hasattr(agent, 'start') else None
+    original_run = agent.run if hasattr(agent, 'run') else None
+    original_execute_tool = agent.execute_tool if hasattr(agent, 'execute_tool') else None
+    
+    # Wrap chat method if it exists (this is the main method called by workflow)
+    if original_chat:
+        @wraps(original_chat)
+        def instrumented_chat(*args, **kwargs):
+            try:
+                result = original_chat(*args, **kwargs)
+                telemetry.track_agent_execution(agent.name, success=True)
+                return result
+            except Exception as e:
+                telemetry.track_agent_execution(agent.name, success=False)
+                telemetry.track_error(type(e).__name__)
+                raise
+        
+        agent.chat = instrumented_chat
+    
+    # Wrap start method if it exists
+    if original_start:
+        @wraps(original_start)
+        def instrumented_start(*args, **kwargs):
+            try:
+                result = original_start(*args, **kwargs)
+                telemetry.track_agent_execution(agent.name, success=True)
+                return result
+            except Exception as e:
+                telemetry.track_agent_execution(agent.name, success=False)
+                telemetry.track_error(type(e).__name__)
+                raise
+        
+        agent.start = instrumented_start
+    
+    # Wrap run method if it exists
+    if original_run:
+        @wraps(original_run)
+        def instrumented_run(*args, **kwargs):
+            try:
+                result = original_run(*args, **kwargs)
+                telemetry.track_agent_execution(agent.name, success=True)
+                return result
+            except Exception as e:
+                telemetry.track_agent_execution(agent.name, success=False)
+                telemetry.track_error(type(e).__name__)
+                raise
+        
+        agent.run = instrumented_run
+    
+    # Wrap execute_tool method
+    if original_execute_tool:
+        @wraps(original_execute_tool)
+        def instrumented_execute_tool(tool_name: str, *args, **kwargs):
+            try:
+                result = original_execute_tool(tool_name, *args, **kwargs)
+                telemetry.track_tool_usage(tool_name, success=True)
+                return result
+            except Exception as e:
+                telemetry.track_tool_usage(tool_name, success=False)
+                telemetry.track_error(type(e).__name__)
+                raise
+        
+        agent.execute_tool = instrumented_execute_tool
+    
+    # Mark agent as instrumented to avoid double instrumentation
+    agent._telemetry_instrumented = True
+    
+    return agent
+
+
+def instrument_workflow(workflow: 'PraisonAIAgents', telemetry: Optional['MinimalTelemetry'] = None):
+    """
+    Instrument a PraisonAIAgents workflow with minimal telemetry.
+    
+    Args:
+        workflow: The PraisonAIAgents instance to instrument
+        telemetry: Optional telemetry instance (uses global if not provided)
+    """
+    if not telemetry:
+        from .telemetry import get_telemetry
+        telemetry = get_telemetry()
+    
+    if not telemetry.enabled:
+        return workflow
+    
+    # Check if workflow is already instrumented to avoid double-counting
+    if hasattr(workflow, '_telemetry_instrumented'):
+        return workflow
+    
+    # Track feature usage
+    telemetry.track_feature_usage(f"workflow_{workflow.process}" if hasattr(workflow, 'process') else "workflow")
+    
+    # Instrument all agents in the workflow
+    if hasattr(workflow, 'agents') and workflow.agents:
+        for agent in workflow.agents:
+            instrument_agent(agent, telemetry)
+    
+    # Wrap the execute_task method to track task completions
+    if hasattr(workflow, 'execute_task'):
+        original_execute_task = workflow.execute_task
+        
+        @wraps(original_execute_task)
+        def instrumented_execute_task(task_id, *args, **kwargs):
+            task = None
+            try:
+                # Get task info
+                if hasattr(workflow, 'tasks') and task_id < len(workflow.tasks):
+                    task = workflow.tasks[task_id]
+                
+                result = original_execute_task(task_id, *args, **kwargs)
+                
+                # Track task completion
+                task_name = task.name if task and hasattr(task, 'name') else f"task_{task_id}"
+                telemetry.track_task_completion(task_name, success=True)
+                
+                return result
+            except Exception as e:
+                telemetry.track_error(type(e).__name__)
+                if task:
+                    task_name = task.name if hasattr(task, 'name') else f"task_{task_id}"
+                    telemetry.track_task_completion(task_name, success=False)
+                raise
+        
+        workflow.execute_task = instrumented_execute_task
+    
+    # Wrap the start method
+    original_start = workflow.start
+    
+    @wraps(original_start)
+    def instrumented_start(*args, **kwargs):
+        try:
+            result = original_start(*args, **kwargs)
+            # Don't double-track here since agent.chat already tracks execution
+            return result
+        except Exception as e:
+            telemetry.track_error(type(e).__name__)
+            raise
+    
+    workflow.start = instrumented_start
+    
+    # Also wrap astart if it exists (async version)
+    if hasattr(workflow, 'astart'):
+        original_astart = workflow.astart
+        
+        @wraps(original_astart)
+        async def instrumented_astart(*args, **kwargs):
+            try:
+                result = await original_astart(*args, **kwargs)
+                # Don't double-track here since agent.chat already tracks execution
+                return result
+            except Exception as e:
+                telemetry.track_error(type(e).__name__)
+                raise
+        
+        workflow.astart = instrumented_astart
+    
+    # Mark workflow as instrumented to avoid double instrumentation
+    workflow._telemetry_instrumented = True
+    
+    return workflow
+
+
+# Auto-instrumentation helper
+def auto_instrument_all(telemetry: Optional['MinimalTelemetry'] = None):
+    """
+    Automatically instrument all new instances of Agent and PraisonAIAgents.
+    This should be called after enabling telemetry.
+    
+    Args:
+        telemetry: Optional telemetry instance (uses global if not provided)
+    """
+    if not telemetry:
+        from .telemetry import get_telemetry
+        telemetry = get_telemetry()
+    
+    if not telemetry.enabled:
+        return
+    
+    try:
+        # Import the classes
+        from ..agent.agent import Agent
+        from ..agents.agents import PraisonAIAgents
+        
+        # Store original __init__ methods
+        original_agent_init = Agent.__init__
+        original_workflow_init = PraisonAIAgents.__init__
+        
+        # Wrap Agent.__init__
+        @wraps(original_agent_init)
+        def agent_init_wrapper(self, *args, **kwargs):
+            original_agent_init(self, *args, **kwargs)
+            instrument_agent(self, telemetry)
+        
+        # Wrap PraisonAIAgents.__init__
+        @wraps(original_workflow_init)
+        def workflow_init_wrapper(self, *args, **kwargs):
+            original_workflow_init(self, *args, **kwargs)
+            instrument_workflow(self, telemetry)
+        
+        # Apply wrapped constructors
+        Agent.__init__ = agent_init_wrapper
+        PraisonAIAgents.__init__ = workflow_init_wrapper
+        
+    except ImportError:
+        # Classes not available, skip auto-instrumentation
+        pass

src/praisonai-agents/praisonaiagents/telemetry/telemetry.py

@@ -0,0 +1,372 @@
+"""
+Minimal telemetry implementation for PraisonAI Agents.
+
+This module provides anonymous usage tracking with privacy-first design.
+All telemetry is opt-out via environment variables.
+"""
+
+import os
+import time
+import platform
+import hashlib
+from typing import Dict, Any, Optional
+from datetime import datetime
+import logging
+
+# Try to import PostHog
+try:
+    from posthog import Posthog
+    POSTHOG_AVAILABLE = True
+except ImportError:
+    POSTHOG_AVAILABLE = False
+
+# Check for opt-out environment variables
+_TELEMETRY_DISABLED = any([
+    os.environ.get('PRAISONAI_TELEMETRY_DISABLED', '').lower() in ('true', '1', 'yes'),
+    os.environ.get('PRAISONAI_DISABLE_TELEMETRY', '').lower() in ('true', '1', 'yes'),
+    os.environ.get('DO_NOT_TRACK', '').lower() in ('true', '1', 'yes'),
+])
+
+
+class MinimalTelemetry:
+    """
+    Minimal telemetry collector for anonymous usage tracking.
+    
+    Privacy guarantees:
+    - No personal data is collected
+    - No prompts, responses, or user content is tracked
+    - Only anonymous metrics about feature usage
+    - Respects DO_NOT_TRACK standard
+    - Can be disabled via environment variables
+    """
+    
+    def __init__(self, enabled: bool = None):
+        """
+        Initialize the minimal telemetry collector.
+        
+        Args:
+            enabled: Override the environment-based enable/disable setting
+        """
+        # Respect explicit enabled parameter, otherwise check environment
+        if enabled is not None:
+            self.enabled = enabled
+        else:
+            self.enabled = not _TELEMETRY_DISABLED
+            
+        self.logger = logging.getLogger(__name__)
+        
+        if not self.enabled:
+            self.logger.debug("Telemetry is disabled")
+            return
+            
+        # Generate anonymous session ID (not user ID)
+        session_data = f"{datetime.now().isoformat()}-{os.getpid()}-{time.time()}"
+        self.session_id = hashlib.sha256(session_data.encode()).hexdigest()[:16]
+        
+        # Basic metrics storage
+        self._metrics = {
+            "agent_executions": 0,
+            "task_completions": 0,
+            "tool_calls": 0,
+            "errors": 0,
+        }
+        
+        # Collect basic environment info (anonymous)
+        self._environment = {
+            "python_version": platform.python_version(),
+            "os_type": platform.system(),
+            "framework_version": self._get_framework_version(),
+        }
+        
+        self.logger.debug(f"Telemetry enabled with session {self.session_id}")
+        
+        # Initialize PostHog if available
+        if POSTHOG_AVAILABLE:
+            try:
+                self._posthog = Posthog(
+                    project_api_key='phc_skZpl3eFLQJ4iYjsERNMbCO6jfeSJi2vyZlPahKgxZ7',
+                    host='https://eu.i.posthog.com',
+                    disable_geoip=True,
+                    on_error=lambda e: self.logger.debug(f"PostHog error: {e}"),
+                    sync_mode=False  # Use async mode to prevent blocking
+                )
+            except:
+                self._posthog = None
+        else:
+            self._posthog = None
+    
+    def _get_framework_version(self) -> str:
+        """Get the PraisonAI Agents version."""
+        try:
+            from .. import __version__
+            return __version__
+        except ImportError:
+            return "unknown"
+    
+    def track_agent_execution(self, agent_name: str = None, success: bool = True):
+        """
+        Track an agent execution event.
+        
+        Args:
+            agent_name: Name of the agent (not logged, just for counting)
+            success: Whether the execution was successful
+        """
+        if not self.enabled:
+            return
+            
+        self._metrics["agent_executions"] += 1
+        
+        # In a real implementation, this would send to a backend
+        # For now, just log at debug level
+        self.logger.debug(f"Agent execution tracked: success={success}")
+    
+    def track_task_completion(self, task_name: str = None, success: bool = True):
+        """
+        Track a task completion event.
+        
+        Args:
+            task_name: Name of the task (not logged, just for counting)
+            success: Whether the task completed successfully
+        """
+        if not self.enabled:
+            return
+            
+        self._metrics["task_completions"] += 1
+        
+        self.logger.debug(f"Task completion tracked: success={success}")
+    
+    def track_tool_usage(self, tool_name: str, success: bool = True):
+        """
+        Track tool usage event.
+        
+        Args:
+            tool_name: Name of the tool being used
+            success: Whether the tool call was successful
+        """
+        if not self.enabled:
+            return
+            
+        self._metrics["tool_calls"] += 1
+        
+        # Only track tool name, not arguments or results
+        self.logger.debug(f"Tool usage tracked: {tool_name}, success={success}")
+    
+    def track_error(self, error_type: str = None):
+        """
+        Track an error event.
+        
+        Args:
+            error_type: Type of error (not the full message)
+        """
+        if not self.enabled:
+            return
+            
+        self._metrics["errors"] += 1
+        
+        # Only track error type, not full error messages
+        self.logger.debug(f"Error tracked: type={error_type or 'unknown'}")
+    
+    def track_feature_usage(self, feature_name: str):
+        """
+        Track usage of a specific feature.
+        
+        Args:
+            feature_name: Name of the feature being used
+        """
+        if not self.enabled:
+            return
+            
+        # Track which features are being used
+        self.logger.debug(f"Feature usage tracked: {feature_name}")
+    
+    def get_metrics(self) -> Dict[str, Any]:
+        """
+        Get current metrics summary.
+        
+        Returns:
+            Dictionary of current metrics
+        """
+        if not self.enabled:
+            return {"enabled": False}
+            
+        return {
+            "enabled": True,
+            "session_id": self.session_id,
+            "metrics": self._metrics.copy(),
+            "environment": self._environment.copy(),
+        }
+    
+    def flush(self):
+        """
+        Flush any pending telemetry data.
+        
+        In a real implementation, this would send data to a backend.
+        """
+        if not self.enabled:
+            return
+            
+        metrics = self.get_metrics()
+        self.logger.debug(f"Telemetry flush: {metrics}")
+        
+        # Send to PostHog if available
+        if hasattr(self, '_posthog') and self._posthog:
+            
+            try:
+                self._posthog.capture(
+                    distinct_id='anonymous',
+                    event='sdk_used',
+                    properties={
+                        'version': self._environment['framework_version'],
+                        'os': platform.system(),
+                        '$process_person_profile': False,
+                        '$geoip_disable': True
+                    }
+                )
+                # Don't flush here - let PostHog handle it asynchronously
+            except:
+                pass
+        
+        # Reset counters
+        for key in self._metrics:
+            if isinstance(self._metrics[key], int):
+                self._metrics[key] = 0
+    
+    def shutdown(self):
+        """
+        Shutdown telemetry and ensure all events are sent.
+        """
+        if not self.enabled:
+            return
+            
+        # Final flush
+        self.flush()
+        
+        # Shutdown PostHog if available
+        if hasattr(self, '_posthog') and self._posthog:
+            try:
+                # Force a synchronous flush before shutdown
+                self._posthog.flush()
+                self._posthog.shutdown()
+            except:
+                pass
+
+
+# Global telemetry instance
+_telemetry_instance = None
+
+
+def get_telemetry() -> MinimalTelemetry:
+    """
+    Get the global telemetry instance.
+    
+    Returns:
+        The global MinimalTelemetry instance
+    """
+    global _telemetry_instance
+    if _telemetry_instance is None:
+        _telemetry_instance = MinimalTelemetry()
+    return _telemetry_instance
+
+
+def disable_telemetry():
+    """Programmatically disable telemetry."""
+    global _telemetry_instance
+    if _telemetry_instance:
+        _telemetry_instance.enabled = False
+    else:
+        _telemetry_instance = MinimalTelemetry(enabled=False)
+
+
+def enable_telemetry():
+    """Programmatically enable telemetry (if not disabled by environment)."""
+    global _telemetry_instance
+    if not _TELEMETRY_DISABLED:
+        if _telemetry_instance:
+            _telemetry_instance.enabled = True
+        else:
+            _telemetry_instance = MinimalTelemetry(enabled=True)
+
+
+# For backward compatibility with existing code
+class TelemetryCollector:
+    """Backward compatibility wrapper for the old TelemetryCollector interface."""
+    
+    def __init__(self, backend: str = "minimal", service_name: str = "praisonai-agents", **kwargs):
+        self.telemetry = get_telemetry()
+        
+    def start(self):
+        """Start telemetry collection."""
+        # No-op for minimal implementation
+        pass
+        
+    def stop(self):
+        """Stop telemetry collection and flush data."""
+        self.telemetry.flush()
+    
+    def trace_agent_execution(self, agent_name: str, **attributes):
+        """Compatibility method for agent execution tracking."""
+        from contextlib import contextmanager
+        
+        @contextmanager
+        def _trace():
+            try:
+                yield None
+                self.telemetry.track_agent_execution(agent_name, success=True)
+            except Exception:
+                self.telemetry.track_agent_execution(agent_name, success=False)
+                raise
+                
+        return _trace()
+    
+    def trace_task_execution(self, task_name: str, agent_name: str = None, **attributes):
+        """Compatibility method for task execution tracking."""
+        from contextlib import contextmanager
+        
+        @contextmanager
+        def _trace():
+            try:
+                yield None
+                self.telemetry.track_task_completion(task_name, success=True)
+            except Exception:
+                self.telemetry.track_task_completion(task_name, success=False)
+                raise
+                
+        return _trace()
+    
+    def trace_tool_call(self, tool_name: str, **attributes):
+        """Compatibility method for tool call tracking."""
+        from contextlib import contextmanager
+        
+        @contextmanager
+        def _trace():
+            try:
+                yield None
+                self.telemetry.track_tool_usage(tool_name, success=True)
+            except Exception:
+                self.telemetry.track_tool_usage(tool_name, success=False)
+                raise
+                
+        return _trace()
+    
+    def trace_llm_call(self, model: str = None, **attributes):
+        """Compatibility method for LLM call tracking."""
+        from contextlib import contextmanager
+        
+        @contextmanager
+        def _trace():
+            # We don't track LLM calls in minimal telemetry
+            yield None
+            
+        return _trace()
+    
+    def record_tokens(self, prompt_tokens: int, completion_tokens: int, model: str = None):
+        """Compatibility method - we don't track token usage."""
+        pass
+        
+    def record_cost(self, cost: float, model: str = None):
+        """Compatibility method - we don't track costs."""
+        pass
+        
+    def get_metrics(self) -> Dict[str, Any]:
+        """Get current metrics."""
+        return self.telemetry.get_metrics()

src/praisonai-agents/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "praisonaiagents"
-version = "0.0.97"
+version = "0.0.109"
 description = "Praison AI agents for completing complex tasks with Self Reflection Agents"
 requires-python = ">=3.10"
 authors = [
@@ -14,7 +14,8 @@ dependencies = [
     "pydantic",
     "rich",
     "openai",
-    "mcp>=1.6.0"
+    "mcp>=1.6.0",
+    "posthog>=3.0.0"
 ]
 
 [project.optional-dependencies]
@@ -25,7 +26,8 @@ mcp = [
 ]
 
 memory = [
-    "chromadb>=1.0.0"
+    "chromadb>=1.0.0",
+    "litellm>=1.72.0",
 ]
 
 knowledge = [
@@ -43,7 +45,7 @@ graph = [
 
 # Add LLM dependencies
 llm = [
-    "litellm>=1.50.0",
+    "litellm>=1.72.0",
     "pydantic>=2.4.2"
 ]
 
@@ -53,6 +55,11 @@ api = [
     "uvicorn>=0.34.0"
 ]
 
+# Telemetry dependencies
+telemetry = [
+    "posthog>=3.0.0"
+]
+
 # Combined features
 all = [
     "praisonaiagents[memory]",
@@ -60,8 +67,10 @@ all = [
     "praisonaiagents[graph]",
     "praisonaiagents[llm]",
     "praisonaiagents[mcp]",
-    "praisonaiagents[api]"
+    "praisonaiagents[api]",
+    "praisonaiagents[telemetry]"
 ]
 
-[tool.setuptools]
-packages = ["praisonaiagents"]
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["praisonaiagents*"]

src/praisonai-agents/requirements.txt

@@ -2,6 +2,7 @@
 pydantic
 rich
 openai>=1.30.0
+posthog>=3.0.0
 
 # Memory dependencies
 chromadb>=0.5.23

src/praisonai-agents/sequence.py

@@ -0,0 +1,11 @@
+from praisonaiagents import Agent, MCP
+import os
+
+sequential_agent = Agent(
+    instructions="""You are a helpful assistant that can break down complex problems.
+    Use the available tools when relevant to perform step-by-step analysis.""",
+    llm="gpt-4o-mini",
+    tools=MCP("npx -y @modelcontextprotocol/server-sequential-thinking")
+)
+
+sequential_agent.start("Break down the process of making a cup of tea")

src/praisonai-agents/sequence_llm.py

@@ -0,0 +1,11 @@
+from praisonaiagents import Agent, MCP
+import os
+
+sequential_agent = Agent(
+    instructions="""You are a helpful assistant that can break down complex problems.
+    Use the available tools when relevant to perform step-by-step analysis.""",
+    llm="openai/gpt-4o-mini",
+    tools=MCP("npx -y @modelcontextprotocol/server-sequential-thinking")
+)
+
+sequential_agent.start("Break down the process of making a cup of tea")

src/praisonai-agents/simple_guardrail_test.py

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+"""
+Simple test for guardrails functionality without full dependencies.
+"""
+
+import sys
+import os
+from typing import Tuple, Any
+
+# Import only what we need for testing
+from praisonaiagents.guardrails import GuardrailResult, LLMGuardrail
+from praisonaiagents.main import TaskOutput
+
+
+def test_guardrail_result():
+    """Test GuardrailResult helper methods."""
+    print("Testing GuardrailResult...")
+    
+    # Test success case
+    success_result = GuardrailResult.from_tuple((True, "Modified output"))
+    assert success_result.success
+    assert success_result.result == "Modified output"
+    assert success_result.error == ""
+    print("✓ Success result created correctly")
+    
+    # Test failure case
+    failure_result = GuardrailResult.from_tuple((False, "Validation failed"))
+    assert not failure_result.success
+    assert failure_result.result is None
+    assert failure_result.error == "Validation failed"
+    print("✓ Failure result created correctly")
+    
+    print("GuardrailResult test passed!\n")
+
+
+def test_function_guardrail():
+    """Test function-based guardrail logic."""
+    print("Testing function-based guardrail logic...")
+    
+    def validate_output(task_output: TaskOutput) -> Tuple[bool, Any]:
+        """Simple validation function."""
+        if "error" in task_output.raw.lower():
+            return False, "Output contains errors"
+        if len(task_output.raw) < 10:
+            return False, "Output is too short"
+        return True, task_output
+    
+    # Test with good output
+    good_output = TaskOutput(
+        description="Test task",
+        raw="Hello! This is a friendly greeting message from the agent.",
+        agent="Test Agent"
+    )
+    
+    result = validate_output(good_output)
+    guardrail_result = GuardrailResult.from_tuple(result)
+    assert guardrail_result.success, f"Good output should pass: {guardrail_result.error}"
+    print("✓ Good output passed function guardrail")
+    
+    # Test with bad output
+    bad_output = TaskOutput(
+        description="Test task", 
+        raw="Error occurred",
+        agent="Test Agent"
+    )
+    
+    result = validate_output(bad_output)
+    guardrail_result = GuardrailResult.from_tuple(result)
+    assert not guardrail_result.success, "Bad output should fail guardrail"
+    print("✓ Bad output failed function guardrail as expected")
+    
+    print("Function-based guardrail logic test passed!\n")
+
+
+def test_llm_guardrail():
+    """Test LLM guardrail logic."""
+    print("Testing LLM guardrail logic...")
+    
+    # Mock LLM for testing that correctly parses the validation prompt
+    class MockLLM:
+        def chat(self, prompt, **kwargs):
+            # Extract the actual output to validate from the prompt
+            # The LLMGuardrail sends a structured prompt with "Output to Validate:" section
+            if "Output to Validate:" in prompt:
+                # Split by "Output to Validate:" and get the content after it
+                parts = prompt.split("Output to Validate:")
+                if len(parts) > 1:
+                    output_content = parts[1].strip()
+                    # Check only the output content, not the validation criteria
+                    if "error" in output_content.lower():
+                        return "FAIL: The output contains error messages"
+                    return "PASS"
+            
+            # Fallback: if no "Output to Validate:" section, return pass
+            return "PASS"
+    
+    # Create LLM guardrail
+    mock_llm = MockLLM()
+    llm_guardrail = LLMGuardrail(
+        description="Check if the output is professional and does not contain errors",
+        llm=mock_llm
+    )
+    
+    # Test with good output
+    good_output = TaskOutput(
+        description="Test task",
+        raw="Hello! This is a professional greeting message.",
+        agent="Test Agent"
+    )
+    
+    result = llm_guardrail(good_output)
+    guardrail_result = GuardrailResult.from_tuple(result)
+    assert guardrail_result.success, f"Good output should pass: {guardrail_result.error}"
+    print("✓ Good output passed LLM guardrail")
+    
+    # Test with bad output  
+    bad_output = TaskOutput(
+        description="Test task",
+        raw="There was an error in the system",
+        agent="Test Agent"
+    )
+    
+    result = llm_guardrail(bad_output)
+    guardrail_result = GuardrailResult.from_tuple(result)
+    assert not guardrail_result.success, "Bad output should fail LLM guardrail"
+    print("✓ Bad output failed LLM guardrail as expected")
+    
+    print("LLM guardrail logic test passed!\n")
+
+
+def main():
+    """Run all tests."""
+    print("Running Simple Guardrails Tests...\n")
+    
+    try:
+        test_guardrail_result()
+        test_function_guardrail()
+        test_llm_guardrail()
+        
+        print("🎉 All simple guardrail tests passed!")
+        print("\nGuardrails core logic is working correctly!")
+        
+    except Exception as e:
+        print(f"❌ Test failed: {e}")
+        import traceback
+        traceback.print_exc()
+        return False
+    
+    return True
+
+
+if __name__ == "__main__":
+    success = main()
+    sys.exit(0 if success else 1)

src/praisonai-agents/telemetry_analysis.md

@@ -0,0 +1,123 @@
+# Telemetry Analysis: Why PostHog Events Aren't Being Sent by Default
+
+## Executive Summary
+
+The telemetry system is implemented but **not actively integrated** into the PraisonAI Agents codebase. While PostHog is properly configured and functional, telemetry data is never sent because:
+
+1. **No automatic integration**: Agent and PraisonAIAgents classes don't use telemetry
+2. **No automatic flush**: Events are collected but never sent to PostHog
+3. **No lifecycle hooks**: No atexit handler or periodic flush mechanism
+
+## Current State
+
+### What's Working ✓
+- PostHog client is properly initialized with API key and host
+- Telemetry can be enabled/disabled via environment variables
+- Privacy-first design with anonymous tracking
+- Manual telemetry tracking and flushing works correctly
+
+### What's Not Working ✗
+- Agent class doesn't integrate telemetry
+- PraisonAIAgents class doesn't integrate telemetry
+- No automatic flush() calls anywhere in the codebase
+- Integration module (integration.py) is not used
+
+## Technical Analysis
+
+### 1. PostHog Configuration (telemetry.py)
+```python
+# Lines 84-93: PostHog is initialized correctly
+if POSTHOG_AVAILABLE:
+    try:
+        self._posthog = Posthog(
+            project_api_key='phc_skZpl3eFLQJ4iYjsERNMbCO6jfeSJi2vyZlPahKgxZ7',
+            host='https://eu.i.posthog.com'
+        )
+    except:
+        self._posthog = None
+```
+
+### 2. Flush Implementation (telemetry.py)
+```python
+# Lines 208-224: flush() sends events but is never called automatically
+def flush(self):
+    if hasattr(self, '_posthog') and self._posthog:
+        try:
+            self._posthog.capture(
+                distinct_id='anonymous',
+                event='sdk_used',
+                properties={...}
+            )
+            self._posthog.capture('test-id', 'test-event')
+        except:
+            pass
+```
+
+### 3. Missing Integration Points
+
+#### Agent Class (agent/agent.py)
+- No telemetry imports
+- No telemetry initialization in __init__
+- No telemetry tracking in start(), run(), or execute_tool()
+
+#### PraisonAIAgents Class (agents/agents.py)
+- No telemetry imports
+- No telemetry initialization
+- No telemetry tracking in start() or workflow execution
+
+## Root Causes
+
+1. **Incomplete Implementation**: The telemetry system was built but never integrated into the main classes
+2. **No Automatic Lifecycle Management**: No atexit handler or periodic flush
+3. **Integration Module Not Used**: `integration.py` has the code but it's never imported/called
+
+## Recommendations
+
+### Immediate Fixes
+
+1. **Add automatic integration to Agent class**:
+```python
+# In agent/agent.py __init__
+from ..telemetry import get_telemetry
+self._telemetry = get_telemetry()
+
+# In start() method
+if self._telemetry and self._telemetry.enabled:
+    self._telemetry.track_agent_execution(self.name, success=True)
+```
+
+2. **Add atexit handler in telemetry.py**:
+```python
+import atexit
+
+def _flush_on_exit():
+    if _telemetry_instance:
+        _telemetry_instance.flush()
+
+atexit.register(_flush_on_exit)
+```
+
+3. **Add periodic flush**:
+```python
+# Flush after N events or T seconds
+if self._metrics["total_events"] >= 100:
+    self.flush()
+```
+
+### Long-term Improvements
+
+1. **Make telemetry opt-in by default** with clear documentation
+2. **Add telemetry configuration options** (flush interval, batch size)
+3. **Implement proper error handling** for network failures
+4. **Add telemetry dashboard** for users to see their usage
+
+## Testing
+
+Created test files demonstrate:
+- `test_posthog.py`: PostHog is working correctly
+- `test_posthog_detailed.py`: Events are sent when flush() is called
+- `test_telemetry_integration.py`: Integration is missing
+
+## Conclusion
+
+The telemetry infrastructure is well-designed but incomplete. The main issue is that telemetry code exists in isolation and is never called by the core Agent/PraisonAIAgents classes. Additionally, even if it were integrated, the lack of automatic flush mechanisms means data would never reach PostHog.

src/praisonai-agents/telemetry_example.py

@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+"""
+Example demonstrating the minimal telemetry implementation.
+"""
+
+import os
+from praisonaiagents.telemetry import get_telemetry, disable_telemetry, enable_telemetry
+
+# Example 1: Default telemetry (enabled unless disabled by environment)
+print("=== Example 1: Default Telemetry ===")
+telemetry = get_telemetry()
+print(f"Telemetry enabled: {telemetry.enabled}")
+
+# Track some events
+telemetry.track_agent_execution("TestAgent", success=True)
+telemetry.track_task_completion("TestTask", success=True)
+telemetry.track_tool_usage("calculator", success=True)
+telemetry.track_error("ValueError")
+telemetry.track_feature_usage("memory")
+
+# Get metrics
+metrics = telemetry.get_metrics()
+print(f"Current metrics: {metrics}")
+
+# Example 2: Programmatically disable telemetry
+print("\n=== Example 2: Disable Telemetry ===")
+disable_telemetry()
+telemetry = get_telemetry()
+print(f"Telemetry enabled: {telemetry.enabled}")
+
+# These won't be tracked
+telemetry.track_agent_execution("TestAgent2", success=True)
+metrics = telemetry.get_metrics()
+print(f"Metrics after disable: {metrics}")
+
+# Example 3: Re-enable telemetry
+print("\n=== Example 3: Re-enable Telemetry ===")
+enable_telemetry()
+telemetry = get_telemetry()
+print(f"Telemetry enabled: {telemetry.enabled}")
+
+# Example 4: Test with environment variable
+print("\n=== Example 4: Environment Variable Opt-out ===")
+# Simulate environment variable being set
+os.environ['PRAISONAI_TELEMETRY_DISABLED'] = 'true'
+
+# Need to create a new instance to pick up the environment change
+from importlib import reload
+import praisonaiagents.telemetry.telemetry as telemetry_module
+reload(telemetry_module)
+
+from praisonaiagents.telemetry import get_telemetry as get_new_telemetry
+new_telemetry = get_new_telemetry()
+print(f"Telemetry enabled with env var: {new_telemetry.enabled}")
+
+# Clean up
+del os.environ['PRAISONAI_TELEMETRY_DISABLED']
+
+# Example 5: Backward compatibility with TelemetryCollector
+print("\n=== Example 5: Backward Compatibility ===")
+from praisonaiagents.telemetry.telemetry import TelemetryCollector
+
+collector = TelemetryCollector()
+collector.start()
+
+# Use context managers (backward compatible interface)
+with collector.trace_agent_execution("CompatAgent"):
+    print("Executing agent...")
+    
+with collector.trace_tool_call("web_search"):
+    print("Calling tool...")
+
+# Get metrics through collector
+collector_metrics = collector.get_metrics()
+print(f"Collector metrics: {collector_metrics}")
+
+collector.stop()
+
+print("\n=== Telemetry Example Complete ===")
+print("\nPrivacy Notes:")
+print("- No personal data, prompts, or responses are collected")
+print("- Only anonymous usage metrics are tracked")
+print("- Telemetry can be disabled via environment variables:")
+print("  - PRAISONAI_TELEMETRY_DISABLED=true")
+print("  - PRAISONAI_DISABLE_TELEMETRY=true")
+print("  - DO_NOT_TRACK=true")

src/praisonai-agents/telemetry_minimal.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""
+Minimal example showing telemetry integration with agents.
+"""
+
+import os
+# Uncomment to disable telemetry
+# os.environ['PRAISONAI_TELEMETRY_DISABLED'] = 'true'
+
+from praisonaiagents import Agent, Task, PraisonAIAgents
+from praisonaiagents.telemetry import get_telemetry
+
+# Create a simple agent
+agent = Agent(
+    name="Calculator",
+    role="Math Expert",
+    goal="Perform calculations",
+    instructions="You are a helpful math expert."
+)
+
+# Create a task
+task = Task(
+    description="Calculate 2 + 2",
+    expected_output="The sum",
+    agent=agent
+)
+
+# Create and run workflow
+workflow = PraisonAIAgents(
+    agents=[agent],
+    tasks=[task],
+    process="sequential"
+)
+
+print("Running workflow with telemetry...")
+result = workflow.start()
+print(f"Result: {result}")
+
+# Check telemetry metrics
+telemetry = get_telemetry()
+if telemetry.enabled:
+    metrics = telemetry.get_metrics()
+    print(f"\nTelemetry metrics collected:")
+    print(f"- Agent executions: {metrics['metrics']['agent_executions']}")
+    print(f"- Task completions: {metrics['metrics']['task_completions']}")
+    print(f"- Errors: {metrics['metrics']['errors']}")
+    print(f"- Session ID: {metrics['session_id']}")
+else:
+    print("\nTelemetry is disabled")
+
+print("\nTo disable telemetry, set any of these environment variables:")
+print("- PRAISONAI_TELEMETRY_DISABLED=true")
+print("- DO_NOT_TRACK=true")

src/praisonai-agents/test.py

@@ -0,0 +1,23 @@
+from dotenv import load_dotenv
+from praisonaiagents import Agent, MCP
+
+# Load .env before importing anything else
+load_dotenv()
+
+# Define allowed directories for filesystem access
+allowed_dirs = [
+    "/Users/praison/praisonai-package/src/praisonai-agents",
+]
+
+# Use the correct pattern from filesystem MCP documentation
+filesystem_agent = Agent(
+    instructions="""You are a helpful assistant that can interact with the filesystem.
+    Use the available tools when relevant to manage files and directories.""",
+    llm="gpt-4o-mini",
+    tools=MCP(
+        command="npx",
+        args=["-y", "@modelcontextprotocol/server-filesystem"] + allowed_dirs
+    )
+)
+
+filesystem_agent.start("List files in /Users/praison/praisonai-package/src/praisonai-agents directory using MCP list_files")

src/praisonai-agents/test_agent_guardrails.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+"""
+Simple test for Agent guardrail functionality.
+"""
+
+def test_agent_guardrails():
+    """Test basic Agent guardrail functionality."""
+    print("Testing Agent guardrail functionality...")
+    
+    try:
+        from praisonaiagents import Agent, TaskOutput
+        print("✓ Basic imports successful")
+        
+        # Test function-based guardrail
+        def test_guardrail(task_output: TaskOutput):
+            if len(task_output.raw) < 10:
+                return False, "Too short"
+            return True, task_output
+        
+        # Test Agent creation with function guardrail
+        agent1 = Agent(
+            name="TestAgent1",
+            instructions="You are a test agent",
+            guardrail=test_guardrail,
+            max_guardrail_retries=2
+        )
+        print("✓ Agent with function guardrail created successfully")
+        print(f"  - Agent name: {agent1.name}")
+        print(f"  - Has guardrail function: {agent1._guardrail_fn is not None}")
+        print(f"  - Max retries: {agent1.max_guardrail_retries}")
+        
+        # Test Agent creation with string guardrail
+        agent2 = Agent(
+            name="TestAgent2",
+            instructions="You are a test agent",
+            guardrail="Ensure the response is polite and professional",
+            max_guardrail_retries=3
+        )
+        print("✓ Agent with LLM guardrail created successfully")
+        print(f"  - Agent name: {agent2.name}")
+        print(f"  - Has guardrail function: {agent2._guardrail_fn is not None}")
+        print(f"  - Max retries: {agent2.max_guardrail_retries}")
+        
+        # Test Agent without guardrail
+        agent3 = Agent(
+            name="TestAgent3",
+            instructions="You are a test agent"
+        )
+        print("✓ Agent without guardrail created successfully")
+        print(f"  - Agent name: {agent3.name}")
+        print(f"  - Has guardrail function: {agent3._guardrail_fn is None}")
+        
+        print("\n🎉 All Agent guardrail tests passed!")
+        return True
+        
+    except Exception as e:
+        print(f"✗ Error: {e}")
+        import traceback
+        traceback.print_exc()
+        return False
+
+if __name__ == "__main__":
+    test_agent_guardrails()

src/praisonai-agents/test_auto_telemetry_final.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+"""
+Final test of automatic telemetry.
+"""
+
+print("Step 1: Import praisonaiagents...")
+from praisonaiagents import Agent, Task, PraisonAIAgents, get_telemetry
+
+print("\nStep 2: Check if telemetry is initialized...")
+telemetry = get_telemetry()
+print(f"  Telemetry enabled: {telemetry.enabled}")
+print(f"  PostHog available: {telemetry._posthog is not None}")
+
+print("\nStep 3: Check if Agent class is instrumented...")
+print(f"  Agent.__init__.__name__: {Agent.__init__.__name__}")
+
+print("\nStep 4: Create an agent...")
+agent = Agent(name="Test", role="Test", goal="Test", instructions="Test")
+print(f"  agent.chat wrapped: {hasattr(agent.chat, '__wrapped__')}")
+
+print("\nStep 5: Create and run a simple workflow...")
+task = Task(description="Say hello", expected_output="A greeting", agent=agent)
+workflow = PraisonAIAgents(agents=[agent], tasks=[task], process="sequential")
+
+# Check workflow instrumentation
+print(f"  workflow.execute_task wrapped: {hasattr(workflow.execute_task, '__wrapped__')}")
+
+result = workflow.start()
+print(f"\nResult: {result}")
+
+print("\nStep 6: Check metrics...")
+metrics = telemetry.get_metrics()
+print(f"  Metrics: {metrics['metrics']}")
+
+if metrics['metrics']['agent_executions'] > 0:
+    print("\n✅ Automatic telemetry is working!")
+else:
+    print("\n❌ Automatic telemetry is NOT working")
+    print("\nPossible reason: The auto_instrument_all() in __init__.py might be")
+    print("running before the telemetry module's lazy initialization completes.")

src/praisonai-agents/test_both_formats.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+
+from praisonaiagents import Agent, MCP
+import os
+
+def test_agent_direct():
+    """Test using gpt-4o-mini directly (agent.py path)"""
+    print("="*50)
+    print("Testing gpt-4o-mini (agent.py path)")
+    print("="*50)
+    
+    agent = Agent(
+        instructions="You are a helpful assistant that can break down complex problems.",
+        llm="gpt-4o-mini",
+        tools=MCP("npx -y @modelcontextprotocol/server-sequential-thinking")
+    )
+    
+    result = agent.start("What are 5 steps to make coffee?")
+    print("✅ Agent direct path completed successfully")
+    return result
+
+def test_llm_class():
+    """Test using openai/gpt-4o-mini (llm.py path)"""
+    print("\n" + "="*50)
+    print("Testing openai/gpt-4o-mini (llm.py path)")
+    print("="*50)
+    
+    agent = Agent(
+        instructions="You are a helpful assistant that can break down complex problems.",
+        llm="openai/gpt-4o-mini",
+        tools=MCP("npx -y @modelcontextprotocol/server-sequential-thinking")
+    )
+    
+    result = agent.start("What are 5 steps to make coffee?")
+    print("✅ LLM class path completed successfully")
+    return result
+
+if __name__ == "__main__":
+    try:
+        # Test both approaches
+        result1 = test_agent_direct()
+        result2 = test_llm_class()
+        
+        print("\n" + "="*50)
+        print("SUMMARY")
+        print("="*50)
+        print("✅ Both formats work correctly!")
+        print("✅ gpt-4o-mini uses agent.py direct OpenAI calls")
+        print("✅ openai/gpt-4o-mini uses llm.py LiteLLM wrapper")
+        print("✅ Both support tool calling and MCP integration")
+        
+    except Exception as e:
+        print(f"❌ Error occurred: {e}")
+        import traceback
+        traceback.print_exc()

src/praisonai-agents/test_guardrails.py

@@ -0,0 +1,182 @@
+#!/usr/bin/env python3
+"""
+Test script for guardrails functionality in PraisonAI Agents.
+"""
+
+import os
+import sys
+import logging
+
+from praisonaiagents import Agent, Task, TaskOutput
+from praisonaiagents.guardrails import GuardrailResult, LLMGuardrail
+from typing import Tuple, Any
+
+
+def test_function_guardrail():
+    """Test function-based guardrail."""
+    print("Testing function-based guardrail...")
+    
+    def validate_output(task_output: TaskOutput) -> Tuple[bool, Any]:
+        """Simple validation function."""
+        if "error" in task_output.raw.lower():
+            return False, "Output contains errors"
+        if len(task_output.raw) < 10:
+            return False, "Output is too short"
+        return True, task_output
+    
+    # Create agent and task with guardrail
+    agent = Agent(
+        name="Test Agent",
+        role="Tester", 
+        goal="Test guardrails",
+        backstory="I am testing the guardrail functionality"
+    )
+    
+    task = Task(
+        description="Write a simple hello message",
+        expected_output="A friendly greeting message",
+        agent=agent,
+        guardrail=validate_output,
+        max_retries=2
+    )
+    
+    # Test with good output
+    good_output = TaskOutput(
+        description="Test task",
+        raw="Hello! This is a friendly greeting message from the agent.",
+        agent="Test Agent"
+    )
+    
+    result = task._process_guardrail(good_output)
+    assert result.success, f"Good output should pass: {result.error}"
+    print("✓ Good output passed guardrail")
+    
+    # Test with bad output
+    bad_output = TaskOutput(
+        description="Test task", 
+        raw="Error occurred",
+        agent="Test Agent"
+    )
+    
+    result = task._process_guardrail(bad_output)
+    assert not result.success, "Bad output should fail guardrail"
+    print("✓ Bad output failed guardrail as expected")
+    
+    print("Function-based guardrail test passed!\n")
+
+
+def test_string_guardrail():
+    """Test string-based LLM guardrail."""
+    print("Testing string-based LLM guardrail...")
+    
+    # Mock LLM for testing
+    class MockLLM:
+        def chat(self, prompt, **kwargs):
+            # Extract the actual output to validate from the prompt
+            # The LLMGuardrail sends a structured prompt with "Output to Validate:" section
+            if "Output to Validate:" in prompt:
+                # Split by "Output to Validate:" and get the content after it
+                parts = prompt.split("Output to Validate:")
+                if len(parts) > 1:
+                    output_content = parts[1].strip()
+                    # Check only the output content, not the validation criteria
+                    if "error" in output_content.lower():
+                        return "FAIL: The output contains error messages"
+                    return "PASS"
+            
+            # Fallback: if no "Output to Validate:" section, check the prompt directly
+            # This should rarely happen with proper LLMGuardrail usage
+            if "error" in prompt.lower() and "check if" not in prompt.lower():
+                return "FAIL: The output contains error messages"
+            return "PASS"
+    
+    # Create agent with mock LLM
+    agent = Agent(
+        name="Test Agent",
+        role="Tester",
+        goal="Test guardrails", 
+        backstory="I am testing the guardrail functionality"
+    )
+    agent.llm = MockLLM()
+    
+    task = Task(
+        description="Write a simple hello message",
+        expected_output="A friendly greeting message",
+        agent=agent,
+        guardrail="Check if the output is professional and does not contain errors",
+        max_retries=2
+    )
+    
+    # Test with good output
+    good_output = TaskOutput(
+        description="Test task",
+        raw="Hello! This is a professional greeting message.",
+        agent="Test Agent"
+    )
+    
+    result = task._process_guardrail(good_output)
+    assert result.success, f"Good output should pass: {result.error}"
+    print("✓ Good output passed LLM guardrail")
+    
+    # Test with bad output  
+    bad_output = TaskOutput(
+        description="Test task",
+        raw="There was an error in the system",
+        agent="Test Agent"
+    )
+    
+    result = task._process_guardrail(bad_output)
+    assert not result.success, "Bad output should fail LLM guardrail"
+    print("✓ Bad output failed LLM guardrail as expected")
+    
+    print("String-based LLM guardrail test passed!\n")
+
+
+def test_guardrail_result():
+    """Test GuardrailResult helper methods."""
+    print("Testing GuardrailResult...")
+    
+    # Test success case
+    success_result = GuardrailResult.from_tuple((True, "Modified output"))
+    assert success_result.success
+    assert success_result.result == "Modified output"
+    assert success_result.error == ""
+    print("✓ Success result created correctly")
+    
+    # Test failure case
+    failure_result = GuardrailResult.from_tuple((False, "Validation failed"))
+    assert not failure_result.success
+    assert failure_result.result is None
+    assert failure_result.error == "Validation failed"
+    print("✓ Failure result created correctly")
+    
+    print("GuardrailResult test passed!\n")
+
+
+def main():
+    """Run all tests."""
+    print("Running PraisonAI Agents Guardrails Tests...\n")
+    
+    try:
+        test_guardrail_result()
+        test_function_guardrail()
+        test_string_guardrail()
+        
+        print("🎉 All guardrail tests passed!")
+        print("\nGuardrails implementation is working correctly!")
+        
+    except Exception as e:
+        print(f"❌ Test failed: {e}")
+        import traceback
+        traceback.print_exc()
+        return False
+    
+    return True
+
+
+if __name__ == "__main__":
+    # Set up basic logging
+    logging.basicConfig(level=logging.WARNING)
+    
+    success = main()
+    sys.exit(0 if success else 1)

src/praisonai-agents/test_import_order.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+"""
+Test import order to debug telemetry availability.
+"""
+
+import sys
+
+print("1. Importing telemetry module directly...")
+try:
+    import praisonaiagents.telemetry
+    print("   ✅ Telemetry module imported successfully")
+except Exception as e:
+    print(f"   ❌ Failed: {type(e).__name__}: {e}")
+
+print("\n2. Importing main praisonaiagents...")
+try:
+    import praisonaiagents
+    print("   ✅ Main module imported successfully")
+    print(f"   _telemetry_available: {praisonaiagents._telemetry_available}")
+except Exception as e:
+    print(f"   ❌ Failed: {type(e).__name__}: {e}")
+
+print("\n3. Checking what prevented telemetry import...")
+# The main __init__.py tries to import from .telemetry
+# Let's see if we can import the functions directly
+try:
+    from praisonaiagents.telemetry import (
+        get_telemetry,
+        enable_telemetry,
+        disable_telemetry,
+        MinimalTelemetry,
+        TelemetryCollector
+    )
+    print("   ✅ All telemetry functions imported successfully")
+except Exception as e:
+    print(f"   ❌ Failed to import telemetry functions: {type(e).__name__}: {e}")
+    import traceback
+    traceback.print_exc()

src/praisonai-agents/test_litellm_telemetry.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+"""Test script to identify litellm telemetry behavior"""
+
+import os
+import sys
+
+# Disable litellm telemetry before importing
+os.environ["LITELLM_TELEMETRY"] = "False"
+os.environ["LITELLM_LOG"] = "ERROR"
+
+print("Environment variables set:")
+print(f"LITELLM_TELEMETRY: {os.environ.get('LITELLM_TELEMETRY')}")
+print(f"LITELLM_LOG: {os.environ.get('LITELLM_LOG')}")
+
+print("\nImporting litellm...")
+import litellm
+
+print(f"\nChecking litellm telemetry status:")
+print(f"Has telemetry attribute: {hasattr(litellm, 'telemetry')}")
+if hasattr(litellm, 'telemetry'):
+    print(f"Telemetry value: {litellm.telemetry}")
+
+# Try to disable telemetry programmatically
+if hasattr(litellm, 'telemetry'):
+    litellm.telemetry = False
+    print(f"\nTelemetry disabled programmatically")
+
+# Check callbacks
+print(f"\nCallbacks: {litellm.callbacks}")
+print(f"Success callbacks: {litellm.success_callback}")
+print(f"Async success callbacks: {litellm._async_success_callback}")
+
+# Test a simple completion
+print("\n\nTesting completion (this might trigger telemetry)...")
+try:
+    response = litellm.completion(
+        model="gpt-3.5-turbo",
+        messages=[{"role": "user", "content": "Say hi"}],
+        mock_response="Hi there!"
+    )
+    print("Completion successful")
+except Exception as e:
+    print(f"Error: {e}")
+
+print("\nDone. Check if any network requests were made to BerriAI/litellm")

src/praisonai-agents/test_manual_instrumentation.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""
+Test manual instrumentation to verify it works.
+"""
+
+from praisonaiagents import Agent, Task, PraisonAIAgents
+from praisonaiagents.telemetry import get_telemetry
+from praisonaiagents.telemetry.integration import auto_instrument_all
+
+# Manually call auto_instrument_all AFTER importing classes
+print("1. Calling auto_instrument_all()...")
+auto_instrument_all()
+
+print("\n2. Creating agent and task...")
+agent = Agent(
+    name="Calculator",
+    role="Math Expert",
+    goal="Perform calculations",
+    instructions="You are a helpful math expert."
+)
+
+task = Task(
+    description="Calculate 3 + 3",
+    expected_output="The sum",
+    agent=agent
+)
+
+print("\n3. Creating workflow...")
+workflow = PraisonAIAgents(
+    agents=[agent],
+    tasks=[task],
+    process="sequential"
+)
+
+print("\n4. Running workflow...")
+result = workflow.start()
+print(f"Result: {result}")
+
+print("\n5. Checking telemetry metrics...")
+telemetry = get_telemetry()
+metrics = telemetry.get_metrics()
+print(f"Telemetry metrics: {metrics['metrics']}")
+print(f"PostHog available: {telemetry._posthog is not None}")
+
+if metrics['metrics']['agent_executions'] > 0:
+    print("\n✅ SUCCESS! Telemetry is working correctly.")
+    print("   Data will be sent to PostHog on program exit.")
+else:
+    print("\n❌ FAILED! Telemetry metrics are still 0.")
+    
+    # Additional debugging
+    print("\nDebugging info:")
+    print(f"  agent.chat wrapped: {hasattr(agent.chat, '__wrapped__')}")
+    print(f"  workflow.execute_task wrapped: {hasattr(workflow.execute_task, '__wrapped__')}")