Voidscape

Turn media into evidence your agent can cite.

Voidscape reads video, audio, images, articles, and feeds through one visible sequence: inspect, preview, read.

Download Voidscape ↓ See what it can do → How it works ↗
local-firstaudio stays yours by default
cost-awarepreview before processing
agent-nativeframes + citations, not guesswork
// How it works

Inspect. Preview. Read.

One visible sequence turns an opaque source into evidence an agent can verify.

  1. 01Inspect

    See what the source contains.

  2. 02Preview

    Check cost, dependencies, and consent.

  3. 03Read

    Create local artifacts with citations.

See the complete five-command guide

See the cost before you press play.

Preview is a decision point, not a receipt. It exposes the frame plan, transcription path, cloud boundary, and model-download state before reading changes anything.

Pre-flight reportvoidscape preview

$ voidscape.py preview "clip.mp4" --tier both

source scanduration + captions
frame plancount + vision tokens
transcription pathlocal / cloud / download
consent staterequired if applicable
decisionvisible before read
Nothing is impliedGATEDAn API key in the environment is not consent. A cloud path or first model download must be approved explicitly.
// Use cases

See what becomes evidence.

One workflow, six useful outcomes. The reel pauses when you choose what to inspect.

Showing use case 1 of 6.

Video + audio

Turn a tutorial into a cited note.

Read the frames and transcript together, then keep the moments that support the answer.

Evidence: [MM:SS]
Auto
See complete capability status
Install / first read

Install once. Use it anywhere.

Get the global CLI and bundled agent skill without cloning the repository. No account, API key, or paid backend is required.

Before you start Open PowerShell on Windows or Terminal on macOS/Linux. Voidscape checks FFmpeg and FFprobe before media work.

  1. 01

    Install uv once.

    On Windows, paste this into PowerShell:

    $ winget install --id=astral-sh.uv -e
    macOS or Linux$ curl -LsSf https://astral.sh/uv/install.sh | sh

    Already have uv? Skip this step.

    FFmpeg or FFprobe missing?

    Windows: winget install --id=Gyan.FFmpeg -e. macOS: brew install ffmpeg. Debian/Ubuntu: sudo apt update && sudo apt install ffmpeg.

  2. 02

    Install Voidscape and its agent skill.

    One isolated CLI. One guided skill for Codex and shared agents.

    $ uv tool install https://github.com/RikepilB/void-scape/archive/refs/heads/main.zip
    $ uv tool update-shell
    $ voidscape init

    init installs the bundled agent skill and checks local tools. It never approves cloud processing or a model download. If the command is not recognized yet, open one new terminal.

    Choose an Inbox and Library (optional)$ voidscape customize
  3. 03

    Read your first file.

    Replace meeting.mp4 with a local image, audio file, video, folder, or supported public URL.

    $ voidscape doctor
    $ voidscape inspect "meeting.mp4"
    $ voidscape preview "meeting.mp4"
    $ voidscape read "meeting.mp4" --workdir voidscape-output
Then ask your agentThe evidence is now in voidscape-output. Open voidscape-output/manifest.json and transcript.txt, then inspect frames/. Summarize the recording in three bullets. Support every factual claim with an exact [MM:SS] citation. If the evidence is insufficient, say so.
Open the setup guide → View source ↗

Three things to know before the first read.

The full FAQ covers setup, evidence, sign-in boundaries, and troubleshooting.

Does Voidscape upload my media?

Not by default. Local reads stay on your machine. Cloud transcription and first model downloads each require a current, separate approval.

What does the agent receive?

Selected frames, ordered text or a transcript, and a manifest that maps every citation back to the source.

What can I read today?

Video, audio, images and local carousels, articles, RSS/Atom, supported public video URLs, and explicit on-demand screenshots or short clips.

Browse all questions

Detailed answers live off the conversion path.