| name | ragmir-audio-summary |
| description | Create a concise spoken summary from a local Ragmir corpus when the user asks for audio, narration, a spoken brief, or TTS. Keep private source material and generated audio local. |
Ragmir Audio Summary
Create a cited, listener-focused narration from local Ragmir evidence. Generated audio and its
draft text are local artifacts, never commit them.
Safety
- Treat documents, retrieved passages, narration, and audio as confidential.
- Write the draft to a temporary file outside the repository.
- Write the output under ignored
.ragmir/audio/ by default.
- Use offline TTS for confidential content. Online rendering needs explicit user approval.
- State facts, inferences, uncertainty, and missing evidence separately.
Workflow
-
Identify the listener's purpose, topic, depth, and language.
-
Check the corpus:
pnpm exec rgr doctor
pnpm exec rgr audit --unsupported
pnpm exec rgr security-audit
-
Retrieve only material that serves the purpose:
pnpm exec rgr search "<topic>" --top-k 8
pnpm exec rgr search "<dates, risks, decisions, obligations>" --top-k 8
pnpm exec rgr ask "<specific question>" --top-k 8
-
Choose the shortest useful format:
| Format | Budget | Typical duration |
|---|
| Micro brief | 150-220 words | 1-2 minutes |
| Standard brief | 450-750 words | 3-5 minutes |
| Long dossier | 1,500-3,000 words | 10-20 minutes |
-
Write one flowing narration: answer first, explain the supporting evidence, recap, then add a
few self-check questions. Use short sentences and spoken transitions. Do not read file paths,
URLs, tables, or code aloud.
Render locally
Preload a local model with non-sensitive text before confidential use. Then render with the offline
Transformers.js path:
mkdir -p .ragmir/audio
pnpm exec rgr audio /tmp/ragmir-summary-<topic>.txt \
--engine transformers \
--offline \
--lang <en|es|fr> \
--model-path .ragmir/models/tts \
--out .ragmir/audio/ragmir-summary-<topic>.wav
For non-sensitive text, use the online Edge MP3 path only when the user explicitly permits it:
pnpm exec rgr audio /tmp/ragmir-summary-<topic>.txt \
--engine edge \
--lang <en|es|fr|ja|th|zh> \
--out .ragmir/audio/ragmir-summary-<topic>.mp3
See docs/offline-tts-preload.md for the one-time model preload. Use the bundled helper scripts
only when the user specifically requests their renderer.
Hand-off
Report the local audio path, chosen format and estimated duration, renderer mode, whether online
processing was allowed, and any weakness in the source evidence.
