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

# TwelveLabs Tools

> Demonstrates using TwelveLabs video understanding tools with an agent.

```python twelvelabs_tools.py theme={null}
"""
TwelveLabs Tools
=============================

Demonstrates using TwelveLabs video understanding tools with an agent.

`analyze_video` answers questions about a video using the Pegasus model.
`embed_text` generates a multimodal (Marengo) embedding that lives in the same
latent space as TwelveLabs video/audio/image embeddings.

Set your API key first: `export TWELVELABS_API_KEY=...`
Grab a free key at https://twelvelabs.io.

Install dependencies: `pip install twelvelabs`
"""

from agno.agent import Agent
from agno.tools.twelvelabs import TwelveLabsTools

# Example 1: Enable all tools
agent = Agent(
    tools=[TwelveLabsTools(all=True)],
    markdown=True,
)

agent.print_response(
    "What is happening in this video? https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
)

# Example 2: Enable only text embedding (useful for embedding search queries
# against a TwelveLabs video index)
embedding_agent = Agent(
    tools=[
        TwelveLabsTools(
            enable_analyze_video=False,
            enable_embed_text=True,
        )
    ],
    markdown=True,
)

embedding_agent.print_response(
    "Embed the text 'a cat playing piano' and tell me how many dimensions it has."
)
```

## Run the Example

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U agno twelvelabs
    ```
  </Step>

  <Step title="Export your API keys">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export TWELVELABS_API_KEY="your_twelvelabs_api_key_here"
      ```

      ```bash Windows theme={null}
      $Env:TWELVELABS_API_KEY="your_twelvelabs_api_key_here"
      ```
    </CodeGroup>
  </Step>

  <Step title="Run the example">
    Save the code above as `twelvelabs_tools.py`, then run:

    ```bash theme={null}
    python twelvelabs_tools.py
    ```
  </Step>
</Steps>

Full source: [cookbook/91\_tools/twelvelabs\_tools.py](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/twelvelabs_tools.py)