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
PythonMITCreated 2025-02-09
Download: Release 2.0.0Release-2.0.0 ↓2.0.02026-11-07
+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

Discussions

Latest release

Release 2.0.0 v2.0.0 2026-11-07
LDR 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON