shortform-ai 0.1.4

Local-first CLI for short-form video and creator analysis

shortform-ai

Local-first CLI for short-form video and creator analysis.

Recommended install paths:

brew install shortform-ai
# or
pipx install shortform-ai

Optional local transcription is available with faster-whisper:

pipx inject shortform-ai "shortform-ai[local-transcribe]"
# or, inside a venv:
pip install "shortform-ai[local-transcribe]"

shortform-ai analyze defaults to --transcribe auto. It uses OpenAI transcription when OPENAI_API_KEY is configured; otherwise it uses local faster-whisper when the optional extra is installed. The default local model is base, which downloads a model cache on first use. Use --transcribe-model small for better local accuracy.

Analysis requires a real transcript. If neither OpenAI transcription nor local faster-whisper is available, analyze stops with setup instructions instead of producing a transcript-free strategy pass.

For one-prompt Codex workflows, use the bootstrap command after installing the package:

shortform-ai bootstrap analyze <instagram-url-or-file> --instagram-from-chrome

It installs/updates the Codex skill, optionally imports the user's own Chrome Instagram session, runs analysis, fetches Instagram comments when possible, and writes bootstrap.json beside the analysis artifacts.

For Instagram reel URLs with local Instagram auth configured, analysis also writes safe audio attribution metadata to media.json and reel.json, including named background music or original-audio title when Instagram exposes it.

Development usage from this monorepo:

PYTHONPATH=packages/content-ai-runtime python3 -m content_ai_runtime.cli doctor

The CLI reads a user's own local Instagram Chrome session only after an explicit shortform-ai auth instagram --from-chrome command. Session values are redacted from output and are stored in local secure storage when available.

content-ai remains available as a backwards-compatible command alias.