Skip to content

Built-in Tools

execute_command

  • Executes shell commands
  • Returns command output
  • Example: 
    from uglychain.tools import execute_command

@tool
def update_system():
    return execute_command("sudo apt update && sudo apt upgrade -y")
  • Performs web searches
  • Returns search results
  • Example: 
    from uglychain.tools import web_search

@tool
def search_weather(city: str):
    return web_search(f"Weather in {city}")

file_operations

  • Provides file system operations
  • Includes read/write/delete functions
  • Example: 
    from uglychain.tools import file_operations

@tool
def create_file(path: str, content: str):
    return file_operations.write(path, content)

Custom Tools

  • Create custom tools using @tool decorator
  • Example: ```python from uglychain import tool

@tool def custom_tool(param: str): return f"Processed {param}"