Skip to main content

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 (~/.praison/tools)
  7. Package discovery (praisonai_tools)
  8. Built-in tools (lowest priority)