Skip to main content

ToolRegistry Hub Documentation

PyPI version Docker Image CI

中文版 | English version

Welcome to the ToolRegistry Hub documentation! This document provides detailed descriptions of all tools in the project.

Ecosystem

Package Description PyPI Docs
toolregistry Core library — tool registration, schema generation, execution PyPI Docs
toolregistry-server Server adapters — expose tools via OpenAPI & MCP PyPI Docs
toolregistry-hub Ready-to-use tools — calculator, web search, file ops, etc. PyPI Docs

📚 Documentation

For detailed documentation, please visit our ReadTheDocs pages:

Tools Overview

ToolRegistry Hub is a Python library that provides various utility tools designed to support common tasks. Here are the main tool categories:

  • Calculator Tools - Provides various mathematical calculation functions
  • Date Time Tools - Handles date, time, and timezone conversions
  • File Operations Tools - Provides file content manipulation functions
  • File System Tools - Provides file system operation functions
  • Web Search Tools - Provides web search functionality
  • Unit Converter Tools - Provides conversions between various units
  • Other Tools - Other utility tools
  • Server Mode - REST API and MCP server
  • Docker Deployment - Docker containerization deployment

For detailed information about each tool category, please refer to the online documentation.

Quick Start

To use ToolRegistry Hub, first install the library:

pip install toolregistry-hub

Then, you can import and use the required tools:

from toolregistry_hub import Calculator, DateTime, FileOps

# Use calculator
result = Calculator.evaluate("2 + 2 * 3")
print(result)  # Output: 8

# Get current time
current_time = DateTime.now()
print(current_time)

Documentation Structure

This documentation is organized by tool categories, with each tool category having its own page that details all tools, methods, and usage examples under that category.

Changelog

Web Fetch Tool — Major Update (PR #140)

Structured return value

fetch_content now returns a structured dict instead of a plain str:

{
  "content": "...",
  "url": "https://example.com",
  "strategy": "readability",
  "quality": "high",
  "content_type": "text/html",
  "cached": false,
  "elapsed_ms": 123,
  "metadata": {"readability_score": 174.3, "content_length": 12345}
}

strategy parameter

A new optional strategy parameter lets you specify the extraction strategy (default: "auto"). Available choices:

Strategy Description
auto Recommended — tries each fallback in order
markdown Cloudflare content negotiation
readability Local readability extraction
soup Local BeautifulSoup fallback
veilrender Remote headless browser (requires VEILRENDER_ENDPOINT)
cdp Self-hosted Chrome DevTools Protocol (requires CDP_ENDPOINT)
jina Jina Reader API (always available; optional JINA_API_KEY for higher rate limits)

Available choices are narrowed at runtime: veilrender and cdp appear only when their respective endpoints are configured.

Updated fallback chain

markdown → readability → soup → veilrender → cdp → jina → local_fallback

VeilRender fallback

VeilRender is a new optional remote headless browser fallback for JS-heavy pages and SPAs. Configure via environment variables:

VEILRENDER_ENDPOINT=https://your-veilrender-instance
VEILRENDER_TOKEN=your_token_here  # optional

Contributing

If you want to contribute to ToolRegistry Hub, please refer to the GitHub repository.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

toolregistry_hub-0.9.3.tar.gz (222.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

toolregistry_hub-0.9.3-py3-none-any.whl (207.1 kB view details)

Uploaded Python 3

File details

Details for the file toolregistry_hub-0.9.3.tar.gz.

File metadata

  • Download URL: toolregistry_hub-0.9.3.tar.gz
  • Upload date:
  • Size: 222.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for toolregistry_hub-0.9.3.tar.gz
Algorithm Hash digest
SHA256 cb86734c12170119a8057fca9f053ceb4c0ed1287f3b848e01e59b40d22dcd92
MD5 4644091a43fd1819efc4fd6c9db8a767
BLAKE2b-256 220ca3b1c7c712c22398a54a352fe154b187fc58a5bb8661c2642f06a024ac24

See more details on using hashes here.

Provenance

The following attestation bundles were made for toolregistry_hub-0.9.3.tar.gz:

Publisher: release.yml on Oaklight/toolregistry-hub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file toolregistry_hub-0.9.3-py3-none-any.whl.

File metadata

File hashes

Hashes for toolregistry_hub-0.9.3-py3-none-any.whl
Algorithm Hash digest
SHA256 adac181cd7069e9c51779ad39539922d84f1313c0227d9b1e73c768d818d76c0
MD5 2e846f7e3a94fc5d869c273ea0c7e933
BLAKE2b-256 dfbc16673831f0ca3cc9a32cdcec5e9d7dab7989a7f9d8b22623044eb65e0c40

See more details on using hashes here.

Provenance

The following attestation bundles were made for toolregistry_hub-0.9.3-py3-none-any.whl:

Publisher: release.yml on Oaklight/toolregistry-hub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page