Understand and extract insights from video content
CAMEL toolkit for video understanding via TwelveLabs' Pegasus model, reasoning natively over video from just a URL.
Maintainer of this project? Claim this page to edit the listing.
0.2.90Add to Favorites
Why it matters
Enable agents to analyze video content by reasoning over visuals, motion, and audio using TwelveLabs' Pegasus model. This allows multi-agent systems to answer questions, summarize, and extract information from videos without manual frame sampling.
Outcomes
What it gets done
Answer natural language questions about video content using only a URL
Summarize video narratives including visual and audio elements
Extract structured information from video scenes and dialogue
Analyze video motion, visuals, and audio in a unified understanding
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/camel-twelvelabstoolkit | bash Overview
Twelve Labs Toolkit
A CAMEL toolkit wrapping TwelveLabs' Pegasus video-language model, letting an agent reason natively over a video's visuals, motion, and audio from just its URL. Use it in multi-agent workflows where one agent needs to ground its reasoning in actual video content rather than text descriptions of it.
What it does
TwelveLabsToolkit is a CAMEL toolkit for video understanding powered by TwelveLabs' Pegasus video-language model. Unlike frame-sampling approaches, Pegasus reasons natively over the video - visuals, motion, and audio together - letting an agent answer questions about, summarize, or extract information from a video given only its URL.
When to use - and when NOT to
Use it in multi-agent tasks where one agent needs to ground its reasoning in actual video content - answering questions about a video, summarizing it, or extracting specific information - without needing to sample and analyze individual frames itself.
Inputs and outputs
Configuration parameters: api_key (optional, read from the TWELVELABS_API_KEY environment variable if not passed directly), model_name (defaults to pegasus1.5), max_tokens (defaults to 2048, capping response length), and timeout (optional, no timeout applied if unset). A free API key with a generous free tier is available at twelvelabs.io.
Integrations
Integrates as a CAMEL agent toolkit, taking a video URL as input and returning Pegasus's native multimodal analysis (visual, motion, and audio reasoning combined) rather than a frame-by-frame summary assembled after the fact.
Who it's for
Multi-agent system builders who need an agent to reason directly about video content - answering, summarizing, or extracting facts from a video by URL - without building a separate video-processing pipeline.
Source code
A toolkit for video understanding powered by TwelveLabs' Pegasus
video-language model.
Unlike frame-sampling approaches, Pegasus reasons natively over the video
(visuals, motion, and audio), which lets an agent answer questions about,
summarize, or extract information from a video given only its URL. This is
useful in multi-agent tasks where one agent needs to ground its reasoning
in video content.
Get a free API key at https://twelvelabs.io (generous free tier).
Args:
api_key (Optional[str], optional): The TwelveLabs API key. If not
provided, it is read from the :obj:TWELVELABS_API_KEY
environment variable. (default: :obj:None)
model_name (str, optional): The Pegasus model to use for analysis.
(default: :obj:"pegasus1.5")
max_tokens (int, optional): The maximum number of tokens to generate
in a response. (default: :obj:2048)
timeout (Optional[float], optional): The timeout value for API
requests in seconds. If :obj:None, no timeout is applied.
(default: :obj:None)
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.