pip install praisonaiagents

# For full tools support
pip install "praisonai[tools]"

from praisonaiagents import Agent, tool

@tool
def search_web(query: str) -> str:
    """Search the web for information."""
    return f"Results for: {query}"

agent = Agent(
    name="Researcher",
    tools=[search_web]
)

from praisonaiagents import Agent
from praisonaiagents import duckduckgo, wikipedia_tools

agent = Agent(
    name="Researcher",
    tools=[duckduckgo, wikipedia_tools]
)

from praisonaiagents import BaseTool

class MyTool(BaseTool):
    name = "my_tool"
    description = "Does something useful"
    
    def run(self, query: str) -> str:
        return f"Result for {query}"

from praisonaiagents import FunctionTool

tool_instance = FunctionTool(
    func=my_function,
    name="custom_name",
    description="Custom description"
)

from praisonaiagents import ToolResult

result = ToolResult(
    output="Success data",
    success=True,
    error=None,
    metadata={"execution_time": 0.5}
)

from praisonaiagents import ToolValidationError

raise ToolValidationError("Invalid tool configuration")

from praisonaiagents import tool

# Simple usage
@tool
def my_func(x: str) -> str:
    """Does something."""
    return x

# With parameters
@tool(name="custom_name", description="Custom description")
def my_func(x: str) -> str:
    return x

from praisonaiagents import Agent, BaseTool, tool

# Method 1: Using @tool decorator
@tool
def get_weather(city: str) -> str:
    """Get current weather for a city."""
    return f"Weather in {city}: Sunny, 22°C"

# Method 2: Subclassing BaseTool
class StockPriceTool(BaseTool):
    name = "get_stock_price"
    description = "Get current stock price for a symbol"
    
    def run(self, symbol: str) -> dict:
        return {"symbol": symbol, "price": 150.00}

# Use with agent
agent = Agent(
    name="Assistant",
    tools=[get_weather, StockPriceTool()]
)

from praisonaiagents import Agent
from praisonaiagents import (
    duckduckgo,
    wiki_search,
    read_file,
    execute_command
)

agent = Agent(
    name="Research Assistant",
    tools=[duckduckgo, wiki_search, read_file, execute_command]
)

from praisonaiagents import get_registry, register_tool, get_tool

# Get the global registry
registry = get_registry()

# Register a tool
@tool
def my_tool(x: str) -> str:
    return x

register_tool(my_tool)

# Retrieve a tool
tool = get_tool("my_tool")

from praisonaiagents import BaseTool, validate_tool, ToolValidationError

class MyTool(BaseTool):
    name = "my_tool"
    description = "My custom tool"
    
    def run(self, query: str) -> str:
        return query

# Validate the tool
try:
    validate_tool(MyTool())
    print("Tool is valid!")
except ToolValidationError as e:
    print(f"Validation failed: {e}")