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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

video2flow-0.3.2-cp313-cp313-win_amd64.whl (209.9 kB view details)

Uploaded CPython 3.13Windows x86-64

File details

Details for the file video2flow-0.3.2-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: video2flow-0.3.2-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 209.9 kB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for video2flow-0.3.2-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 e4de616518c481edf988b1b72dc0df50cd46e381a13ff2aecfea6328b991177c
MD5 b4ec21adfaf652aecda5ea40ef2cb03d
BLAKE2b-256 cdf5491140a161e16c2f5a60ca2194b1bc33010cbb9989c33c4446eff23ab06b

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.3.2 This release

1 file

0.3.1

1 file

0.3.0

1 file

0.2.0

2 files

0.1.0

2 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