analyze-video

VideoAnalysis is Momenta's installable video-understanding engine. It combines local Apple Silicon analysis with paid provider routes, using the same account, credit balance, usage ledger, and Stripe billing as VibeEdit.

Customer installation

Version 1.0.0 supports Apple Silicon Macs (darwin-arm64) with Node.js 20 or newer. The installer checks for Python 3.12, FFmpeg, and FFprobe, and can install missing prerequisites with Homebrew.

npm install -g analyze-video
analyze-video install

The second command creates a private Python environment, installs pinned dependencies, downloads the versioned models, verifies every download by SHA-256, and records the active runtime under ~/Library/Application Support/VideoAnalysis.

Create or sign in to the shared Momenta account at video-analysis-theta.vercel.app/account. Create a revocable package API key there, then connect the CLI:

analyze-video login
analyze-video doctor
analyze-video analyze --video /absolute/path/to/video.mp4 --mode fast

The API key is stored with owner-only permissions in the user's platform config directory. The database stores only its HMAC digest. The CLI exchanges it for a short-lived Supabase session; Stripe and provider secrets never ship in the package.

Data and billing

• Source footage and analysis artifacts stay in the workspace selected by the customer.
• Accounts, subscriptions, credit grants, reservations, usage, and refunds use the shared VibeEdit Supabase project.
• Checkout and the billing portal are hosted by Stripe.
• Paid provider requests are authorized server-side and recorded against the shared credit ledger.
• Package keys can be listed and revoked from the web account.

Development

bun install
bun run verify
bun run verify:web
bun run build:release

verify type-checks the source, runs the complete V3 test suite, verifies the local runtime and model hashes, checks Python imports, and builds the library and CLI. build:release creates the website archive in web/downloads.

The default export provides portable domain, headless, and client contracts. The standalone entrypoint is analyze-video/standalone.

import {
  createStandaloneRunAnalysisV3Controller,
  registerStandaloneRunAnalysisV3Media,
} from "analyze-video/standalone"

Distribution and licensing

The package remains UNLICENSED; public installation does not grant rights to proprietary source or models. The production runtime contains separately licensed third-party components. In particular, adapted Ultralytics runtime source is accompanied by its AGPL-3.0 text and provenance record in resources/production-analysis-runtime.

Do not describe this package as open source or change its license without a deliberate legal review of the proprietary models, model training-data terms, and all third-party components.

Independence

This repository is an independent copy of the VideoAnalysis implementation. It does not import source files from the VibeEdit repository. The two products share commercial infrastructure only through authenticated server APIs and the shared database schema.