Speakr is a personal, self-hosted web application designed for transcribing audio recordings
Python
docs: describe citation precision accurately - playback starts at the cited segment, not word-level moments
Murtaza Nasir789269235a87
diff --git a/README.md b/README.mdindex 6d689655..8e25f8b1 100644--- a/README.md+++ b/README.md@@ -51,7 +51,7 @@ Speakr turns a recording into organized, searchable, shareable knowledge. Here i- **Summaries** - generated automatically, with prompts you can fully customize per recording, tag, or folder (including reusable prompt variables).- **Event extraction** - surface action items and calendar-worthy events from a transcript.- **Per-recording chat** - ask questions about a single recording in a floating, dockable panel; answers cite transcript timestamps as clickable chips that start playback at that moment.-- **Inquire Mode** - semantic search and natural-language chat across your entire library at once. An optional **agentic mode** (opt-in beta) upgrades this to an AI researcher that iteratively searches, lists, and reads your recordings until it can answer - showing every step live, and citing the exact moment with numbered source links that open the recording and play from that point. Ask "what did we decide about the pricing change, and did anyone disagree?" and it reads across the relevant meetings and cites each position to the second it was said. You decide what it may read: transcripts always, summaries and private notes only if you allow them.+- **Inquire Mode** - semantic search and natural-language chat across your entire library at once. An optional **agentic mode** (opt-in beta) upgrades this to an AI researcher that iteratively searches, lists, and reads your recordings until it can answer - showing every step live, and citing its sources with numbered links that open the recording and start playback at the cited segment. Ask "what did we decide about the pricing change, and did anyone disagree?" and it reads across the relevant meetings and cites each position back to where it was said. You decide what it may read: transcripts always, summaries and private notes only if you allow them.### Organize- **Folders and bulk operations** to keep a large library tidy.diff --git a/docs/user-guide/inquire-mode.md b/docs/user-guide/inquire-mode.mdindex 58ffbea2..4d574cb5 100644--- a/docs/user-guide/inquire-mode.md+++ b/docs/user-guide/inquire-mode.md@@ -86,7 +86,7 @@ Performance scales well with proper setup. The initial indexing of recordings haAdministrators can enable an agentic mode with `ENABLE_INQUIRE_AGENT=true` (requires Inquire Mode to be enabled). Instead of a single retrieval pass, an AI agent works iteratively: it searches your transcripts, lists recordings, and reads transcripts, summaries, or notes as needed, thinking between steps until it can answer. The interface shows each step live (what was searched, what was read, how many matches), a Stop button to interrupt, and a collapsed activity line on every answer so you can always see how a conclusion was reached. Answers cite their sources as compact numbered markers such as "2 @ 14:05": clicking one opens that recording and starts playback at the cited moment, and a Sources list at the end of each answer maps every number to its recording. The numbering stays stable through the conversation, so a follow-up like "tell me more about 3" refers to exactly what you saw.-A few examples show the difference from classic Inquire. Ask "what did we decide about the pricing change, and did anyone disagree?" and the agent will search for the pricing discussions, read the relevant transcript sections across several meetings, and answer with each position cited to the moment it was said. Ask "summarize everything client X asked for this quarter" and it will list the recordings involving that client, read their summaries, and consolidate the requests with one citation per item. Ask "when did I first mention the migration plan?" and it will search, compare dates, and hand you a link that starts playback at that sentence. Classic Inquire retrieves passages in one pass and answers from whatever that single search surfaced; the agent keeps working until the question is actually answered, which is the difference you feel on questions that span recordings or need a fact checked rather than paraphrased.+A few examples show the difference from classic Inquire. Ask "what did we decide about the pricing change, and did anyone disagree?" and the agent will search for the pricing discussions, read the relevant transcript sections across several meetings, and answer with each position cited back to where it was said. Ask "summarize everything client X asked for this quarter" and it will list the recordings involving that client, read their summaries, and consolidate the requests with one citation per item. Ask "when did I first mention the migration plan?" and it will search, compare dates, and hand you a link that starts playback at that sentence. Classic Inquire retrieves passages in one pass and answers from whatever that single search surfaced; the agent keeps working until the question is actually answered, which is the difference you feel on questions that span recordings or need a fact checked rather than paraphrased.The agent respects your privacy settings. Under Account, the Inquire Privacy section controls what the agent may read: transcripts are always available (they are the minimum for Inquire to function), summaries are optional and on by default, and your notes are optional and off by default. A disabled content type is removed from the agent's toolbox entirely. Only your own notes are ever used, never notes on recordings shared with you. The active filter selection is a hard boundary: the agent can narrow its search within your filters but can never reach recordings outside them.