Skip to content

Quick Start

This page gets you from zero to working code in under a minute. For the full tool catalog, see Tools.

Prerequisites

pip install toolregistry-hub

Try It

Math & Units

from toolregistry_hub import Calculator, UnitConverter

Calculator.evaluate("sqrt(144) + 2**3")          # 20.0
Calculator.evaluate("log(100, 10) + sin(pi/2)")  # 3.0

UnitConverter.convert(100, "celsius_to_fahrenheit")  # 212.0

Date & Time

from toolregistry_hub import DateTime

DateTime.now("Asia/Shanghai")                                   # current time in Shanghai
DateTime.convert_timezone("14:30", "America/Chicago", "Asia/Tokyo")  # timezone conversion

Files

from toolregistry_hub import FileSearch, FileReader, FileOps

FileSearch.grep(r"TODO", path="src/")               # find TODOs in source
FileSearch.tree("src/", max_depth=2)                 # directory overview
FileReader.read("config.py", limit=20)               # first 20 lines
FileOps.edit("config.py",
             old_string="DEBUG = True",
             new_string="DEBUG = False")              # safe string replace

Web

from toolregistry_hub import Fetch
from toolregistry_hub.websearch import WebSearch

Fetch().fetch_content("https://example.com")         # extract page content

ws = WebSearch()
results = ws.search("Python 3.12 new features", max_results=3)
for r in results:
    print(f"{r.title}: {r.url}")

API Keys

Web search tools need API keys set as environment variables. Tools without keys (Calculator, DateTime, FileOps, etc.) work out of the box. See Environment Variables for the full list.

Shell

from toolregistry_hub import BashTool

result = BashTool.execute("python --version", timeout=10)
print(result["stdout"])  # Python 3.11.5

Start a Server

pip install toolregistry-hub[server]
toolregistry-hub openapi --port 8000
# → API docs at http://localhost:8000/docs

What's Next?

I want to… Go to
Browse all available tools Tools
Use tools as Python imports Library Usage
Deploy as REST API or MCP Server Mode
Run in Docker Docker Deployment
Register tools with an agent Library Usage → AI Agents