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

# Giphy

> GiphyTools enable an Agent to search and retrieve GIFs from GIPHY.

**GiphyTools** enables an Agent to search for GIFs on GIPHY.

## Prerequisites

You need to install the `openai` library.

```shell theme={null}
uv pip install openai
```

```shell theme={null}
export GIPHY_API_KEY=***
```

## Example

The following agent will search GIPHY for a GIF appropriate for a birthday message.

```python theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.giphy import GiphyTools

gif_agent = Agent(
    name="Gif Generator Agent",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[GiphyTools()],
    description="You are an AI agent that can generate gifs using Giphy.",
)

gif_agent.print_response("I want a gif to send to a friend for their birthday.")
```

## Toolkit Params

| Parameter | Type | Default | Description |
| - | - | - | - |
| `api_key` | `str` | `None` | If you want to manually supply the GIPHY API key. |
| `limit` | `int` | `1` | The number of GIFs to return in a search. |
| `enable_search_gifs` | `bool` | `True` | Enable the search\_gifs functionality. |
| `all` | `bool` | `False` | Enable all functionality. |

## Toolkit Functions

| Function | Description |
| - | - |
| `search_gifs` | Searches GIPHY for a GIF based on the query string. |

## Developer Resources

* [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/giphy.py)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.