ask-annie/README.md

Ask Annie — ST Best Practices Session Ingestion

Ingestion pipeline for Axway MFT User Group "Ask Annie" Q&A sessions on Vimeo.

What it does

1. Downloads audio from a Vimeo URL via yt-dlp
2. Transcribes with Whisper (timestamped segments)
3. Slices transcript into per-chapter chunks using a chapters JSON file
4. Optionally extracts frames from demo-heavy chapters for vision annotation
5. Outputs chunks.json ready for ingestion into knowledge-mcp

Usage

python3 ingest.py \
  --url 'https://vimeo.com/1020102626' \
  --chapters chapters/1020102626.json \
  --out ./out \
  --whisper-model medium

Add --frames to also extract video frames for demo chapters (requires video download).

Dependencies

brew install yt-dlp ffmpeg
pip install openai-whisper

Repo structure

ingest.py                    # Main pipeline script
chapters/<video_id>.json     # Chapter list per session
out/<video_id>/              # Output (gitignored)
  audio.mp3
  transcript.json
  chunks.json
  frames/

Adding a new session

1. Create chapters/<video_id>.json with timestamp + title + summary per chapter
2. Run ingest.py --url <vimeo_url> --chapters chapters/<video_id>.json
3. Review out/<video_id>/chunks.json
4. Ingest chunks into knowledge-mcp notebook securetransport-md