Skip to content

ClipMind v1.2.0 — universal local-first evidence extraction

Choose a tag to compare

@yy31104 yy31104 released this 04 Sep 15:59
· 113 commits to main since this release

Source release. ClipMind grows from a Douyin-only macOS tool into a
local-first video evidence layer with multiple sources, portable providers and
agent-native interfaces. The canonical path still requires no API key.

Sources

Verified built-in adapters for YouTube, Douyin and local files,
plus a clipmind.sources entry point so a third party can add one without
patching the core. A generic URL fallback runs after the built-ins on a
best-effort basis.

Complete or refuse

A low-cost preflight estimates visual states, OCR time and pack size before
any expensive work. Within budget it processes normally; over budget it stops
and reports actionable numbers. It never truncates a pack, never silently
lowers evidence resolution, and never emits something that looks complete but
is not. An explicit override processes the full source.

Portable providers

ASR and OCR sit behind protocols. Apple Silicon uses MLX Whisper and Apple
Vision; Linux and Windows use faster-whisper and Tesseract. Runtime settings
and providers are injected rather than fixed at import, so a job can carry its
own configuration.

Interfaces

Python SDK, REST resources, a full CLI and a stdio MCP server exposing six
tools over the same Evidence Packs — one source of truth, four ways in.

Extraction fidelity

Word-level timing, OCR layout boxes, scene and scroll grouping, stability
measurements, and optional pyannote diarization. All of it is measured and
derived; none of it decides canonical membership. Evidence Pack schema moves
to 1.3.0, additively — every v1 minor version still reads.

Quality gate

make eval audits existing packs offline. make eval-reextract runs real
sources through the current pipeline. Exact canonical counts can veto a change
only when the downloaded source SHA-256 matches the baseline, because the
same URL can return different bytes — a difference this project once mistook
for a code regression. Packs now record which dedupe algorithm chose their
canonical states, so a changed algorithm is distinguishable from changed bytes.

This gate rejected a perceptual-hashing change written for this release. That
change is not in this release.

Also

Browser uploads, local evidence search, productized Inbox/Library/detail views,
Python packaging, cross-platform CI, Docker, and a documented macOS app build
path.

Install

Not on PyPI. pip install from a checkout — see
docs/INSTALL.md.

No .dmg is attached. The macOS build path exists and is documented, but
it produces unsigned development artifacts; shipping one would make a
first-time user's first action be bypassing Gatekeeper. A public desktop
release needs signing, hardening and notarization first.

Full changelog: v1.1.0...v1.2.0