Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 0.9.3 instead.
Reason given by maintainers: Missing bashtool submodule — import fails with ModuleNotFoundError. Fixed in 0.9.3

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.2.tar.gz (217.6 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.2-py3-none-any.whl (201.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: toolregistry_hub-0.9.2.tar.gz
  • Upload date:
  • Size: 217.6 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.2.tar.gz
Algorithm Hash digest
SHA256 b08cc13c0fc30124468432d9109452bdf442c6dbd363d62e2a1f80e8cde2e294
MD5 cfcafff624440736f2853bd9d6e22b2d
BLAKE2b-256 567a5d7ed74720e56d2ab980a712ef01489c1230361a2396964d2a4ac17990fe

See more details on using hashes here.

Provenance

The following attestation bundles were made for toolregistry_hub-0.9.2.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.2-py3-none-any.whl.

File metadata

File hashes

Hashes for toolregistry_hub-0.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1f29f09dd4efaaa68ca5dc3436beb782080a9472ad27580c884bb20ae84410e3
MD5 67d7f30423a66c7b1814ef6efc7bea2b
BLAKE2b-256 df9d00fabf2676b4f0fae4879685dd181d2487b2bb08d9355722cb4dc5455212

See more details on using hashes here.

Provenance

The following attestation bundles were made for toolregistry_hub-0.9.2-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