AssemblyAI Audio Transcriber

Reusable transcription utilities with optional YouTube audio download.

Requirements

• Python 3.10+
• AssemblyAI API key (ASSEMBLYAI_API_KEY)
• Optional: yt-dlp (only needed for YouTube downloads)

Install

pip install -e .

With YouTube download support:

pip install -e ".[youtube]"

Quickstart (CLI)

export ASSEMBLYAI_API_KEY=your_key_here
assemblyai-transcriber --audio-path /path/to/audio.mp3

CLI Usage

Transcribe a local audio file:

assemblyai-transcriber --audio-path /path/to/audio.mp3

Transcribe a remote audio URL:

assemblyai-transcriber --audio-url https://example.com/audio.mp3

Download YouTube audio and transcribe it:

assemblyai-transcriber --youtube https://www.youtube.com/watch?v=VIDEO_ID

--youtube accepts full YouTube URLs or a raw video ID.

Library Usage

from pathlib import Path
from transcription_pipeline import transcribe_audio

text = transcribe_audio(audio_path=Path("/path/to/audio.mp3"))
print(text)

Transcribe from YouTube:

from transcription_pipeline import transcribe_audio

text = transcribe_audio(youtube="https://youtu.be/VIDEO_ID")
print(text)

Tests

Run tests:

pytest

Quality Checks

Install dev dependencies:

pip install -e ".[dev]"

Run lint and tests:

ruff check .
ruff format --check .
pytest

Pre-commit

pip install pre-commit
pre-commit install

Changelog

See CHANGELOG.md.

Versioning

See VERSIONING.md.

Releases

Tag releases as vX.Y.Z to trigger the GitHub Actions release workflow.