Transcript2Word / app.py
Rajor78's picture
Create app.py
69b32e0 verified
raw
history blame
25.7 kB
import os
import subprocess
import time
import json
import argparse
from pathlib import Path
import numpy as np
import torch
import pandas as pd
import matplotlib.pyplot as plt
import re
from docx import Document
from docx.shared import RGBColor, Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH
from langdetect import detect
# Import Hugging Face components
from transformers import WhisperProcessor, WhisperForConditionalGeneration, pipeline
from pyannote.audio import Pipeline
from datasets import Dataset
# Constants
SPACY_MODELS = {
'es': 'es_core_news_sm', # Spanish
'en': 'en_core_web_sm', # English
'fr': 'fr_core_news_sm', # French
'it': 'it_core_news_sm', # Italian
'de': 'de_core_news_sm', # German
'pt': 'pt_core_news_sm', # Portuguese
'nl': 'nl_core_news_sm', # Dutch
'ca': 'ca_core_news_sm', # Catalan
}
# Function to load Spacy model based on language
def load_spacy_model(language):
import spacy
from spacy.cli import download as spacy_download
model_name = SPACY_MODELS.get(language, 'es_core_news_sm')
try:
print(f"Attempting to load Spacy model for language: {language} ({model_name})...")
nlp = spacy.load(model_name)
return nlp
except OSError:
print(f"Model {model_name} not found. Installing...")
spacy_download(model_name)
nlp = spacy.load(model_name)
return nlp
except Exception as e:
print(f"Could not load Spacy model for language {language}: {str(e)}")
print("Trying to load default English model...")
try:
spacy_download('en_core_web_sm')
return spacy.load('en_core_web_sm')
except Exception as e2:
print(f"Could not load English model either: {str(e2)}")
print("Using a minimal model...")
return spacy.blank('en')
# Function to extract audio from a video
def extract_audio(video_path, audio_path):
try:
command = f"ffmpeg -i '{video_path}' -ar 16000 -ac 1 -c:a pcm_s16le '{audio_path}' -y"
subprocess.run(command, shell=True, check=True)
print(f"Audio extracted and saved to: {audio_path}")
return True
except subprocess.CalledProcessError as e:
print(f"Error extracting audio: {e}")
return False
# Function to detect language of the audio
def detect_language(transcribed_text):
try:
language = detect(transcribed_text)
print(f"Detected language: {language}")
return language
except Exception as e:
print(f"Error detecting language: {e}")
return "es" # Spanish by default
# Function to perform speaker diarization with pyannote.audio
def diarize_speakers(audio_path, huggingface_token=None):
try:
print("Initializing speaker diarization...")
# Use pyannote.audio for diarization
use_auth = True if huggingface_token else False
# If Hugging Face token is provided, use it
if huggingface_token:
diarization_pipeline = Pipeline.from_pretrained(
"pyannote/speaker-diarization-3.1",
use_auth_token=huggingface_token
)
else:
# Try to load without token (will only work if license has been accepted)
try:
diarization_pipeline = Pipeline.from_pretrained(
"pyannote/speaker-diarization-3.1",
use_auth_token=False
)
except Exception as e:
print(f"Error loading diarization model without token: {e}")
print("It's recommended to create a Hugging Face account, accept the model license, and provide a token.")
return {}
print("Running diarization...")
diarization = diarization_pipeline(audio_path)
# Store speaker information and turns
speakers = {}
for turn, _, speaker in diarization.itertracks(yield_label=True):
if speaker not in speakers:
speakers[speaker] = []
speakers[speaker].append({
'start': turn.start,
'end': turn.end
})
# Rename speakers to be more user-friendly
renamed_speakers = {}
for i, (speaker, turns) in enumerate(speakers.items(), 1):
renamed_speakers[f"Speaker {i}"] = turns
print(f"Diarization completed. {len(renamed_speakers)} speakers identified.")
return renamed_speakers
except Exception as e:
print(f"Error in speaker diarization: {e}")
print("Continuing without diarization...")
return {}
# Function to transcribe audio with Whisper and get timestamps
def transcribe_audio_with_timing(audio_path, model_name="openai/whisper-base", language=None):
try:
print(f"Loading Whisper model ({model_name})...")
# Use Transformers pipeline for transcription
transcription_pipeline = pipeline(
"automatic-speech-recognition",
model=model_name,
chunk_length_s=30,
device=0 if torch.cuda.is_available() else -1,
return_timestamps="word"
)
print("Transcribing audio with timestamps...")
# If language is provided, use it; otherwise, let Whisper detect it
if language:
result = transcription_pipeline(audio_path, language=language)
else:
result = transcription_pipeline(audio_path)
# Process the result to match the expected format
transcribed_text = result.get("text", "")
# Create segments from chunks with timestamps
segments = []
chunk_words = result.get("chunks", [])
# Group words into sentences/segments
current_segment = {
"start": 0,
"end": 0,
"text": "",
"words": []
}
for word_data in chunk_words:
word = word_data.get("text", "")
start_time = word_data.get("timestamp", (0, 0))[0]
end_time = word_data.get("timestamp", (0, 0))[1]
# Initialize first segment
if not current_segment["text"]:
current_segment["start"] = start_time
current_segment["text"] += " " + word
current_segment["words"].append(word_data)
current_segment["end"] = end_time
# Start a new segment at sentence end
if word.endswith((".", "!", "?")):
segments.append(current_segment)
current_segment = {
"start": end_time,
"end": end_time,
"text": "",
"words": []
}
# Add the last segment if not empty
if current_segment["text"]:
segments.append(current_segment)
detected_language = result.get("language", "unknown")
print(f"Transcription completed in language: {detected_language}")
return transcribed_text, segments, detected_language
except Exception as e:
print(f"Error in transcription: {e}")
return "", [], "unknown"
# Function to assign speakers to transcribed segments
def assign_speakers_to_segments(segments, speakers):
if not speakers:
# If no speaker information, assign "Unknown Speaker" to all segments
for segment in segments:
segment['speaker'] = "Unknown Speaker"
return segments
for segment in segments:
start_time = segment['start']
end_time = segment['end']
# Find the speaker with the most overlap for this segment
best_speaker = None
max_overlap = 0
for speaker, turns in speakers.items():
for turn in turns:
turn_start = turn['start']
turn_end = turn['end']
# Calculate overlap time
overlap_start = max(start_time, turn_start)
overlap_end = min(end_time, turn_end)
overlap = max(0, overlap_end - overlap_start)
if overlap > max_overlap:
max_overlap = overlap
best_speaker = speaker
# Assign the best speaker found or "Unknown" if no match
segment['speaker'] = best_speaker if best_speaker else "Unknown Speaker"
return segments
# Function to extract speaker information (how much each one speaks)
def analyze_speaker_stats(segments):
speaker_stats = {}
total_duration = 0
for segment in segments:
speaker = segment.get('speaker', 'Unknown Speaker')
duration = segment['end'] - segment['start']
total_duration += duration
if speaker not in speaker_stats:
speaker_stats[speaker] = {
'total_time': 0,
'word_count': 0,
'segments': 0
}
speaker_stats[speaker]['total_time'] += duration
speaker_stats[speaker]['word_count'] += len(segment['text'].split())
speaker_stats[speaker]['segments'] += 1
# Calculate percentages
for speaker in speaker_stats:
speaker_stats[speaker]['percentage'] = (speaker_stats[speaker]['total_time'] / total_duration) * 100
return speaker_stats, total_duration
# Function to generate speaker analysis charts
def generate_speaker_analysis_charts(speaker_stats, output_path):
try:
# Create DataFrame for easier visualization
speakers = list(speaker_stats.keys())
percentages = [speaker_stats[speaker]['percentage'] for speaker in speakers]
word_counts = [speaker_stats[speaker]['word_count'] for speaker in speakers]
# Create figure with two subplots
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(15, 6))
# Chart 1: Speaking time by speaker (pie)
ax1.pie(percentages, labels=speakers, autopct='%1.1f%%', startangle=90)
ax1.set_title('Speaking Time Distribution')
# Chart 2: Number of words by speaker (bars)
ax2.bar(speakers, word_counts)
ax2.set_title('Word Count by Speaker')
ax2.set_ylabel('Word Count')
ax2.tick_params(axis='x', rotation=45)
plt.tight_layout()
plt.savefig(output_path)
print(f"Analysis charts saved to: {output_path}")
return True
except Exception as e:
print(f"Error generating analysis charts: {e}")
return False
# Function to choose organization mode: chronological or by speakers
def organize_segments(segments, mode="chronological"):
if mode == "by_speaker":
# Organize by speakers
speakers_content = {}
for segment in segments:
speaker = segment.get('speaker', 'Unknown Speaker')
if speaker not in speakers_content:
speakers_content[speaker] = []
speakers_content[speaker].append(segment)
# Sort segments by time within each speaker
for speaker in speakers_content:
speakers_content[speaker].sort(key=lambda x: x['start'])
return speakers_content
else:
# Organize chronologically (already sorted by time)
return segments
# Function to divide text into paragraphs based on organization mode
def process_segments_for_document(segments, mode="chronological"):
if mode == "by_speaker":
# Organize by speakers
speakers_content = organize_segments(segments, "by_speaker")
paragraphs = []
for speaker, speaker_segments in speakers_content.items():
speaker_text = ""
for segment in speaker_segments:
speaker_text += segment['text'] + " "
paragraphs.append({
'speaker': speaker,
'text': speaker_text
})
return paragraphs
else:
# Organize chronologically
chronological_paragraphs = []
current_paragraph = []
current_speaker = None
current_timestamp = None
for segment in segments:
speaker = segment.get('speaker', 'Unknown Speaker')
text = segment['text']
start_time = segment['start']
end_time = segment['end']
# Format time as HH:MM:SS
time_str = format_timestamp(start_time)
# If speaker changes, start a new paragraph
if current_speaker and current_speaker != speaker and current_paragraph:
chronological_paragraphs.append({
'speaker': current_speaker,
'text': ' '.join(current_paragraph),
'timestamp': current_timestamp
})
current_paragraph = []
# Update current speaker and add text
current_speaker = speaker
current_timestamp = time_str
current_paragraph.append(text)
# Add the last paragraph if there's content
if current_paragraph:
chronological_paragraphs.append({
'speaker': current_speaker,
'text': ' '.join(current_paragraph),
'timestamp': current_timestamp
})
return chronological_paragraphs
# Function to format time in HH:MM:SS format
def format_timestamp(seconds):
m, s = divmod(seconds, 60)
h, m = divmod(m, 60)
return f"{int(h):02d}:{int(m):02d}:{int(s):02d}"
# Function to improve text style and grammar before saving
def correct_text(text, language="es"):
try:
import language_tool_python
language_code = language[:2].lower() # Get only the 2-letter language code
supported_languages = ["es", "en", "fr", "de", "pt", "nl"]
if language_code not in supported_languages:
print(f"Grammar correction not available for language {language_code}, using Spanish by default.")
language_code = "es"
tool = language_tool_python.LanguageTool(language_code)
matches = tool.check(text)
corrected_text = language_tool_python.utils.correct(text, matches)
return corrected_text
except Exception as e:
print(f"Error correcting text: {e}")
return text # Return original text if there's an error
# Function to create Word document with organized transcription
def create_word_document(paragraphs, output_path, include_timestamps=True, stats=None, chart_path=None):
try:
doc = Document()
# Configure document style
style = doc.styles['Normal']
style.font.name = 'Arial'
style.font.size = Pt(11)
# Main title
title = doc.add_heading('Transcription with Speaker Identification', 0)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER
# Add statistics information if available
if stats:
doc.add_heading('Participation Summary', level=1)
stats_table = doc.add_table(rows=1, cols=5)
stats_table.style = 'Table Grid'
# Table headers
hdr_cells = stats_table.rows[0].cells
hdr_cells[0].text = 'Speaker'
hdr_cells[1].text = 'Time (s)'
hdr_cells[2].text = 'Percentage (%)'
hdr_cells[3].text = 'Words'
hdr_cells[4].text = 'Interventions'
# Add data for each speaker
for speaker, data in stats.items():
row_cells = stats_table.add_row().cells
row_cells[0].text = speaker
row_cells[1].text = f"{data['total_time']:.2f}"
row_cells[2].text = f"{data['percentage']:.2f}"
row_cells[3].text = f"{data['word_count']}"
row_cells[4].text = f"{data['segments']}"
doc.add_paragraph()
# Add chart if available
if chart_path and os.path.exists(chart_path):
doc.add_heading('Graphical Analysis', level=1)
doc.add_picture(chart_path, width=Pt(450))
doc.add_paragraph()
# Transcription title
doc.add_heading('Complete Transcription', level=1)
# Add paragraphs to document
for paragraph in paragraphs:
speaker = paragraph['speaker']
text = paragraph['text']
# Create paragraph with appropriate formatting
p = doc.add_paragraph()
# Add timestamp if available and option is enabled
if include_timestamps and 'timestamp' in paragraph:
timestamp_run = p.add_run(f"[{paragraph['timestamp']}] ")
timestamp_run.bold = True
timestamp_run.font.color.rgb = RGBColor(128, 128, 128)
# Add speaker
speaker_run = p.add_run(f"{speaker}: ")
speaker_run.bold = True
# Text color according to speaker for easier reading
if "Speaker 1" in speaker:
speaker_run.font.color.rgb = RGBColor(0, 0, 200) # Blue
elif "Speaker 2" in speaker:
speaker_run.font.color.rgb = RGBColor(200, 0, 0) # Red
elif "Speaker 3" in speaker:
speaker_run.font.color.rgb = RGBColor(0, 150, 0) # Green
elif "Speaker 4" in speaker:
speaker_run.font.color.rgb = RGBColor(128, 0, 128) # Purple
# Add paragraph text
text_run = p.add_run(text)
# Add separator for better readability
doc.add_paragraph()
# Save document
doc.save(output_path)
print(f"Word document saved to: {output_path}")
return True
except Exception as e:
print(f"Error creating Word document: {str(e)}")
return False
# Function to save results as JSON for later processing
def save_json_results(segments, output_path):
try:
# Convert segments to serializable format
serializable_segments = []
for segment in segments:
serializable_segment = {
'start': segment['start'],
'end': segment['end'],
'text': segment['text'],
'speaker': segment.get('speaker', 'Unknown Speaker')
}
serializable_segments.append(serializable_segment)
# Save to JSON file
with open(output_path, 'w', encoding='utf-8') as f:
json.dump(serializable_segments, f, ensure_ascii=False, indent=2)
print(f"Results saved in JSON format: {output_path}")
return True
except Exception as e:
print(f"Error saving results to JSON: {e}")
return False
# Function to save results to Hugging Face Dataset
def save_to_huggingface_dataset(segments, output_path=None, push_to_hub=False, repo_id=None, token=None):
try:
# Prepare data for Dataset format
data = {
"segment_id": [],
"start_time": [],
"end_time": [],
"speaker": [],
"text": []
}
for i, segment in enumerate(segments):
data["segment_id"].append(i)
data["start_time"].append(segment["start"])
data["end_time"].append(segment["end"])
data["speaker"].append(segment.get("speaker", "Unknown Speaker"))
data["text"].append(segment["text"])
# Create Dataset
dataset = Dataset.from_dict(data)
# Save locally if path provided
if output_path:
dataset.save_to_disk(output_path)
print(f"Dataset saved locally to: {output_path}")
# Push to Hugging Face Hub if requested
if push_to_hub and repo_id:
dataset.push_to_hub(repo_id, token=token)
print(f"Dataset pushed to Hugging Face Hub: {repo_id}")
return dataset
except Exception as e:
print(f"Error saving to Hugging Face dataset: {e}")
return None
# Main function
def main():
parser = argparse.ArgumentParser(description="Audio transcription with speaker diarization using Hugging Face models")
parser.add_argument("--video", type=str, help="Path to video file")
parser.add_argument("--audio", type=str, help="Path to audio file (if already extracted)")
parser.add_argument("--output_dir", type=str, default="./output", help="Directory to save output files")
parser.add_argument("--model", type=str, default="openai/whisper-base",
help="Whisper model to use: openai/whisper-tiny, openai/whisper-base, openai/whisper-small, openai/whisper-medium, openai/whisper-large")
parser.add_argument("--language", type=str, help="Language code (e.g., 'es' for Spanish)")
parser.add_argument("--hf_token", type=str, help="Hugging Face API token for speaker diarization")
parser.add_argument("--organization", type=str, default="chronological",
choices=["chronological", "by_speaker"], help="Transcription organization mode")
parser.add_argument("--push_to_hub", action="store_true", help="Push results to Hugging Face Hub")
parser.add_argument("--repo_id", type=str, help="Hugging Face repository ID for pushing dataset")
args = parser.parse_args()
# Create output directory if it doesn't exist
os.makedirs(args.output_dir, exist_ok=True)
# Timestamp for output files
timestamp = time.strftime("%Y%m%d_%H%M%S")
try:
print("=== TRANSCRIPTION WITH SPEAKER DETECTION ===")
# Check input file
if args.audio:
audio_path = args.audio
base_filename = os.path.splitext(os.path.basename(audio_path))[0]
elif args.video:
video_path = args.video
base_filename = os.path.splitext(os.path.basename(video_path))[0]
audio_path = os.path.join(args.output_dir, f"{base_filename}_{timestamp}.wav")
# Extract audio from video
if not extract_audio(video_path, audio_path):
print("Could not extract audio. Process canceled.")
return
else:
print("Error: You must provide either a video file or an audio file.")
return
# Output file paths
word_output_path = os.path.join(args.output_dir, f"{base_filename}_{timestamp}_transcription.docx")
json_output_path = os.path.join(args.output_dir, f"{base_filename}_{timestamp}_data.json")
chart_output_path = os.path.join(args.output_dir, f"{base_filename}_{timestamp}_analysis.png")
dataset_output_path = os.path.join(args.output_dir, f"{base_filename}_{timestamp}_dataset")
print(f"\nProcessing audio: {audio_path}")
start_time = time.time()
# Transcribe with Whisper
print(f"\nStarting transcription with Whisper model {args.model}...")
transcribed_text, segments, detected_language = transcribe_audio_with_timing(
audio_path,
model_name=args.model,
language=args.language
)
if not transcribed_text:
print("Transcription failed. Process canceled.")
return
print(f"Transcription completed: {transcribed_text[:100]}...\n")
# If no language specified, use the detected one
if not args.language:
detected_language = detect_language(transcribed_text) if detected_language == "unknown" else detected_language
else:
detected_language = args.language
# Speaker diarization
print("Starting speaker detection...")
speakers = diarize_speakers(audio_path, args.hf_token)
# Assign speakers to segments
segments_with_speakers = assign_speakers_to_segments(segments, speakers)
# Analyze speaker statistics
speaker_stats, total_duration = analyze_speaker_stats(segments_with_speakers)
print("\n=== PARTICIPATION STATISTICS ===")
for speaker, stats in speaker_stats.items():
print(f"{speaker}: {stats['percentage']:.2f}% of time, {stats['word_count']} words, {stats['segments']} interventions")
# Generate analysis charts
generate_speaker_analysis_charts(speaker_stats, chart_output_path)
# Process segments according to selected organization mode
paragraphs = process_segments_for_document(segments_with_speakers, args.organization)
# Save results as JSON
save_json_results(segments_with_speakers, json_output_path)
# Create Word document with transcription
create_word_document(
paragraphs,
word_output_path,
include_timestamps=True,
stats=speaker_stats,
chart_path=chart_output_path
)
# Save to Hugging Face Dataset
if args.push_to_hub or os.path.exists(dataset_output_path):
save_to_huggingface_dataset(
segments_with_speakers,
output_path=dataset_output_path,
push_to_hub=args.push_to_hub,
repo_id=args.repo_id,
token=args.hf_token
)
# Total processing time
end_time = time.time()
elapsed_time = end_time - start_time
print(f"\nTotal processing time: {elapsed_time:.2f} seconds")
print("\nProcess completed successfully!")
except Exception as e:
print(f"Unexpected error during the process: {str(e)}")
# Run the script
if __name__ == "__main__":
main()