diff --git a/README.md b/README.md index 9a9eb03..6f16e04 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,7 @@ Examples: - `transform-remove-background-with-transloadit` - `transform-describe-image-with-transloadit` - `transform-convert-markdown-to-pdf-with-transloadit` +- `transform-transcribe-audio-with-transloadit` - `transform-build-polaroid-collage-with-transloadit` - `transform-build-mosaic-collage-with-transloadit` - `integrate-uppy-transloadit-s3-uploading-to-nextjs` diff --git a/skills/transform-transcribe-audio-with-transloadit/SKILL.md b/skills/transform-transcribe-audio-with-transloadit/SKILL.md new file mode 100644 index 0000000..2420628 --- /dev/null +++ b/skills/transform-transcribe-audio-with-transloadit/SKILL.md @@ -0,0 +1,64 @@ +--- +name: transform-transcribe-audio-with-transloadit +description: One-off transcription of local audio or video files to text or subtitle files using Transloadit via the official `@transloadit/node` CLI. Use when the user wants speech in local media converted to `.txt`, `.json`, `.srt`, or `.webvtt`; prefer the `speech transcribe` intent with Replicate while ElevenLabs Scribe is not ready. +--- + +# Transcribe Audio or Video with Transloadit + +## Use this for + +- Local audio or video files that should become text transcripts or subtitle files +- One or many files, with outputs downloaded locally +- Agent workflows where credentials may already be in the shell, a local `.env`, or + `~/.transloadit/credentials` + +## Inputs + +- Absolute path to one or more local audio or video files +- Optional output path; default is the same basename with `.txt` +- Optional format: `text`, `json`, `srt`, or `webvtt` + +## Workflow + +1. Confirm each input file exists and resolve it to an absolute path. +2. Derive the output path: + - Single input and no requested output: same directory and basename with `.txt` + - Multiple inputs and no requested output: a `transcripts/` directory next to the inputs + - Use `.json`, `.srt`, or `.webvtt` when the user asks for that format +3. Let the CLI resolve auth automatically in this order: + - Shell environment variables + - The current working directory `.env` only + - `~/.transloadit/credentials` + If your `.env` lives in a parent directory, export the variables into the shell first. +4. Run the transcription with the official CLI intent: + +```bash +npx -y @transloadit/node speech transcribe --input /ABS/PATH/input.opus --output /ABS/PATH/input.txt +``` + +For multiple files, repeat `--input` and write to an output directory: + +```bash +npx -y @transloadit/node speech transcribe \ + --input /ABS/PATH/a.opus \ + --input /ABS/PATH/b.opus \ + --output /ABS/PATH/transcripts/ +``` + +## Options + +- Default format: `text` +- Other formats: `--format json`, `--format srt`, `--format webvtt` +- Default provider: `replicate` until ElevenLabs Scribe is ready +- Supported explicit providers: `--provider aws`, `--provider gcp`, `--provider replicate` +- Do not use `--provider transloadit`; that internal Whisper route is work in progress +- Use `--source-language ` when the input language is known +- Use `--target-language ` when translation is requested + +## Notes + +- Prefer `@transloadit/node`; it is the official CLI route and exposes `speech transcribe`. +- If the command errors with a missing subcommand, update to a newer `@transloadit/node` release + that includes the speech transcription intent. +- Keep secrets local-only; never print `TRANSLOADIT_SECRET` or copy it into browser code. +- After transcription, confirm each expected output file exists and is non-empty. diff --git a/skills/transloadit/SKILL.md b/skills/transloadit/SKILL.md index c65d0ef..56074b5 100644 --- a/skills/transloadit/SKILL.md +++ b/skills/transloadit/SKILL.md @@ -16,8 +16,9 @@ Concrete entry points: 4. `transform-remove-background-with-transloadit` 5. `transform-describe-image-with-transloadit` 6. `transform-convert-markdown-to-pdf-with-transloadit` -7. `integrate-uppy-transloadit-s3-uploading-to-nextjs` -8. `integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs` +7. `transform-transcribe-audio-with-transloadit` +8. `integrate-uppy-transloadit-s3-uploading-to-nextjs` +9. `integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs` ## Install companion skills @@ -37,6 +38,7 @@ Replace `` with one of: `docs-transloadit-robots`, `transform-generate-image-with-transloadit`, `transform-encode-hls-video-with-transloadit`, `transform-remove-background-with-transloadit`, `transform-describe-image-with-transloadit`, `transform-convert-markdown-to-pdf-with-transloadit`, +`transform-transcribe-audio-with-transloadit`, `integrate-uppy-transloadit-s3-uploading-to-nextjs`, `integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs`.