Speakr is a personal, self-hosted web application designed for transcribing audio recordings
Python
Folder filter in Inquire, combinable with tags (#428)
Murtaza Nasirded360c36150
diff --git a/docs/user-guide/api-reference.md b/docs/user-guide/api-reference.mdindex 47c1e423..c76586e8 100644--- a/docs/user-guide/api-reference.md+++ b/docs/user-guide/api-reference.md@@ -1410,7 +1410,7 @@ Answers a question from the recordings you can read, with Inquire's search (and```json{"question": "What did we decide about the course redesign?",- "filters": {"recording_ids": [412, 398], "tag_ids": [], "speakers": [], "date_from": "2026-09-01", "date_to": null},+ "filters": {"recording_ids": [412, 398], "tag_ids": [], "folder_ids": [], "speakers": [], "date_from": "2026-09-01", "date_to": null},"scope": "own","mode": "auto","stream": false,diff --git a/docs/user-guide/inquire-mode.md b/docs/user-guide/inquire-mode.mdindex a4e5a07d..b3d5382f 100644--- a/docs/user-guide/inquire-mode.md+++ b/docs/user-guide/inquire-mode.md@@ -32,6 +32,8 @@ The left sidebar contains filters that help you narrow your search to specific rThe tag filter lets you select recordings with specific tags, which is perfect when you want to search within a particular project, client, or type of meeting. If you've tagged your recordings consistently, this becomes a powerful way to segment your searches. The system shows how many recordings match each tag, helping you understand the scope of your search.+The folder filter, shown when folders are enabled, limits the search to recordings in the selected folders. When tags and folders are both selected, only recordings that are in one of the selected folders and carry one of the selected tags are searched.+Speaker filtering allows you to focus on what specific people have said across recordings. This is invaluable when you need to track commitments from a particular person, understand someone's perspective on various topics, or prepare for a meeting with specific individuals.Date range filtering helps you focus on recent discussions or search within a specific time period. This is particularly useful for tracking how discussions have evolved over time or finding information from a specific quarter or project phase.diff --git a/src/api/api_v1.py b/src/api/api_v1.pyindex a599207f..94591a03 100644--- a/src/api/api_v1.py+++ b/src/api/api_v1.py@@ -3218,8 +3218,8 @@ def chat_with_recording(recording_id):def inquire_v1():"""Ask a question across recordings (mailr spec G9).- Body: question, filters {recording_ids, tag_ids, speakers, date_from,- date_to}, scope (own|shared|all), mode (rag|agent|auto), stream, history.+ Body: question, filters {recording_ids, tag_ids, folder_ids, speakers,+ date_from, date_to}, scope (own|shared|all), mode (rag|agent|auto), stream, history."""import re as _refrom flask import Response, stream_with_context@@ -3256,6 +3256,7 @@ def inquire_v1():'message_history': body.get('history') or [],'filter_recording_ids': allowed,'filter_tags': filters.get('tag_ids') or [],+ 'filter_folders': filters.get('folder_ids') or [],'filter_speakers': filters.get('speakers') or [],'filter_date_from': filters.get('date_from'),'filter_date_to': filters.get('date_to'),diff --git a/src/api/inquire.py b/src/api/inquire.pyindex 82111e96..a7bb298a 100644--- a/src/api/inquire.py+++ b/src/api/inquire.py@@ -139,6 +139,8 @@ def inquire_search():filters = {}if data.get('filter_tags'):filters['tag_ids'] = data['filter_tags']+ if data.get('filter_folders'):+ filters['folder_ids'] = data['filter_folders']if data.get('filter_speakers'):filters['speaker_names'] = data['filter_speakers']if data.get('filter_recording_ids'):@@ -173,7 +175,7 @@ def inquire_stream(user, data, mode='auto'):"""The Inquire answer as an SSE generator, for the web route and API v1.data: message, message_history, conversation_memory, filter_tags,- filter_speakers, filter_recording_ids, filter_date_from, filter_date_to.+ filter_folders, filter_speakers, filter_recording_ids, filter_date_from, filter_date_to.mode: 'auto' (the agent when ENABLE_INQUIRE_AGENT is on), 'rag' or'agent' (the caller checks that the agent is on)."""@@ -183,6 +185,8 @@ def inquire_stream(user, data, mode='auto'):filters = {}if data.get('filter_tags'):filters['tag_ids'] = data['filter_tags']+ if data.get('filter_folders'):+ filters['folder_ids'] = data['filter_folders']if data.get('filter_speakers'):filters['speaker_names'] = data['filter_speakers']if data.get('filter_recording_ids'):@@ -571,6 +575,9 @@ Respond with only a JSON array of strings: ["term1", "term2", ...]"""if data.get('filter_tags'):tag_names = [tag.name for tag in Tag.query.filter(Tag.id.in_(data['filter_tags'])).all()]filter_description.append(f"tags: {', '.join(tag_names)}")+ if data.get('filter_folders'):+ folder_names = [f.name for f in Folder.query.filter(Folder.id.in_(data['filter_folders'])).all()]+ filter_description.append(f"folders: {', '.join(folder_names)}")if data.get('filter_speakers'):filter_description.append(f"speakers: {', '.join(data['filter_speakers'])}")if data.get('filter_date_from') or data.get('filter_date_to'):@@ -902,8 +909,20 @@ def get_available_filters():Recording.status == 'COMPLETED').order_by(Recording.created_at.desc()).all()+ # Folders (#428): the user's own and those of their groups, when the+ # feature is on+ folders = []+ if SystemSetting.get_setting('enable_folders', False):+ folders = Folder.query.filter_by(user_id=current_user.id, group_id=None).all()+ if group_ids:+ folders += Folder.query.filter(Folder.group_id.in_(group_ids)).all()+ folders.sort(key=lambda f: f.name.lower())+return jsonify({'tags': [tag.to_dict() for tag in all_tags],+ 'folders': [{'id': f.id, 'name': f.name, 'color': f.color,+ 'group_name': f.group.name if f.group else None,+ 'recording_count': len(f.recordings) if f.recordings else 0} for f in folders],'speakers': speaker_names,'recordings': [{'id': r.id, 'title': r.title, 'meeting_date': r.meeting_date.isoformat() if r.meeting_date else None} for r in recordings]})diff --git a/src/services/embeddings.py b/src/services/embeddings.pyindex ce23b8c7..71d685e5 100644--- a/src/services/embeddings.py+++ b/src/services/embeddings.py@@ -637,6 +637,11 @@ def basic_text_search_chunks(user_id, query, filters=None, top_k=5):RecordingTag, Recording.id == RecordingTag.recording_id).filter(RecordingTag.tag_id.in_(filters['tag_ids']))+ if filters.get('folder_ids'):+ # A subquery, so that no second join to Recording is needed (#428)+ chunks_query = chunks_query.filter(TranscriptChunk.recording_id.in_(+ db.session.query(Recording.id).filter(Recording.folder_id.in_(filters['folder_ids']))))+if filters.get('speaker_names'):# Filter by the participants field on the recording.speaker_conditions = [@@ -805,6 +810,11 @@ def semantic_search_chunks(user_id, query, filters=None, top_k=5):RecordingTag, Recording.id == RecordingTag.recording_id).filter(RecordingTag.tag_id.in_(filters['tag_ids']))+ if filters.get('folder_ids'):+ # A subquery, so that no second join to Recording is needed (#428)+ chunks_query = chunks_query.filter(TranscriptChunk.recording_id.in_(+ db.session.query(Recording.id).filter(Recording.folder_id.in_(filters['folder_ids']))))+if filters.get('speaker_names'):# Filter by the participants field on the recording.speaker_conditions = [diff --git a/src/services/inquire_agent.py b/src/services/inquire_agent.pyindex f64a5969..5c4774fa 100644--- a/src/services/inquire_agent.py+++ b/src/services/inquire_agent.py@@ -26,7 +26,7 @@ import time as time_modfrom datetime import datetime, time as dtimefrom src.database import db-from src.models import Recording, RecordingTag, Tag, User+from src.models import Folder, Recording, RecordingTag, Tag, Userfrom src.services.embeddings import (get_accessible_recording_ids,semantic_search_chunks,@@ -128,6 +128,8 @@ def resolve_allowed_recording_ids(user_id, filters):if filters.get('tag_ids'):q = q.join(RecordingTag, Recording.id == RecordingTag.recording_id) \.filter(RecordingTag.tag_id.in_(filters['tag_ids']))+ if filters.get('folder_ids'):+ q = q.filter(Recording.folder_id.in_(filters['folder_ids']))if filters.get('speaker_names'):q = q.filter(db.or_(*[Recording.participants.ilike(f'%{name}%')@@ -824,6 +826,9 @@ def run_inquire_agent(app, user_id, user_ctx, user_message, message_history,if f.get('tag_ids'):names = [t.name for t in Tag.query.filter(Tag.id.in_(f['tag_ids'])).all()]filter_bits.append(f"tags: {', '.join(names)}")+ if f.get('folder_ids'):+ names = [x.name for x in Folder.query.filter(Folder.id.in_(f['folder_ids'])).all()]+ filter_bits.append(f"folders: {', '.join(names)}")if f.get('speaker_names'):filter_bits.append(f"speakers: {', '.join(f['speaker_names'])}")if f.get('date_from') or f.get('date_to'):diff --git a/static/locales/de.json b/static/locales/de.jsonindex c9603109..10d610f6 100644--- a/static/locales/de.json+++ b/static/locales/de.json@@ -1121,6 +1121,7 @@"placeholderSizeMB": "Größe in MB eingeben","searchSpeakers": "Sprecher suchen...","searchTags": "Tags suchen...",+ "searchFolders": "Ordner suchen...","seconds": "Sekunden","shareNotes": "Notizen teilen","shareSummary": "Zusammenfassung teilen",@@ -1369,7 +1370,9 @@"speakers": "Sprecher","speakersCount": "Sprecher","tags": "Tags",+ "folders": "Ordner","tagsCount": "Tags",+ "foldersCount": "Ordner","title": "Nachfragen","to": "Bis"},diff --git a/static/locales/en.json b/static/locales/en.jsonindex cdf623e5..08492a08 100644--- a/static/locales/en.json+++ b/static/locales/en.json@@ -1123,6 +1123,7 @@"placeholderSizeMB": "Enter size in MB","searchSpeakers": "Search speakers...","searchTags": "Search tags...",+ "searchFolders": "Search folders...","seconds": "Seconds","shareNotes": "Share Notes","shareSummary": "Share Summary",@@ -1369,7 +1370,9 @@"speakers": "Speakers","speakersCount": "speakers","tags": "Tags",+ "folders": "Folders","tagsCount": "tags",+ "foldersCount": "folders","title": "Inquire","to": "To"},diff --git a/static/locales/es.json b/static/locales/es.jsonindex 4b5e6d47..25386a87 100644--- a/static/locales/es.json+++ b/static/locales/es.json@@ -1121,6 +1121,7 @@"placeholderSizeMB": "Ingrese tamaño en MB","searchSpeakers": "Buscar hablantes...","searchTags": "Buscar etiquetas...",+ "searchFolders": "Buscar carpetas...","seconds": "Segundos","shareNotes": "Compartir Notas","shareSummary": "Compartir Resumen",@@ -1369,7 +1370,9 @@"speakers": "Oradores","speakersCount": "oradores","tags": "Etiquetas",+ "folders": "Carpetas","tagsCount": "etiquetas",+ "foldersCount": "carpetas","title": "Consultar","to": "Hasta"},diff --git a/static/locales/fr.json b/static/locales/fr.jsonindex 751b49b2..0efce5b1 100644--- a/static/locales/fr.json+++ b/static/locales/fr.json@@ -1121,6 +1121,7 @@"placeholderSizeMB": "Entrez la taille en Mo","searchSpeakers": "Rechercher des intervenants...","searchTags": "Rechercher des étiquettes...",+ "searchFolders": "Rechercher des dossiers...","seconds": "Secondes","shareNotes": "Partager les Notes","shareSummary": "Partager le Résumé",@@ -1369,7 +1370,9 @@"speakers": "Intervenants","speakersCount": "intervenants","tags": "Étiquettes",+ "folders": "Dossiers","tagsCount": "étiquettes",+ "foldersCount": "dossiers","title": "Enquêter","to": "À"},diff --git a/static/locales/pt-BR.json b/static/locales/pt-BR.jsonindex eb976fa4..e6a47ab7 100644--- a/static/locales/pt-BR.json+++ b/static/locales/pt-BR.json@@ -1121,6 +1121,7 @@"placeholderSizeMB": "Digite tamanho em MB","searchSpeakers": "Pesquisar oradores...","searchTags": "Pesquisar etiquetas...",+ "searchFolders": "Pesquisar pastas...","seconds": "Segundos","shareNotes": "Compartilhar Notas","shareSummary": "Compartilhar Resumo",@@ -1369,7 +1370,9 @@"speakers": "Oradores","speakersCount": "oradores","tags": "Etiquetas",+ "folders": "Pastas","tagsCount": "etiquetas",+ "foldersCount": "pastas","title": "Consulta","to": "Para"},diff --git a/static/locales/ru.json b/static/locales/ru.jsonindex acbaff65..6f09f49e 100644--- a/static/locales/ru.json+++ b/static/locales/ru.json@@ -1121,6 +1121,7 @@"placeholderSizeMB": "Введите размер в МБ","searchSpeakers": "Поиск спикеров...","searchTags": "Поиск тегов...",+ "searchFolders": "Поиск папок...","seconds": "Секунды","shareNotes": "Поделиться заметками","shareSummary": "Поделиться резюме",@@ -1369,7 +1370,9 @@"speakers": "Спикеры","speakersCount": "спикеров","tags": "Теги",+ "folders": "Папки","tagsCount": "тегов",+ "foldersCount": "папок","title": "Inquire","to": "По"},diff --git a/static/locales/zh.json b/static/locales/zh.jsonindex 1c2daaf2..1068a164 100644--- a/static/locales/zh.json+++ b/static/locales/zh.json@@ -1121,6 +1121,7 @@"placeholderSizeMB": "输入大小(MB)","searchSpeakers": "搜索发言人...","searchTags": "搜索标签...",+ "searchFolders": "搜索文件夹...","seconds": "秒","shareNotes": "分享笔记","shareSummary": "分享摘要",@@ -1369,7 +1370,9 @@"speakers": "发言人","speakersCount": "个发言人","tags": "标签",+ "folders": "文件夹","tagsCount": "个标签",+ "foldersCount": "个文件夹","title": "查询","to": "结束日期"},diff --git a/templates/inquire.html b/templates/inquire.htmlindex 28bbc518..343a4f9d 100644--- a/templates/inquire.html+++ b/templates/inquire.html@@ -300,6 +300,27 @@</div></div>+ <!-- Folder Filters (#428), shown when folders are enabled -->+ <div v-if="availableFilters.folders.length > 0" class="rounded-md border p-3"+ style="background: var(--bg-primary); border-color: var(--border-secondary);">+ <h3 class="t-body-strong mb-2 flex items-center">+ <i class="fas fa-folder mr-2" style="color: var(--text-accent);"></i>${ t('inquire.folders') }+ </h3>+ <input type="text" v-model="folderSearchQuery" :placeholder="t('form.searchFolders')"+ class="field mb-2"+ style="font-size: var(--fs-meta);">+ <div class="space-y-0.5 max-h-40 overflow-y-auto custom-scrollbar">+ <label v-for="folder in filteredFolders" :key="folder.id"+ class="flex items-center cursor-pointer p-1.5 rounded transition-colors hover:bg-[var(--bg-tertiary)]">+ <input type="checkbox" :value="folder.id" v-model="inquireFilters.selectedFolders"+ class="filter-checkbox">+ <span class="ml-2 text-sm font-medium flex-1" :style="{ color: folder.color }">${ folder.name }</span>+ <span class="text-xs px-1.5 py-0.5 rounded-full"+ style="background: var(--bg-tertiary); color: var(--text-muted);">${ folder.recording_count }</span>+ </label>+ </div>+ </div>+<!-- Speaker Filters --><div class="rounded-md border p-3"style="background: var(--bg-primary); border-color: var(--border-secondary);">@@ -379,6 +400,12 @@<i class="fas fa-tags"></i><span>${ inquireFilters.selectedTags.length } ${ t('inquire.tagsCount') }</span></span>+ <span v-if="inquireFilters.selectedFolders.length"+ class="inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-[11px]"+ style="background: var(--bg-accent); color: var(--text-accent);">+ <i class="fas fa-folder"></i>+ <span>${ inquireFilters.selectedFolders.length } ${ t('inquire.foldersCount') }</span>+ </span><span v-if="inquireFilters.selectedSpeakers.length"class="inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-[11px]"style="background: var(--bg-accent); color: var(--text-accent);">@@ -704,6 +731,7 @@// --- State ---const inquireFilters = reactive({selectedTags: [],+ selectedFolders: [],selectedSpeakers: [],selectedRecordings: [],dateFrom: null,@@ -712,6 +740,7 @@// Search queries for filtersconst tagSearchQuery = ref('');+ const folderSearchQuery = ref('');const speakerSearchQuery = ref('');// Use shared components@@ -741,6 +770,7 @@const availableFilters = reactive({tags: [],+ folders: [],speakers: [],recordings: []});@@ -776,6 +806,7 @@// --- Computed ---const hasActiveFilters = computed(() => {return inquireFilters.selectedTags.length > 0 ||+ inquireFilters.selectedFolders.length > 0 ||inquireFilters.selectedSpeakers.length > 0 ||inquireFilters.selectedRecordings.length > 0 ||inquireFilters.dateFrom ||@@ -789,6 +820,13 @@);});+ const filteredFolders = computed(() => {+ if (!folderSearchQuery.value) return availableFilters.folders;+ return availableFilters.folders.filter(folder =>+ folder.name.toLowerCase().includes(folderSearchQuery.value.toLowerCase())+ );+ });+const filteredSpeakers = computed(() => {if (!speakerSearchQuery.value) return availableFilters.speakers;return availableFilters.speakers.filter(speaker =>@@ -821,6 +859,7 @@if (response.ok) {const data = await response.json();availableFilters.tags = data.tags;+ availableFilters.folders = data.folders || [];availableFilters.speakers = data.speakers;availableFilters.recordings = data.recordings;}@@ -1000,6 +1039,7 @@message_history: sentHistory,conversation_memory: memoryState.memory || undefined,filter_tags: inquireFilters.selectedTags,+ filter_folders: inquireFilters.selectedFolders,filter_speakers: inquireFilters.selectedSpeakers,filter_recording_ids: inquireFilters.selectedRecordings,filter_date_from: inquireFilters.dateFrom,@@ -1134,6 +1174,7 @@const clearInquireFilters = () => {inquireFilters.selectedTags = [];+ inquireFilters.selectedFolders = [];inquireFilters.selectedSpeakers = [];inquireFilters.selectedRecordings = [];inquireFilters.dateFrom = null;@@ -1299,6 +1340,7 @@chatProcessingStatus,showProcessingStatus,tagSearchQuery,+ folderSearchQuery,speakerSearchQuery,// Dark Mode@@ -1326,6 +1368,7 @@// ComputedhasActiveFilters,filteredTags,+ filteredFolders,filteredSpeakers,// Functionsdiff --git a/tests/test_inquire_folder_filter.py b/tests/test_inquire_folder_filter.pynew file mode 100644index 00000000..be66d8b8--- /dev/null+++ b/tests/test_inquire_folder_filter.py@@ -0,0 +1,107 @@+"""Folder filter in Inquire (#428).++Recordings can be limited to one or more folders, alone or together with+tags: a recording is in scope when it is in one of the selected folders and,+if tags are selected too, carries one of the selected tags.+"""++import uuid+from unittest.mock import patch++import pytest++from src.app import app, db+from src.models import Folder, Recording, RecordingTag, Tag, TranscriptChunk, User+from src.services.embeddings import basic_text_search_chunks+from src.services.inquire_agent import resolve_allowed_recording_ids++app.config['WTF_CSRF_ENABLED'] = False+++def library():+ """A user with folders A and B, a tag, and three recordings."""+ with app.app_context():+ s = uuid.uuid4().hex[:8]+ user = User(username=f'inqf_{s}', email=f'inqf_{s}@local.test', password='x')+ db.session.add(user)+ db.session.flush()+ fa = Folder(name=f'Client A {s}', user_id=user.id)+ fb = Folder(name=f'Client B {s}', user_id=user.id)+ tag = Tag(name=f'P-100 {s}', user_id=user.id)+ db.session.add_all([fa, fb, tag])+ db.session.flush()+ recs = {}+ for key, folder in (('a_tagged', fa), ('a_plain', fa), ('b_tagged', fb)):+ r = Recording(user_id=user.id, title=key, status='COMPLETED', folder_id=folder.id,+ transcription='budget review')+ db.session.add(r)+ db.session.flush()+ db.session.add(TranscriptChunk(recording_id=r.id, user_id=user.id, chunk_index=0,+ content='We discussed the budget review.'))+ recs[key] = r.id+ for key in ('a_tagged', 'b_tagged'):+ db.session.add(RecordingTag(recording_id=recs[key], tag_id=tag.id))+ db.session.commit()+ ids = {'user': user.id, 'a': fa.id, 'b': fb.id, 'tag': tag.id, **recs}+ yield ids+ with app.app_context():+ for key in ('a_tagged', 'a_plain', 'b_tagged'):+ TranscriptChunk.query.filter_by(recording_id=ids[key]).delete()+ RecordingTag.query.filter_by(recording_id=ids[key]).delete()+ db.session.delete(db.session.get(Recording, ids[key]))+ for key, model in (('tag', Tag), ('a', Folder), ('b', Folder), ('user', User)):+ db.session.delete(db.session.get(model, ids[key]))+ db.session.commit()+++def test_agent_scope_by_folder(library):+ with app.app_context():+ assert resolve_allowed_recording_ids(library['user'], {'folder_ids': [library['a']]}) == {+ library['a_tagged'], library['a_plain']}+++def test_agent_scope_by_folder_and_tag(library):+ with app.app_context():+ assert resolve_allowed_recording_ids(+ library['user'], {'folder_ids': [library['a']], 'tag_ids': [library['tag']]}+ ) == {library['a_tagged']}+++def test_text_search_by_folder_and_tag(library):+ with app.app_context():+ results = basic_text_search_chunks(+ library['user'], 'budget', {'folder_ids': [library['a'], library['b']], 'tag_ids': [library['tag']]},+ top_k=10)+ assert {chunk.recording_id for chunk, _ in results} == {library['a_tagged'], library['b_tagged']}+++def test_available_filters_list_folders_when_enabled(library):+ client = app.test_client()+ with client.session_transaction() as sess:+ sess['_user_id'] = str(library['user'])+ sess['_fresh'] = True+ real_get = __import__('src.models', fromlist=['SystemSetting']).SystemSetting.get_setting++ def get_setting(key, default=None):+ return True if key == 'enable_folders' else real_get(key, default)++ with patch('src.api.inquire.ENABLE_INQUIRE_MODE', True), \+ patch('src.api.inquire.SystemSetting.get_setting', side_effect=get_setting):+ data = client.get('/api/inquire/available_filters').get_json()+ names = {f['id']: f['recording_count'] for f in data['folders']}+ assert names == {library['a']: 2, library['b']: 1}+++def test_search_passes_the_folder_filter(library):+ client = app.test_client()+ with client.session_transaction() as sess:+ sess['_user_id'] = str(library['user'])+ sess['_fresh'] = True+ captured = {}+ with patch('src.api.inquire.ENABLE_INQUIRE_MODE', True), \+ patch('src.api.inquire.semantic_search_chunks',+ side_effect=lambda uid, q, filters, k: captured.update(filters) or []):+ resp = client.post('/api/inquire/search', json={'query': 'q', 'filter_folders': [library['a']]})+ assert resp.status_code == 200+ assert captured['folder_ids'] == [library['a']]