~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.
Python academiaanthropicarxivbravedeep-researchencryptionhome-automationhomeserverlocallocal-deep-researchlocal-llmmistralollamaopenaipubmedresearchresearch-toolretrieval-augmented-generationsearxngself-hosted
from unittest.mock import Mock
from sqlalchemy import create_engine
from sqlalchemy.orm import Session, sessionmaker
from local_deep_research.constants import ResearchStatus
from local_deep_research.database.models.queue import QueueStatus, TaskMetadata
from local_deep_research.database.models.queued_research import QueuedResearch
from local_deep_research.database.models.research import ResearchHistory
from local_deep_research.web.queue.processor_v2 import QueueProcessorV2
def test_conditional_claim_does_not_start_database_in_progress_parent() -> None:
# Given: a queue row whose parent entered IN_PROGRESS before registry registration.
engine = create_engine("sqlite:///:memory:")
QueuedResearch.__table__.create(engine)
QueueStatus.__table__.create(engine)
TaskMetadata.__table__.create(engine)
ResearchHistory.__table__.create(engine)
db_session: Session = sessionmaker(bind=engine)()
db_session.add_all(
[
QueuedResearch(
username="alice",
research_id="spawn-grace",
query="spawn-grace",
mode="quick",
position=1,
),
ResearchHistory(
id="spawn-grace",
query="spawn-grace",
mode="quick",
status=ResearchStatus.IN_PROGRESS,
created_at="2026-07-13T00:00:00+00:00",
),
TaskMetadata(
task_id="spawn-grace", status="queued", task_type="research"
),
QueueStatus(active_tasks=0, queued_tasks=1),
]
)
db_session.commit()
processor = QueueProcessorV2()
processor._start_research = Mock()
queue_service = Mock()
# When: dispatch attempts its atomic claim.
processor._start_queued_researches(
db_session, queue_service, "alice", "password", 1
)
# Then: the stale row is not claimed or spawned against the live parent.
assert db_session.query(QueuedResearch).one().is_processing is False
processor._start_research.assert_not_called()
queue_service.update_task_status.assert_not_called()
db_session.close()
engine.dispose()