Private local meeting transcription
Use meeting.py to transcribe a user-selected audio/video file with local Whisper and produce reusable transcript artifacts. The workflow does not call a cloud transcription API. Whisper model files may be downloaded the first time a model is used; disclose that setup network requirement and keep later processing local.
Quick start
python3 meeting.py --input meeting.m4a --model base --output-dir meeting-output
This writes:
transcript.jsonwith transcript text, language, duration, and timestamped segments;transcript.srtwith subtitle timing;notes.mdwith a readable transcript and deterministic action-item candidates.
Formats and models
- Use
--format all(default),json,srt, ormarkdown. - Use Whisper models
tiny,base,small,medium,large, orturbo. - Use
--language enwhen the language is known; omit it for automatic detection. - Use
--include-word-timestampsonly when detailed timing is required; it costs more compute.
Privacy and safety
- The input must resolve inside the current workspace; symlink escapes are rejected.
- Output is written only to the requested output directory inside the workspace.
- The script performs local transcription through Whisper and makes no runtime network request.
- Initial model acquisition can require network access through Whisper's normal model cache. Use a pre-downloaded model in restricted environments.
- Do not place confidential recordings, credentials, or private transcripts in public issue reports.
Agent workflow
- Confirm the user has permission to process the recording.
- Check local capacity before large jobs with the Local System Info skill.
- Choose
basefor a practical default; usesmallor larger when accuracy matters and resources allow. - Run the script and inspect
transcript.jsonbefore summarizing. - Cite timestamps when extracting decisions or action items.
Example
python3 meeting.py \
--input interview.wav \
--model small \
--language en \
--output-dir interview-output \
--format all
Source: https://github.com/iyeque/openclaw-skills/tree/main/skills/meeting-transcription
Report bugs and security concerns through the repository issue guidance.
