Metadata-Version: 2.4
Name: toolregistry-hub
Version: 0.7.0
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: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
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
Requires-Dist: beautifulsoup4>=4.13.4
Requires-Dist: pydantic<3.0.0,>=2.7.2
Provides-Extra: dev
Requires-Dist: ty>=0.0.21; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: python-dotenv>=1.0.1; 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-core
Requires-Dist: toolregistry-server>=0.1.1; extra == "server-core"
Provides-Extra: server-openapi
Requires-Dist: toolregistry-hub[server_core]; extra == "server-openapi"
Requires-Dist: toolregistry-server[openapi]>=0.1.1; extra == "server-openapi"
Provides-Extra: server-mcp
Requires-Dist: toolregistry-hub[server_core]; extra == "server-mcp"
Requires-Dist: toolregistry-server[mcp]>=0.1.1; extra == "server-mcp"
Provides-Extra: server
Requires-Dist: toolregistry-hub[server_openapi]; extra == "server"
Requires-Dist: toolregistry-hub[server_mcp]; extra == "server"
Dynamic: license-file

# ToolRegistry Hub Documentation

[![PyPI version](https://img.shields.io/pypi/v/toolregistry-hub?color=green)](https://pypi.org/project/toolregistry-hub/)
[![Docker Image](https://img.shields.io/docker/v/oaklight/toolregistry-hub-server?label=docker&color=green)](https://hub.docker.com/r/oaklight/toolregistry-hub-server)
[![CI](https://github.com/Oaklight/toolregistry-hub/actions/workflows/ci.yml/badge.svg)](https://github.com/Oaklight/toolregistry-hub/actions/workflows/ci.yml)
[![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).
