shortform-ai 0.1.3

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 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.