Overview

The Tool Repository is a package manager for CrewAI tools. It allows users to publish, install, and manage tools that integrate with CrewAI crews and flows. Tools can be:
  • Private: accessible only within your organization (default)
  • Public: accessible to all CrewAI users if published with the --public flag
The repository is not a version control system. Use Git to track code changes and enable collaboration.

Prerequisites

Before using the Tool Repository, ensure you have:

Installing Tools

To install a tool:
crewai tool install <tool-name>
This installs the tool and adds it to pyproject.toml. You can use the tool by importing it and adding it to your agents:
from your_tool.tool import YourTool

custom_tool = YourTool()

researcher = Agent(
    role='Market Research Analyst',
    goal='Provide up-to-date market analysis of the AI industry',
    backstory='An expert analyst with a keen eye for market trends.',
    tools=[custom_tool],
    verbose=True
)

Creating and Publishing Tools

To create a new tool project:
crewai tool create <tool-name>
This generates a scaffolded tool project locally. After making changes, initialize a Git repository and commit the code:
git init
git add .
git commit -m "Initial version"
To publish the tool:
crewai tool publish
By default, tools are published as private. To make a tool public:
crewai tool publish --public
For more details on how to build tools, see Creating your own tools.

Updating Tools

To update a published tool:
  1. Modify the tool locally
  2. Update the version in pyproject.toml (e.g., from 0.1.0 to 0.1.1)
  3. Commit the changes and publish
git commit -m "Update version to 0.1.1"
crewai tool publish

Deleting Tools

To delete a tool:
  1. Go to CrewAI Enterprise
  2. Navigate to Tools
  3. Select the tool
  4. Click Delete
Deletion is permanent. Deleted tools cannot be restored or re-installed.

Security Checks

Every published version undergoes automated security checks, and are only available to install after they pass. You can check the security check status of a tool at: CrewAI Enterprise > Tools > Your Tool > Versions

Need Help?

Contact our support team for assistance with API integration or troubleshooting.