Tools Sources

Configure tool sources for templates

Code Usage

from praisonai.templates.tool_override import create_tool_registry_with_overrides

# Create registry with tools_sources
registry = create_tool_registry_with_overrides(
    tools_sources=["praisonai_tools.video"],
    include_defaults=True,
)

print(f"Loaded {len(registry)} tools")

# Multiple sources
registry = create_tool_registry_with_overrides(
    tools_sources=[
        "praisonai_tools.video",
        "./local_tools.py",
        "./tools_dir/",
    ],
    template_dir="./my-template",
    include_defaults=True,
)

TEMPLATE.yaml Configuration

name: my-template
version: "1.0.0"

requires:
  tools: [shell_tool]
  tools_sources:
    - praisonai_tools.video
    - ./local_tools.py

Resolution Order

1. CLI --tools files (highest priority)
2. CLI --tools-dir directories
3. CLI --tools-source overrides
4. Template tools_sources (from TEMPLATE.yaml)
5. Template-local tools.py
6. Default dirs (~/.praisonai/tools)
7. Package discovery (praisonai_tools)
8. Built-in tools (lowest priority)