pi-tube

Original：🇺🇸 English
Translated

Official pi-tube CLI skill for deterministic media transcription workflows. USE FOR: - YouTube/Instagram/direct URL/local file transcription via CLI - Deterministic Markdown/JSON artifact generation - Provider readiness and configuration flows Must be pre-installed. See rules/install.md for installation and setup, and rules/security.md for output handling.

3installs
Sourcelag0/pi-tube
Added on

NPX Install

npx skill4agent add lag0/pi-tube pi-tube

Tags

Translated version includes tags in frontmatter
cli-toolmedia-transcriptiontranscription-workflowmarkdown-generationjson-generation

SKILL.md Content

View Translation Comparison →

Pi-Tube CLI

Deterministic transcription CLI focused on agent-friendly output contracts.
Run 
pi-tube --help
for current command details.

Prerequisites

  • pi-tube
    available in PATH.
  • Provider credentials configured with 
    pi-tube config
    or env variables.
If not installed, follow rules/install.md. For output safety and untrusted content handling, follow rules/security.md.

Quick Checks

bash
pi-tube --version
pi-tube provider-status

Typical Workflow

  1. Configure defaults and credential references:
bash
pi-tube config set defaults.provider deepgram
pi-tube config set providers.deepgram.api_key_env DEEPGRAM_API_KEY
pi-tube config list
  1. Run transcription:
bash
pi-tube "https://youtube.com/watch?v=dQw4w9WgXcQ"
pi-tube --provider groq --language pt --json "./recording.mp3"
  1. Inspect output:
  • Default: deterministic markdown artifact
  • --json
    : deterministic schema-versioned JSON contract

Key Commands

bash
pi-tube <input>
pi-tube --json <input>
pi-tube config set <key> <value>
pi-tube config get <key>
pi-tube config list
pi-tube provider-status

Notes

  • Precedence: CLI flags > config defaults > env defaults.
  • Instagram private/auth-gated URLs fail with 
    INSTAGRAM_AUTH_REQUIRED
    .
  • For release quality gates, run 
    bun test
    and 
    bun run verify:fixtures
    .