> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools Sources

> Configure tool sources for templates

## Code Usage

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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")
```

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# 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

```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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)
