PraisonAI 4.6.20__tar.gz → 4.6.22__tar.gz

{praisonai-4.6.20 → praisonai-4.6.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.20
+Version: 4.6.22
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=1.6.20
+Requires-Dist: praisonaiagents>=1.6.22
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<=1.82.6,>=1.81.0
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.20 → praisonai-4.6.22}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.20
+Version: 4.6.22
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=1.6.20
+Requires-Dist: praisonaiagents>=1.6.22
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<=1.82.6,>=1.81.0
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.20 → praisonai-4.6.22}/PraisonAI.egg-info/SOURCES.txt

@@ -160,6 +160,7 @@ praisonai/cli/commands/commit.py
 praisonai/cli/commands/completion.py
 praisonai/cli/commands/config.py
 praisonai/cli/commands/context.py
+praisonai/cli/commands/dashboard.py
 praisonai/cli/commands/debug.py
 praisonai/cli/commands/deploy.py
 praisonai/cli/commands/diag.py
@@ -214,7 +215,6 @@ praisonai/cli/commands/traces.py
 praisonai/cli/commands/tracker.py
 praisonai/cli/commands/train.py
 praisonai/cli/commands/ui.py
-praisonai/cli/commands/unified.py
 praisonai/cli/commands/up.py
 praisonai/cli/commands/version.py
 praisonai/cli/commands/workflow.py
@@ -487,7 +487,12 @@ praisonai/gateway/__init__.py
 praisonai/gateway/exec_approval.py
 praisonai/gateway/gateway_approval.py
 praisonai/gateway/pairing.py
+praisonai/gateway/push_channels.py
+praisonai/gateway/push_delivery.py
+praisonai/gateway/push_polling.py
+praisonai/gateway/push_presence.py
 praisonai/gateway/rate_limiter.py
+praisonai/gateway/redis_pubsub.py
 praisonai/gateway/server.py
 praisonai/inbuilt_tools/__init__.py
 praisonai/inbuilt_tools/autogen_tools.py
@@ -702,6 +707,7 @@ praisonai/tools/audio.py
 praisonai/tools/glob_tool.py
 praisonai/tools/grep_tool.py
 praisonai/tools/multiedit.py
+praisonai/tools/skill_manage.py
 praisonai/train/__init__.py
 praisonai/train/agents/__init__.py
 praisonai/train/agents/grader.py

{praisonai-4.6.20 → praisonai-4.6.22}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.20
+praisonaiagents>=1.6.22
 python-dotenv>=0.19.0
 litellm<=1.82.6,>=1.81.0
 PyYAML>=6.0

{praisonai-4.6.20 → praisonai-4.6.22}/praisonai/agents_generator.py

@@ -1236,6 +1236,10 @@ class AgentsGenerator:
                 except ImportError:
                     self.logger.warning("OutputConfig not available, streaming disabled")
             
+            # G16: YAML `skills:` key. Accepts a list of paths, a single path
+            # string, or a full SkillsConfig dict (paths/dirs/auto_discover).
+            agent_skills = details.get('skills')
+
             agent = PraisonAgent(
                 name=role_filled,
                 role=role_filled,
@@ -1252,6 +1256,7 @@ class AgentsGenerator:
                 guardrails=guardrails_config,
                 approval=approval_config,
                 output=output_config,
+                skills=agent_skills,
             )
             
             if self.agent_callback:

{praisonai-4.6.20 → praisonai-4.6.22}/praisonai/capabilities/skills.py

