Table of contents

• Creating Your Tools
  • Subclassing BaseTool
  • Utilizing the tool Decorator
• Contribution Guidelines
• Development Setup

Available Tools

cropioAI Tools provides a wide range of pre-built tools, including:

• File operations (FileWriterTool, FileReadTool)
• Web scraping (ScrapeWebsiteTool, SeleniumScrapingTool)
• Database interactions (PGSearchTool, MySQLSearchTool)
• API integrations (SerperApiTool, EXASearchTool)
• AI-powered tools (DallETool, VisionTool)
• And many more!

For a complete list and detailed documentation of each tool, please refer to the individual tool README files in the repository.

Creating Your Tools

Tools are always expect to return strings, as they are meant to be used by the agents to generate responses.

There are three ways to create tools for cropioAI agents:

• Subclassing BaseTool
• Using the tool decorator

Subclassing BaseTool

from cropioai.tools import BaseTool

class MyCustomTool(BaseTool):
    name: str = "Name of my tool"
    description: str = "Clear description for what this tool is useful for, you agent will need this information to use it."

    def _run(self, argument: str) -> str:
        # Implementation goes here
        pass

Define a new class inheriting from BaseTool, specifying name, description, and the _run method for operational logic.

Utilizing the tool Decorator

For a simpler approach, create a Tool object directly with the required attributes and a functional logic.

from cropioai.tools import BaseTool
@tool("Name of my tool")
def my_tool(question: str) -> str:
    """Clear description for what this tool is useful for, you agent will need this information to use it."""
    # Function logic here

The tool decorator simplifies the process, transforming functions into tools with minimal overhead.

Contribution Guidelines

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Please ensure your code adheres to our coding standards and includes appropriate tests.

Development Setup

Installing Dependencies:

uv sync

Activating Virtual Environment:

uv venv
source .venv/bin/activate

Setting Up Pre-commit Hooks:

pre-commit install

Running Tests:

uv run pytest

Static Type Checking:

uv run pyright

Packaging:

uv build

Local Installation:

pip install dist/*.tar.gz

Thank you for your interest in enhancing the capabilities of AI agents through advanced tooling. Your contributions make a significant impact.

Contact

For questions or support, please join our Discord community, Discourse or open an issue in this repository.