hot-tool 0.0.3

Build and package Python tools into standalone executables for LLM integration.

Hot-Tool

Build and package Python tools into standalone executables for LLM integration.

Features

• Define Tools Simply - Inherit from HotTool class and implement the run() method
• Build Standalone Executables - Compile Python tools into single binary files using hot-tool build
• Run Without Dependencies - Execute tools without Python installation or source code access

Installation

pip install hot-tool

Quick Start

Define Hot Tool

# get_my_ip.py
from typing import Optional

import requests

from hot_tool import HotTool


class GetMyIpTool(HotTool):
    def run(
        self, arguments: Optional[str] = None, context: Optional[str] = None
    ) -> str:
        response = requests.get("https://ifconfig.me")
        try:
            response.raise_for_status()
            return response.text.strip()
        except Exception as e:
            print(f"Error: {type(e).__name__}: {e}")
            return "Can not get my IP, please try again later."

Run Programmatically

# main.py
from get_my_ip import GetMyIpTool
from hot_tool.run import run_tool

print(run_tool(GetMyIpTool))
# 198.51.100.156

Build Standalone Executable and Run as Executable

hot-tool build get_my_ip.py -o get_my_ip
# Starting Nuitka compilation...
# ...
# Nuitka-Plugins:upx: Compressing 'get_my_ip'.
# Nuitka: Successfully created 'get_my_ip'.
# Compilation completed successfully.
# Standalone script saved to '/Users/me/path/to/get_my_ip'

./get_my_ip
# 198.51.100.156

Advanced Usage

Tool Inheritance for Reusability

You can create reusable base tool classes and import them into your scripts:

# base_tool.py
from hot_tool import HotTool

class BaseAPITool(HotTool):
    def run(self, arguments=None, context=None):
        # Shared logic here
        return self.call_api()

# my_tool.py - Your main script
from base_tool import BaseAPITool

class MyCustomTool(BaseAPITool):  # Inherit from your base class
    def run(self, arguments=None, context=None):
        # Custom implementation
        return "Custom result"

Important: Each script can only define one concrete tool class that implements run(). Imported base classes don't count toward this limit.

License

MIT License