Skip to main content

video2flow

Extract video frames as descriptive text flows for LLM consumption.

Claude, GPT-4o, Gemini and other multimodal models can see images but not video. video2flow bridges the gap: extract frames → generate timestamped descriptions → feed the text flow to any LLM.

Installation

pip install video2flow

Usage

# Extract frames from a video
video2flow extract video.mp4 -o frames/ --fps 1

# Quick description (without vision API)
video2flow describe video.mp4 --max-frames 10

# Full pipeline
video2flow pipeline video.mp4 -o video_flow/

LLM Integration

Pass the output JSON to any LLM:

import json
flow = json.loads(open("video_flow/flow.json").read())
prompt = flow["usage"]["example_prompt"]
# Then: response = llm.invoke(prompt)

For detailed vision understanding, send image files directly to a multimodal model alongside the flow transcript.

License

MIT

Metadata

Release files for video2flow 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for video2flow 0.3.2
File Interpreter ABI Platform
video2flow-0.3.2-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details

Release files / video2flow-0.3.2-cp313-cp313-win_amd64.whl

Download URL video2flow-0.3.2-cp313-cp313-win_amd64.whl
Size 209.9 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
e4de616518c481edf988b1b72dc0df50cd46e381a13ff2aecfea6328b991177c
BLAKE2b-256 checksum
How to use checksums
cdf5491140a161e16c2f5a60ca2194b1bc33010cbb9989c33c4446eff23ab06b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

0.3.2 This release

1 release file

0.3.1

1 release file

0.3.0

1 release file

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page