SKILLbundledHermes Bundled Skills

Gif Search

Name: Gif Search
Author: Hermes Agent

Search/download GIFs from Tenor via curl + jq

GIFMediaSearchTenorAPIBundledHermes skill

Last registry verification2026-08-18v1.1.0Hermes Agent

Open original source ↗اقرأ بالعربية

Plain meaning

What does it add to Hermes?

Search/download GIFs from Tenor via curl + jq

Gif Search is a skill related to research and sources. It gives the agent a way to find external information and sources instead of relying only on model memory.

This plain-language explanation is based on the publisher description. The original text remains visible for verification.

Use it when

Use it when your goal in research and sources is clear and you can limit it to the data and actions it actually needs.

Skip it when

Do not add it merely to experiment when Hermes already has a simpler path, or when you cannot review its source and permissions.

Who is it for?

Best for users who want a repeatable way of working inside Hermes.

Safe first test

Ask for one recent fact with two sources, then open both links and verify dates and evidence.

Original publisher description

Search/download GIFs from Tenor via curl + jq

✓

Data source

This entry was indexed from Hermes Bundled Skills. Our explanation interprets the type and domain without inventing a capability not present upstream.

Security review

The source is official or editorially reviewed, but you still need to review permissions and version compatibility.

Safe setup path

Inspect, install, then test.

01
Open the source
Match the publisher, license, and description to your need. Check the real update history.
02
Review permissions and secrets
Never paste a secret value into this site. Use environment-variable names and grant the smallest scope.
03
Copy setup only after review
The controls below copy text. They do not execute commands on your device.
04
Test with a non-sensitive task
Inspect the visible tools, then exclude write or delete tools you do not need.

Setup method

Already installed with Hermes.

This skill ships with Hermes and loads when the agent decides it is relevant. There is nothing to install; read the definition below so you know what it will do.

Open the official page ↗

The full skill definition

Exactly what Hermes loads when this skill runs.

Reproduced from the official documentation. Read it before enabling the skill: this text becomes the agent's instructions.

Search/download GIFs from Tenor via curl + jq.

Skill metadata

A lookup table. Do not read it all; find the row that applies to you.

Source	Bundled (installed by default)
Path	`skills/media/gif-search`
Version	`1.1.0`
Author	Hermes Agent
License	MIT
Platforms	linux, macos, windows
Tags	`GIF`, `Media`, `Search`, `Tenor`, `API`

Reference: full SKILL.md

Explains the idea itself. Read it slowly; the later sections build on it.

Search and download GIFs directly via the Tenor API using curl. No extra tools needed.

When to use

Explains the idea itself. Read it slowly; the later sections build on it.

Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat.

Setup

Ordered, practical steps. Run one and confirm it worked before moving on.

Set your Tenor API key in your environment (add to ${HERMES_HOME:-~/.hermes}/.env):

Shell1 line

TENOR_API_KEY=your_key_here

Get a free API key at https://developers.google.com/tenor/guides/quickstart — the Google Cloud Console Tenor API key is free and has generous rate limits.

Prerequisites

Settings you configure once. Change one at a time so you can see what each does. Set TENOR_API_KEY in your environment, not in the chat.

curl and jq (both standard on macOS/Linux)
TENOR_API_KEY environment variable

Search for GIFs

Settings you configure once. Change one at a time so you can see what each does. Set TENOR_API_KEY in your environment, not in the chat.

Shell5 lines

# Search and get GIF URLs
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'

# Get smaller/preview versions
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'

Download a GIF

Settings you configure once. Change one at a time so you can see what each does. Set TENOR_API_KEY in your environment, not in the chat.

Shell3 lines

# Search and download the top result
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o celebration.gif

Get Full Metadata

Settings you configure once. Change one at a time so you can see what each does. Set TENOR_API_KEY in your environment, not in the chat.

Shell1 line

curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'

API Parameters

A lookup table. Do not read it all; find the row that applies to you.

Parameter	Description
`q`	Search query (URL-encode spaces as `+`)
`limit`	Max results (1-50, default 20)
`key`	API key (from `$TENOR_API_KEY` env var)
`media_filter`	Filter formats: `gif`, `tinygif`, `mp4`, `tinymp4`, `webm`
`contentfilter`	Safety: `off`, `low`, `medium`, `high`
`locale`	Language: `en_US`, `es`, `fr`, etc.

Available Media Formats

A lookup table. Do not read it all; find the row that applies to you.

Each result has multiple formats under .media_formats:

Format	Use case
`gif`	Full quality GIF
`tinygif`	Small preview GIF
`mp4`	Video version (smaller file size)
`tinymp4`	Small preview video
`webm`	WebM video
`nanogif`	Tiny thumbnail

Notes

Explains the idea itself. Read it slowly; the later sections build on it.

URL-encode the query: spaces as +, special chars as %XX
For sending in chat, tinygif URLs are lighter weight
GIF URLs can be used directly in markdown: ![alt](https://github.com/NousResearch/hermes-agent/blob/main/skills/media/gif-search/url)