- Category
- AI Tools
- Rank
- No. 761Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- bytedance
- GitHub
- 654 stars
- Date
About
Family of large multimodal models from ByteDance for video understanding and editing tasks.
What it does
Vidi turns uploaded video into searchable, structured material. A text request can locate matching clips, draw boxes around requested objects, answer questions, or trigger a reasoning mode. It can also produce titled chapters and highlights without a query. A separate editing demo accepts several videos and generates a combined cut with a storyline, music, and effects.
Why it's ranked here
The project pairs usable model code with unusually broad evaluation tooling. It covers temporal retrieval, object grounding across time, plot reasoning, character tracking, and question answering. The strongest practical evidence is the released benchmark data, evaluators, model weights, inference code, and finetuning support. However, the repository presents a research workflow more clearly than a production integration surface.
What's good
The evaluation support goes beyond a single headline metric. Temporal retrieval reports overlap, precision, and recall across query length, video duration, and audio or visual dependence. Spatial grounding measures both frame presence and bounding-box volume over time. Plot evaluation separately covers exact-answer questions and character segments, including transcript error and box overlap. This makes model comparisons inspectable instead of opaque.
Tradeoffs
The hosted demo recommends English queries, modest video resolution, and patience because long videos can take several minutes. Local inference expects CUDA, half-precision tensors, Flash Attention, FFmpeg, and FFprobe, so setup is not lightweight. The published model inference centers on temporal retrieval, while the wider demo capabilities are not all exposed through an equivalent documented local interface. One evaluation path can enter an interactive debugger after malformed results.
How to use it well
Vidi fits researchers and video teams testing search, grounding, chaptering, highlights, question answering, or automatic rough cuts. Start with the hosted demo to validate a task, then use the released weights and command-line evaluators for repeatable experiments. Keep videos moderate in resolution and format predictions exactly as documented. It does not supply a documented production API, managed deployment layer, or lightweight CPU workflow.
Technical notes+
Vidi_7B/inference.py samples video frames, extracts audio, builds a multimodal prompt, runs generation on CUDA in half precision, and converts percentage ranges into timestamps using FFprobe duration. Vidi_7B/model/builder.py loads pretrained weights through Transformers, defaults to Flash Attention 2, and supports optional 8-bit or 4-bit loading. VUE_STG/tube.py normalizes boxes, quantizes timestamps, and loads tube data from CSV. VUE_STG/evaluate.py computes temporal and volumetric IoU, recall, and precision, although compare_tubes defaults to using the first box per frame rather than unioning multiple boxes. VUE_TR_V2/qa_eval.py contains a bare exception path that invokes pdb.set_trace(), which can halt unattended evaluation.
Observed
- Primary language
- Python
- Interfaces
- Hosted web demo plus command-line inference and evaluation scripts
- Model distribution
- Vidi-7B and Vidi1.5-9B weights are linked through Hugging Face
- Local inference requirements
- CUDA execution, half-precision tensors, FFmpeg, and FFprobe
- Evaluation coverage
- Temporal retrieval, spatio-temporal grounding, plot reasoning, character evaluation, and video question answering
- Data formats
- Evaluation inputs and outputs use CSV, JSON, and JSONL structures
Read from README.md, VUE_STG/tube.py, VUE_TR/qa_eval.py, VUE_STG/evaluate.py, VUE_PLOT/vqa_eval.py, VUE_TR_V2/qa_eval.py, Vidi_7B/inference.py, VUE_PLOT/character_eval.py, Vidi1.5_9B/vidi/utils.py, Vidi_7B/model/builder.py, Vidi_7B/model/__init__.py, Vidi_7B/model/constants.py, Vidi_7B/model/img_utils.py, Vidi_7B/model/txt_utils.py, Vidi_7B/model/vid_utils.py.
What it can do
Analyze video content and generate descriptions
Video file → Text descriptions of video content
Extract and identify objects in video frames
Video file → Object detection results and labels
Generate video summaries
Video file → Condensed summary of video content
Answer questions about video content
Video file and text questions → Text answers about video details
Track movements and actions across video timeline
Video file → Temporal analysis of actions and movements
Edit video based on natural language instructions
Video file and text editing commands → Modified video file
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.
