tomevault-io Transcribe and Analyze
Local transcription of audio/video content using WhisperKit. Analysis is available on request using OpenAI or local Ollama.
Capabilities
- Transcription - Convert audio/video URLs to text using WhisperKit (runs locally, always available)
- Analysis - Extract insights from transcripts (only when user asks for it, supports OpenAI or Ollama)
Quick Start
Transcribe Only
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
Transcribe + Analyze (OpenAI)
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
python3 scripts/analyze_transcript.py whisper-transcriptions/video.md
Transcribe + Analyze (Local)
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
python3 scripts/analyze_transcript.py whisper-transcriptions/video.md --local
Transcription
Script Options
# Basic
python3 scripts/transcribe.py "URL"
# Custom output directory
python3 scripts/transcribe.py "URL" --output-dir "/path/to/save"
# Higher accuracy (slower)
python3 scripts/transcribe.py "URL" --model medium
# Without timestamps
python3 scripts/transcribe.py "URL" --no-timestamps
# Custom filename
python3 scripts/transcribe.py "URL" --filename "my-transcription.md"
Whisper Models
| Model | Speed | Accuracy | Use Case |
|---|---|---|---|
tiny |
Fastest | Lowest | Quick drafts, testing |
base |
Fast | Reasonable | Simple content |
small |
Balanced | Good | Default - most use cases |
medium |
Slower | High | Lectures, important content |
large |
Slowest | Highest | Critical accuracy needed |
Dependencies
- yt-dlp -
pip install yt-dlporbrew install yt-dlp - whisperkit-cli - https://github.com/argmaxinc/WhisperKit
Script checks for these and provides install instructions if missing.
Output
Transcriptions save to ./whisper-transcriptions/ as markdown:
# Transcription
**Source:** https://youtube.com/watch?v=example
**Transcribed:** 2025-01-15 14:30:00
**Tool:** WhisperKit
---
[00:00:00.000 --> 00:00:05.000] Welcome to this video...
Analysis
Provider Options
OpenAI API (default):
python3 scripts/analyze_transcript.py transcript.md
python3 scripts/analyze_transcript.py transcript.md --model gpt-4o
Requires OPENAI_API_KEY environment variable.
Local Ollama:
python3 scripts/analyze_transcript.py transcript.md --local
python3 scripts/analyze_transcript.py transcript.md --local --model mistral
Requires Ollama running (ollama serve).
Script Options
# Default comprehensive analysis (OpenAI)
python3 scripts/analyze_transcript.py transcript.md
# Use local Ollama
python3 scripts/analyze_transcript.py transcript.md --local
# Specify model
python3 scripts/analyze_transcript.py transcript.md --model gpt-4o
python3 scripts/analyze_transcript.py transcript.md --local --model llama3.2
# Custom analysis prompt
python3 scripts/analyze_transcript.py transcript.md --prompt "List all tools mentioned"
# Custom output location
python3 scripts/analyze_transcript.py transcript.md --output ~/Documents/analysis.md
# Print to stdout instead of saving
python3 scripts/analyze_transcript.py transcript.md --print
Default Analysis Includes
- Executive summary (2-3 paragraphs)
- Key insights (5-7 bullet points)
- Topics discussed with summaries
- Notable quotes (3-5 memorable quotes)
- Action items and recommendations
- Additional observations
Custom Prompt Examples
--prompt "List all technologies and tools mentioned"
--prompt "What are the main arguments presented?"
--prompt "Extract all statistics and data points"
--prompt "Summarize in 5 bullet points"
--prompt "What questions were asked and how were they answered?"
Dependencies
- openai -
pip install openai(used for both OpenAI and Ollama) - OPENAI_API_KEY environment variable (for OpenAI only)
- Ollama running locally (for --local mode)
Output
Analysis saves alongside transcript as transcript_name_analysis.md:
# Transcript Analysis
**Source Transcript:** path/to/transcript.md
**Analysis Model:** gpt-4o-mini (OpenAI)
**Tokens Used:** 33,763
---
[Analysis content]
Common Workflows
Full Pipeline: URL to Insights (Cloud)
python3 scripts/transcribe.py "https://youtube.com/watch?v=abc123"
python3 scripts/analyze_transcript.py whisper-transcriptions/watch.md
Full Pipeline: URL to Insights (Local)
python3 scripts/transcribe.py "https://youtube.com/watch?v=abc123"
python3 scripts/analyze_transcript.py whisper-transcriptions/watch.md --local
Multiple Analyses on Same Transcript
python3 scripts/analyze_transcript.py transcript.md --output summary.md
python3 scripts/analyze_transcript.py transcript.md --prompt "List action items" --output actions.md
python3 scripts/analyze_transcript.py transcript.md --prompt "Extract quotes" --output quotes.md
Batch Transcription
python3 scripts/transcribe.py "URL1"
python3 scripts/transcribe.py "URL2"
python3 scripts/transcribe.py "URL3"
Reference Files
Troubleshooting (references/troubleshooting.md)
- Download failures
- Transcription errors
- Dependency issues
- API errors
Configuration (references/configuration.md)
- Output format details
- File naming behavior
- Model selection guidance
Usage Patterns (references/usage-patterns.md)
- Common transcription scenarios
- Analysis patterns
- Batch processing tips
Scripts
| Script | Purpose |
|---|---|
scripts/transcribe.py |
Download and transcribe audio/video from URLs (WhisperKit) |
scripts/analyze_transcript.py |
AI analysis of transcript files (OpenAI or Ollama) |
Converted and distributed by TomeVault — claim your Tome and manage your conversions.