Back to Details

pi-tube

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Pi-Tube CLI

Pi-Tube CLI

Deterministic transcription CLI focused on agent-friendly output contracts.
Run 
pi-tube --help
for current command details.
专为适配Agent友好的输出契约设计的确定性转录CLI工具。
运行 
pi-tube --help
可查看当前命令的详细说明。

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.
  • pi-tube
    已加入系统PATH环境变量。
  • 已通过
    pi-tube config
    命令或环境变量配置好服务提供商凭证。
如果尚未安装，请参考rules/install.md。 关于输出安全和非可信内容的处理，请参考rules/security.md。

Quick Checks

快速检查

bash
pi-tube --version
pi-tube provider-status
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
  1. 配置默认项和凭证引用：
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. 执行转录：
bash
pi-tube "https://youtube.com/watch?v=dQw4w9WgXcQ"
pi-tube --provider groq --language pt --json "./recording.mp3"
  1. 查看输出：
  • 默认：确定性Markdown产物
  • --json
    ：符合版本化Schema的确定性JSON契约

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
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
    .
  • 优先级：CLI参数 > 配置默认值 > 环境变量默认值。
  • Instagram私密/需认证的链接会返回
    INSTAGRAM_AUTH_REQUIRED
    错误。
  • 发布前质量门禁检查请运行
    bun test
    和
    bun run verify:fixtures
    。