Metadata-Version: 2.4
Name: toolregistry-hub
Version: 0.5.5
Summary: ToolRegistry Hub: A Python library providing various utility tools for mathematical calculations, date/time operations, file management, web search, unit conversions, and more - designed to support common tasks in LLM function calling and general development
Author-email: Oaklight <oaklight@gmx.com>
License: MIT
Project-URL: Documentation, https://toolregistry.readthedocs.io
Project-URL: Repository, https://github.com/Oaklight/toolregistry-hub
Project-URL: Issues, https://github.com/Oaklight/toolregistry-hub/issues
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: loguru>=0.7.3
Requires-Dist: httpx>=0.28.1
Requires-Dist: ua-generator>=1.0.6; python_version < "3.9"
Requires-Dist: ua-generator
Requires-Dist: beautifulsoup4>=4.13.4
Requires-Dist: pydantic<3.0.0,>=2.7.2
Requires-Dist: backports.zoneinfo>=0.2.1; python_version < "3.9"
Provides-Extra: dev
Requires-Dist: python-dotenv>=1.0.1; extra == "dev"
Requires-Dist: pyright>=1.1.402; extra == "dev"
Requires-Dist: build>=1.2.2.post1; extra == "dev"
Requires-Dist: twine>=6.1.0; extra == "dev"
Requires-Dist: pytest>=7.0.0; extra == "dev"
Provides-Extra: server-openapi
Requires-Dist: fastapi>=0.119.0; extra == "server-openapi"
Requires-Dist: uvicorn[standard]>=0.24.0; extra == "server-openapi"
Provides-Extra: server-mcp
Requires-Dist: fastapi>=0.119.0; extra == "server-mcp"
Requires-Dist: fastmcp>=2.12.4; python_version >= "3.10" and extra == "server-mcp"
Provides-Extra: server
Requires-Dist: fastapi>=0.119.0; extra == "server"
Requires-Dist: uvicorn[standard]>=0.24.0; extra == "server"
Requires-Dist: fastmcp>=2.12.4; python_version >= "3.10" and extra == "server"
Dynamic: license-file

# ToolRegistry Hub Documentation

[![Docker Image Version](https://img.shields.io/docker/v/oaklight/toolregistry-hub-server?label=Docker&logo=docker)](https://hub.docker.com/r/oaklight/toolregistry-hub-server)
[![PyPI version](https://badge.fury.io/py/toolregistry-hub.svg?icon=si%3Apython)](https://badge.fury.io/py/toolregistry-hub)
[![GitHub version](https://badge.fury.io/gh/oaklight%2Ftoolregistry-hub.svg?icon=si%3Agithub)](https://badge.fury.io/gh/oaklight%2Ftoolregistry-hub)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Oaklight/toolregistry-hub)

[中文版](readme_zh.md) | [English version](readme_en.md)

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

## 📚 Documentation

For detailed documentation, please visit our ReadTheDocs pages:

- **English Documentation**: [https://toolregistry-hub.readthedocs.io/en/latest/](https://toolregistry-hub.readthedocs.io/en/latest/)
- **中文文档**: [https://toolregistry-hub.readthedocs.io/zh-cn/latest/](https://toolregistry-hub.readthedocs.io/zh-cn/latest/)

## 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](https://toolregistry-hub.readthedocs.io/en/latest/).

## Quick Start

To use ToolRegistry Hub, first install the library:

```bash
pip install toolregistry-hub
```

Then, you can import and use the required tools:

```python
from toolregistry_hub import Calculator, DateTime, FileOps, FileSystem

# 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.

## Contributing

If you want to contribute to ToolRegistry Hub, please refer to the [GitHub repository](https://github.com/Oaklight/toolregistry-hub).