@@ -97,19 +97,20 @@ def skill_load(
     """
     try:
         from praisonaiagents.skills import load_skill
-        
-        skill = load_skill(skill_name, skill_dirs)
-        
-        if skill:
-            return SkillResult(
-                name=skill.name,
-                description=skill.description,
-                path=str(skill.path) if skill.path else None,
-                instructions=skill.instructions if hasattr(skill, 'instructions') else None,
-                metadata=metadata or {},
-            )
-        
-        return None
+
+        loaded = load_skill(skill_name, skill_dirs)
+
+        if loaded is None:
+            return None
+
+        props = loaded.properties
+        return SkillResult(
+            name=props.name,
+            description=props.description,
+            path=str(props.path) if props.path else None,
+            instructions=loaded.instructions,
+            metadata=metadata or {},
+        )
     except ImportError:
         return None
 

{praisonai-4.6.20 → praisonai-4.6.22}/praisonai/cli/app.py

@@ -348,7 +348,7 @@ def register_commands():
     from .commands.sandbox import app as sandbox_app
     from .commands.claw import app as claw_app
     from .commands.flow import app as flow_app
-    from .commands.unified import app as unified_app
+    from .commands.dashboard import app as unified_app
     from .commands.langfuse import app as langfuse_app
     from .commands.langextract import app as langextract_app
     from .commands.port import app as port_app

praisonai-4.6.20/praisonai/cli/commands/unified.py → praisonai-4.6.22/praisonai/cli/commands/dashboard.py

@@ -10,6 +10,7 @@ import subprocess
 import sys
 import atexit
 import signal
+import json
 from pathlib import Path
 from types import FrameType
 from typing import Set, TextIO
@@ -76,6 +77,218 @@ def _unregister_cleanup_handlers(original_sigint, original_sigterm):
     # so we keep the atexit handler but check if process list is empty
 
 
+def _spawn_service(service_name: str, service_port: int, host: str, log_handle):
+    """Spawn a single service with proper command configuration."""
+    # Service configuration: [command, extra_flags]
+    service_config = {
+        "flow": ["flow", ["--no-open"]],
+        "claw": ["claw", []],
+        "ui": ["ui", []]
+    }
+    
+    if service_name not in service_config:
+        raise ValueError(f"Unknown service: {service_name}")
+    
+    command, extra_flags = service_config[service_name]
+    argv = [sys.executable, "-m", "praisonai", command, "--port", str(service_port), "--host", host] + extra_flags
+    
+    return subprocess.Popen(argv, stdout=log_handle, stderr=subprocess.STDOUT)
+
+
+def _wait_for_service_ready(service_name: str, proc: subprocess.Popen, service_port: int, host: str, log_file: Path, console, timeout: int = 15) -> bool:
+    """Wait for service to be ready with proper readiness check."""
+    check_host = _resolve_check_host(host)
+    deadline = time.time() + timeout
+    
+    while time.time() < deadline:
+        # Check if process crashed
+        if proc.poll() is not None:
+            console.print(f"[red]✗ {service_name} crashed during startup (exit code: {proc.returncode})[/red]")
+            console.print(f"[dim]Check log: {log_file}[/dim]")
+            return False
+        
+        # Check if service is accepting connections
+        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        try:
+            if sock.connect_ex((check_host, service_port)) == 0:
+                return True
+        except OSError:
+            pass
+        finally:
+            sock.close()
+        
+        time.sleep(0.5)
+    
+    console.print(f"[red]✗ {service_name} did not become ready within {timeout} seconds[/red]")
+    console.print(f"[dim]Check log: {log_file}[/dim]")
+    return False
+
+
+def _auto_start_services(console, host: str) -> bool:
+    """Auto-start PraisonAI services with proper readiness checks."""
+    services = [
+        ("flow", 7860),
+        ("claw", 8082),
+        ("ui", 8081)
+    ]
+    
+    success_count = 0
+    
+    for service_name, service_port in services:
+        # Check if service is already running
+        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        check_host = _resolve_check_host(host)
+        try:
+            connection_result = sock.connect_ex((check_host, service_port))
+            if connection_result == 0:
+                console.print(f"[yellow]✓ {service_name} already running on port {service_port}[/yellow]")
+                success_count += 1
+                sock.close()
+                continue
+        except OSError:
+            pass
+        finally:
+            sock.close()
+        
+        # Start the service
+        console.print(f"[cyan]Starting {service_name} on port {service_port}...[/cyan]")
+        log_handle = None
+        proc = None
+        try:
+            # Create log directory for troubleshooting
+            log_dir = Path.home() / ".praisonai" / "unified" / "logs"
+            log_dir.mkdir(parents=True, exist_ok=True)
+            log_file = log_dir / f"{service_name}.log"
+            
+            log_handle = open(log_file, "a", encoding="utf-8")
+            
+            # Spawn service using shared logic
+            proc = _spawn_service(service_name, service_port, host, log_handle)
+            
+            # Wait for service to be ready
+            if _wait_for_service_ready(service_name, proc, service_port, host, log_file, console):
+                # Track process for cleanup only after successful startup
+                _ACTIVE_PROCESSES.add(proc)
+                _PROCESS_LOG_HANDLES[proc] = log_handle
+                console.print(f"[green]✓ {service_name} started successfully[/green]")
+                success_count += 1
+                log_handle = None  # Don't close, it's now tracked
+            else:
+                # Clean up failed process
+                if proc and proc.poll() is None:
+                    proc.terminate()
+                    try:
+                        proc.wait(timeout=5)
+                    except subprocess.TimeoutExpired:
+                        proc.kill()
+                if log_handle:
+                    log_handle.close()
+                    log_handle = None
+                    
+        except Exception as e:
+            console.print(f"[red]✗ Failed to start {service_name}: {e}[/red]")
+            if proc:
+                try:
+                    proc.terminate()
+                except Exception:
+                    pass
+            if log_handle:
+                log_handle.close()
+    
+    return success_count == len(services)
+
+
+def _run_aiui_dashboard(port: int, host: str, console) -> bool:
+    """Run the aiui dashboard interface using proper CLI entrypoint."""
+    console.print("[bold green]🦞 Starting aiui Dashboard...[/bold green]")
+    
+    try:
+        import tempfile
+        import os
+        
+        # Check if aiui is available first
+        result = subprocess.run([
+            sys.executable, "-c", "import praisonaiui"
+        ], capture_output=True, text=True)
+        
+        if result.returncode != 0:
+            console.print("[red]Error: aiui package not installed.[/red]")
+            console.print("[yellow]Install with: pip install aiui[/yellow]")
+            return False
+        
+        # Create a temporary script for aiui dashboard based on claw pattern
+        aiui_script = '''import os
+import praisonaiui as aiui
+from praisonai.ui._aiui_datastore import PraisonAISessionDataStore
+
+# Set up datastore bridge
+aiui.set_datastore(PraisonAISessionDataStore())
+
+# Configure dashboard style
+aiui.set_style("dashboard")
+aiui.set_branding(title="PraisonAI Unified Dashboard", logo="🌟")
+
+# Set up pages for unified dashboard
+aiui.set_pages([
+    "chat", "agents", "memory", "knowledge", 
+    "skills", "sessions", "usage", "config", "logs"
+])
+
+# Register a simple welcome message
+@aiui.welcome
+async def on_welcome():
+    await aiui.say("🌟 Welcome to PraisonAI Unified Dashboard!")
+    await aiui.say("Access all your AI services from one interface.")
+
+# Register basic reply handler
+@aiui.reply
+async def on_reply(message: str, settings: dict | None = None):
+    await aiui.think("Processing...")
+    await aiui.say(f"Unified Dashboard received: {message}")
+    await aiui.say("Use the sidebar to access Flow, Agents, Memory, and more!")
+'''
+
+        # Create temp file safely
+        with tempfile.NamedTemporaryFile(mode='w', suffix='.py', delete=False) as f:
+            f.write(aiui_script)
+            temp_script = f.name
+        
+        try:
+            console.print(f"[green]✓ Starting aiui dashboard on {host}:{port}[/green]")
+            
+            # Use aiui CLI to run the dashboard (NOT create_app)
+            # Try aiui command first, fallback to python -m
+            try:
+                result = subprocess.run([
+                    "aiui", "run", temp_script, "--port", str(port), "--host", host
+                ], check=True)
+            except (subprocess.CalledProcessError, FileNotFoundError):
+                # Fallback to python -m praisonaiui
+                result = subprocess.run([
+                    sys.executable, "-m", "praisonaiui.cli", "run", 
+                    temp_script, "--port", str(port), "--host", host
+                ], check=True)
+            
+            return True
+            
+        except subprocess.CalledProcessError as e:
+            console.print(f"[red]aiui dashboard exited with code {e.returncode}[/red]")
+            return False
+        finally:
+            # Clean up temp file
+            try:
+                os.unlink(temp_script)
+            except (OSError, FileNotFoundError):
+                pass
+        
+    except subprocess.CalledProcessError as e:
+        console.print(f"[red]aiui dashboard failed with code {e.returncode}[/red]")
+        return False
+    except Exception as e:
+        console.print(f"[red]Error running aiui dashboard: {e}[/red]")
+        return False
+
+
 def _generate_dashboard_html(host: str = "localhost") -> str:
     """Generate dashboard HTML with dynamic host configuration."""
     dashboard_html = """<!DOCTYPE html>
@@ -393,6 +606,8 @@ def unified(
     ctx: typer.Context,
     port: int = typer.Option(3000, "--port", "-p", help="Port to run unified dashboard on"),
     host: str = typer.Option("127.0.0.1", "--host", help="Host to bind to (use 0.0.0.0 to expose remotely)"),
+    auto_start: bool = typer.Option(True, "--auto-start/--no-auto-start", help="Auto-start all services"),
+    aiui: bool = typer.Option(False, "--aiui", help="Use aiui dashboard interface (experimental)"),
 ):
     """
     Launch the PraisonAI Unified Dashboard.
@@ -402,15 +617,19 @@ def unified(
     - Claw Dashboard (Full UI) - port 8082  
     - Clean Chat UI - port 8081
     
-    This unified launcher allows you to:
-    1. Create agents visually using Flow Builder
-    2. Chat with agents using the Chat UI
-    3. Manage everything from Claw Dashboard
-    4. Connect external services like Telegram
+    This unified launcher:
+    1. Auto-starts all services by default (like 'praisonai up')
+    2. Creates agents visually using Flow Builder
+    3. Chats with agents using the Chat UI
+    4. Manages everything from Claw Dashboard
+    5. Connects external services like Telegram
+    6. Optionally uses aiui for enhanced dashboard experience
     
     Examples:
-        praisonai dashboard
+        praisonai dashboard                           # Auto-start all services
+        praisonai dashboard --no-auto-start          # Dashboard only (no auto-start)
         praisonai dashboard --port 9000 --host 0.0.0.0
+        praisonai dashboard --aiui                   # Use aiui interface (experimental)
     """
     if ctx.invoked_subcommand is not None:
         return
@@ -418,6 +637,23 @@ def unified(
     from rich.console import Console
     console = Console()
     
+    # Auto-start services if enabled (before aiui mode)
+    if auto_start:
+        console.print("[bold green]🚀 Auto-starting PraisonAI services...[/bold green]")
+        if not _auto_start_services(console, host):
+            console.print("[yellow]⚠️  Some services failed to start, continuing anyway...[/yellow]")
+        console.print("[green]✅ Auto-start complete[/green]")
+        console.print()
+    
+    # Check for aiui mode
+    if aiui:
+        result = _run_aiui_dashboard(port, host, console)
+        if not result:
+            console.print("[red]Failed to start aiui dashboard, falling back to standard dashboard[/red]")
+            # Continue to standard dashboard instead of exiting
+        else:
+            return  # aiui started successfully, exit
+    
     # Import optional dependencies inside function to avoid startup overhead
     try:
         from fastapi import FastAPI, HTTPException
@@ -429,6 +665,14 @@ def unified(
         console.print(f"[dim]Error details: {exc}[/dim]")
         raise typer.Abort()
     
+    # Auto-start services if not already done for aiui
+    if auto_start and not aiui:
+        console.print("[bold green]🚀 Auto-starting PraisonAI services...[/bold green]")
+        if not _auto_start_services(console, host):
+            console.print("[yellow]⚠️  Some services failed to start, dashboard will still work[/yellow]")
+        console.print("[green]✅ Auto-start complete[/green]")
+        console.print()
+    
     # Register cleanup handlers and save originals for restoration
     original_handlers = _register_cleanup_handlers()
     
@@ -468,22 +712,8 @@ def unified(
             log_file = log_dir / f"{service}.log"
             log_handle = open(log_file, "a", encoding="utf-8")
             
-            if service == "flow":
-                # Use praisonai module entrypoint so command resolution matches CLI behavior.
-                proc = subprocess.Popen([
-                    sys.executable, "-m", "praisonai", "flow", 
-                    "--port", str(service_port), "--host", host, "--no-open"
-                ], stdout=log_handle, stderr=subprocess.STDOUT)
-            elif service == "claw":
-                proc = subprocess.Popen([
-                    sys.executable, "-m", "praisonai", "claw",
-                    "--port", str(service_port), "--host", host
-                ], stdout=log_handle, stderr=subprocess.STDOUT)
-            elif service == "ui":
-                proc = subprocess.Popen([
-                    sys.executable, "-m", "praisonai", "ui",
-                    "--port", str(service_port), "--host", host
-                ], stdout=log_handle, stderr=subprocess.STDOUT)
+            # Use shared service spawning logic
+            proc = _spawn_service(service, service_port, host, log_handle)
             
             # Wait for service to start with timeout
             deadline = time.time() + 15
@@ -554,6 +784,8 @@ def unified(
     console.print()
     console.print("[bold green]🌟 Starting PraisonAI Unified Dashboard[/bold green]")
     console.print(f"[dim]Unified interface on {host}:{port}[/dim]")
+    if auto_start:
+        console.print("[dim]Services auto-started and dashboard ready[/dim]")
     console.print("[dim]Access Flow Builder, Claw Dashboard, and Chat UI from one place[/dim]")
     console.print()
     

{praisonai-4.6.20 → praisonai-4.6.22}/praisonai/cli/commands/skills.py

@@ -80,24 +80,73 @@ def skills_create(
 
 @app.command("install")
 def skills_install(
-    source: str = typer.Argument(..., help="Skill source (path or URL)"),
+    source: str = typer.Argument(..., help="Skill source (local path or https:// git URL)"),
+    dest: str = typer.Option(None, "--dest", "-d", help="Install destination (defaults to ~/.praisonai/skills)"),
 ):
-    """Install a skill."""
-    from praisonai.cli.main import PraisonAI
-    import sys
-    
-    argv = ['skills', 'install', source]
-    
-    original_argv = sys.argv
-    sys.argv = ['praisonai'] + argv
-    
-    try:
-        praison = PraisonAI()
-        praison.main()
-    except SystemExit:
-        pass
-    finally:
-        sys.argv = original_argv
+    """Install a skill from a local path or git URL.
+
+    Local path:  ``praisonai skills install ./my-skill``
+    Git URL:     ``praisonai skills install https://github.com/org/repo``
+    """
+    import shutil
+    import subprocess
+    import tempfile
+    from pathlib import Path
+
+    from praisonaiagents.paths import get_skills_dir
+    from praisonaiagents.skills import validate as validate_skill
+
+    dest_root = Path(dest).expanduser() if dest else get_skills_dir()
+    dest_root.mkdir(parents=True, exist_ok=True)
+
+    def _install_from_dir(src: Path) -> Path:
+        target = dest_root / src.name
+        if target.exists():
+            typer.echo(f"Error: {target} already exists; remove it first.", err=True)
+            raise typer.Exit(1)
+        shutil.copytree(src, target)
+        return target
+
+    src_path = Path(source).expanduser()
+    installed: Path
+    if source.startswith(("http://", "https://", "git@")):
+        with tempfile.TemporaryDirectory() as tmp:
+            tmp_path = Path(tmp) / "clone"
+            proc = subprocess.run(
+                ["git", "clone", "--depth=1", source, str(tmp_path)],
+                capture_output=True, text=True,
+            )
+            if proc.returncode != 0:
+                typer.echo(f"git clone failed: {proc.stderr.strip()}", err=True)
+                raise typer.Exit(1)
+            # If the clone contains a top-level SKILL.md, install as-is.
+            # Otherwise, install each direct subdirectory that looks like a skill.
+            if (tmp_path / "SKILL.md").exists():
+                installed = _install_from_dir(tmp_path)
+            else:
+                installed_any = False
+                for child in tmp_path.iterdir():
+                    if child.is_dir() and (child / "SKILL.md").exists():
+                        _install_from_dir(child)
+                        installed_any = True
+                if not installed_any:
+                    typer.echo("No SKILL.md found in clone.", err=True)
+                    raise typer.Exit(1)
+                typer.echo(f"Installed skills to {dest_root}")
+                return
+    elif src_path.exists() and src_path.is_dir():
+        installed = _install_from_dir(src_path)
+    else:
+        typer.echo(f"Unknown source (not a dir, not a URL): {source}", err=True)
+        raise typer.Exit(1)
+
+    errors = validate_skill(installed)
+    if errors:
+        typer.echo(f"Installed at {installed} but validation found issues:", err=True)
+        for e in errors:
+            typer.echo(f"  - {e}", err=True)
+        raise typer.Exit(1)
+    typer.echo(f"Installed: {installed}")
 
 
 @app.command("search")

{praisonai-4.6.20 → praisonai-4.6.22}/praisonai/deploy.py

@@ -57,7 +57,7 @@ class CloudDeployer:
             file.write("FROM python:3.11-slim\n")
             file.write("WORKDIR /app\n")
             file.write("COPY . .\n")
-            file.write("RUN pip install flask praisonai==4.6.20 gunicorn markdown\n")
+            file.write("RUN pip install flask praisonai==4.6.22 gunicorn markdown\n")
             file.write("EXPOSE 8080\n")
             file.write('CMD ["gunicorn", "-b", "0.0.0.0:8080", "api:app"]\n')