LearningCircuit /local-deep-research
~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.
★ 9,584⑂ 925👁 38⑃ 6,569● 2,113▤ 173
+1
Daily
9,584
stars
925
forks
38
watchers
6,569
prs
2,113
issues
173
releases
README
Local Deep Research AI-powered research assistant for deep, agentic research Performs deep, agentic research using multiple LLMs and search engines with proper citations 🧪 First open-source project — fully-local on a single RTX 3090 (Qwen3.6-27B) — to report ~95% SimpleQA (n=500) and 77% xbench-DeepSearch (n=100) on local hardware. See the r/LocalLLaMA announcement and the benchmark dataset. ▶️ Watch Review by The Art Of The Terminal 🚀 What is Local Deep Research? AI research assistant you control. Run locally for privacy, use any LLM and build your own searchable knowledge base. You own your data and see exactly how it works. ⚡ Quick Start Option 1: Docker Run (Linux) bash Step 1: Pull and run Ollama docker run -d -p 11434:11434 --name ollama ollama/ollama docker exec ollama ollama pull gpt-oss:20b Step 2: Pull and run SearXNG for optimal search results docker run -d -p 8080:8080 --name searxng searxng/searxng Step 3: Pull and run Local Deep Research (the URL line pins SearXNG's address AND marks it operator-approved — private/localhost engine URLs are otherwise blocked by default since v1.10.3. The URL becomes read-only in the web UI; docs/SearXNG-Setup.md lists the alternatives, e.g. an origin allowlist.) docker run -d --network host \ --name local-deep-research \ --volume "deep-research:/data" \ -e LDR_DATA_DIR=/data \ -e LDR_SEARCH_ENGINE_WEB_SEARXNG_DEFAULT_PARAMS_INSTANCE_URL=http://localhost:8080 \ localdeepresearch/local-deep-research Mac / Windows / WSL2 users: --network host only works on native Linux. On Docker Desktop it silently fails to publish port 5000 and leaves localhost pointing at the LDR container itself (so it can't reach Ollama/SearXNG). Use Option 2 below, or see the Windows/WSL2 FAQ entry for a working docker run recipe. Option 2: Docker Compose CPU-only (all platforms): bash curl -O https://raw.githubusercontent.com/LearningCircuit/local-deep-research/main/docker-compose.yml && docker compose up -d With NVIDIA GPU (Linux): bash curl -O https://raw.githubusercontent.com/LearningCircuit/local-deep-research/main/docker-compose.yml && \ curl -O https://raw.githubusercontent.com/LearningCircuit/local-deep-research/main/docker-compose.gpu.override.yml && \ docker compose -f docker-compose.yml -f docker-compose.gpu.override.yml up -d Open http://localhost:5000 after ~30 seconds. For GPU setup, environment variables, and more, see the Docker Compose Guide. Option 3: pip install bash pip install local-deep-research python -m local_deep_research.web.app starts the web UI on http://localhost:5000 You'll also need Ollama (or any OpenAI-compatible LLM endpoint) and SearXNG running — see the pip install guide for the full recipe. Works on Windows, macOS, and Linux. SQLCipher encryption is included via pre-built wheels — no compilation needed. PDF export on Windows requires Pango (setup guide). Development fallback: LDR_BOOTSTRAP_ALLOW_UNENCRYPTED=tru
Top issues
#7874Auto Researcher (#4448, after merge): deferred low-severity findings from adversarial gate round 128 comments · 2026-10-24#4964Notes (#3277): post-merge follow-ups21 comments · 2026-07-04#7137v2.0.0 release tracker16 comments · 2026-10-03#4961Zotero page UX: smoother collection selection and friendlier sync feedback14 comments · 2026-07-04#6300Legacy DBs (documents table created by v1.3.0–v1.3.58 installs): documents.resource_id FK is CASCADE — bulk history deletes can fire it on divergent rows11 comments · 2026-09-06#3826Huge memory leak from LDR - my host ran out of memory and became unresponsive :(11 comments · 2026-05-06#6640report_generator: detailed-mode discards initial research synthesis and only passes 1000 chars to outline planner10 comments · 2026-09-19#6569bug(search): global search.max_results silently overwrites per-engine default_params.max_results for all engines10 comments · 2026-09-17
Discussions
#8536A month of sponsored agent usage for local-deep-research contributors0 comments · 2026-11-11#4378Share with other users2 comments · 2026-05-28#4017Add fireworks support0 comments · 2026-05-11#2696[Feature Request] - API Testing0 comments · 2026-03-11#2691Configuration WebUI1 comments · 2026-03-11#2445OIDC?2 comments · 2026-02-26#2444MFA?2 comments · 2026-02-26#2443How to manage users, particularly delete one?2 comments · 2026-02-26
Latest release
Release 2.0.0 v2.0.0 2026-11-07LDR 2.0 LDR 2.0 is our biggest architectural change yet. We rebuilt the web layer on FastAPI and Uvicorn, hardened security across the whole app, added new search engines, and made Stop actually stop research mid-generation. It took 1,010 commits in ten weeks, from 40 contributors, 31 of them new to the project. Thank you to everyone who built, tested and reported issues. Several defaults and API contracts changed. Read the upgrade notes before deploying, especially if you run LDR behind a reverse proxy or call its HTTP API from your own clients. ⚠️ Before you upgrade - Take a ver