Trx

@crafter/trx

Agent-first CLI for audio/video transcription via [Whisper](https://github.com/ggml-org/whisper.cpp).

Downloads, cleans, and transcribes media from URLs or local files with machine-readable output designed for AI agents.

Install

# Run instantly, no install needed (requires Bun)
npx @crafter/trx@latest init

# Or install globally
bun add -g @crafter/trx
trx init

`trx init` installs `whisper-cli`, `yt-dlp`, and `ffmpeg`, downloads a Whisper model, and optionally installs the agent skill for your AI coding tool. It uses Homebrew on macOS, apt on Debian or Ubuntu, and a trx-managed binary directory on Windows.

Windows

Run these commands in PowerShell as the Windows user who will run trx:

powershell -c "irm bun.sh/install.ps1 | iex"
bun add --global @crafter/trx
trx init --yes --backend local --model small --language es
trx doctor --output json

The local backend keeps the media and transcript on the laptop. Windows stores Whisper, `ffmpeg`, `ffprobe`, and `yt-dlp` in `%USERPROFILE%\.trx\bin`. Setup prefers `winget` and falls back to checksum-verified portable downloads when App Installer is unavailable. `--yes` makes setup non-interactive for IT and CI. Company policy can still block Bun, GitHub, Hugging Face, or unsigned third-party software, so IT approval remains the final gate.

Large local videos are not uploaded. trx extracts a 16 kHz mono WAV and transcribes that locally. Keep enough free disk space for the source, the temporary WAV, the model, and the transcript outputs.

trx transcribe "C:\Users\me\Videos\meeting.mp4" --language es --output-dir "C:\Users\me\Documents\trx-output" --output json

Skill Only

If you already have trx set up and just want the agent skill:

npx skills add crafter-station/trx -g

Usage

# Transcribe a local file
trx recording.mp4

# Transcribe from URL (YouTube, Twitter, Instagram, etc.)
trx "https://youtube.com/watch?v=..."

# Agen