binquery

    1

    Local CLI for splitting long videos and querying footage folders using OpenCLIP visual intent.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+22 more

    binquery

    Example session with this skill installed

    I have a long recording of a city walk in ./raw/walk.mp4. Split it into 10-second clips, index them, and find shots of 'people crossing the street'.

    • Read your context and instructions
    • Compiled the binquery

    I have processed the video file, created the index, and queried for your specific intent. The long recording was split into segments, and the local index has been verified.

    Clip Shortlist: 'people crossing the street'

    PathScoreGateReasons
    ./split-out/walk_005.mp40.82pictorialHigh visual match for crowd movement at intersection.
    ./split-out/walk_012.mp40.79pictorialMatches urban crossing environment.
    ./split-out/walk_008.mp40.75person_clipMultiple subjects detected in motion across frame.
    ./split-out/walk_021.mp40.71pictorialDistant view of pedestrian crossing.
    ./split-out/walk_003.mp40.68pictorialStreet level view with active foot traffic.
    ./split-out/walk_015.mp40.65motion_labelHandheld movement following subjects across street.
    ./split-out/walk_009.mp40.62pictorialFrame includes crosswalk markings and pedestrians.
    ./split-out/walk_022.mp40.59pictorialNear-miss; shows street traffic with some pedestrians.

    Next steps

    • Review the clips in ./split-out/ to confirm the best takes for your edit.
    • Run binquery list to see if any frozen director intents match your next scene.
    • Use binquery query with a different intent sentence to find specific lighting or angles.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Searching through hours of raw footage for a specific shot or breaking a long recording into manageable chunks is a manual bottleneck for editors. binquery automates the local clip management workflow by providing a CLI-based shortlist generator that ranks footage based on your visual intent.

    What it does

    • Time-grid splitting breaks one long local video file into segments using ffmpeg.
    • Local indexing generates CLIP vectors for a folder of videos without using cloud APIs.
    • Intent-based querying ranks 8–15 clips based on a single descriptive sentence.
    • Health monitoring verifies index integrity with a doctor command to prevent failed queries.
    • Multi-modal scoring provides results with a path, score, gate type, and logic-based reasons.

    How it works

    1. split: Run the command on a long recording to generate a folder of segments based on a time grid.
    2. index: Process the clip folder to create local vector embeddings and metadata.
    3. doctor: Verify the generated index files to ensure the query engine has the required data.
    4. query: Input a visual description to receive a ranked shortlist of local video paths.

    Frameworks & tools

    This tool requires Python 3.10+, ffmpeg, and ffprobe on the system PATH. It uses OpenCLIP (ViT-B-32) for local embedding generation.

    Why this beats prompting it yourself

    Writing a custom script to bridge ffmpeg and OpenCLIP requires significant boilerplate for frame extraction and vector management. This skill provides a structured CLI that handles the grid-splitting, local caching, and scoring logic out of the box.

    Use cases

    • Generate a shortlist of potential reaction shots from a streamer's VOD.
    • Find specific visual scenes within a large folder of dailies or rushes.
    • Break down a long master file into a grid for faster manual review.
    • Organize scene-sequence visual intents during a complex edit.

    Known limitations

    Does not perform highlight detection, silence cutting, or automatic timeline assembly. Requires local disk space for the index and an initial download for CLIP weights.

    How to use

    Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scanned

    Verified clean 9 days ago

    • Free to download with an account

    Requires

    Python

    Listed9 days ago

    What's inside

    Frequently Asked Questions