garf for Media Tagging

garf-media-tagging simplifies interaction with media_tagging library via SQL queries and can be used with garf framework.

Prerequisites

Installation

pip install garf-media-tagging

Usage

Run via CLI

Install garf-executors package to run queries via CLI (pip install garf-executors).

garf <PATH_TO_QUERIES> --source media-tagging \
  --output <OUTPUT_TYPE> \
  --source.endpoint=MEDIA_TAGGING_API_ENDPOINT_URL

where:

• PATH_TO_QUERIES - local or remove files containing queries
• output - output supported by garf-io library.
• SOURCE_PARAMETER=VALUE - key-value pairs to refine fetching, check available source parameters.

Available source parameters

Queries for Media Tagging API

SELECT
  media_url,
  content.tags[].name AS tags
FROM tag
WHERE
  media_type = 'image'
  AND tagger_type = 'gemini'
  AND media_path IN ({media})

Resources

• tag - identifies tags (pair name: score) uniquely defining media.
• description - custom description of media; usually fine-tuned via custom_prompt parameter.

Filters

• media_type - Required, one of: image, youtube_video, webpage, text, video.
• tagger_type - Tagger used to identify tags / descriptions.
• media_path - location of media.
• tagging_options - optional parameters to finetune tagging.
  • n_tags - number of tags to return.
  • tags - custom tags to find in the media.
  • custom_prompt - prompt to send to LLM.

Fields

You can extract one of the following elements from reach row of API response.

• media_type
• media_url
• identifier
• processed_at
• content
  • text for description
  • {name, score} for tag
• hash