{"full_name":"LearningCircuit/local-deep-research","owner":"LearningCircuit","name":"local-deep-research","shard":"1","url":"https://github.com/LearningCircuit/local-deep-research","description":" ~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.","homepage":"","topics":["academia","arxiv","brave","deep-research","local","local-llm","mistral","pubmed","research","research-tool","retrieval-augmented-generation","searxng","self-hosted","local-deep-research","home-automation"],"tag_pages":["arxiv","deep-research","home-automation","local","local-llm","mistral","research","retrieval-augmented-generation","searxng","self-hosted"],"language":"Python","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/185559241?v=4","created_at":"2025-02-09T15:41:32Z","pushed_at":"2026-11-15T16:11:33Z","metrics":{"stars":9584,"forks":925,"watchers":38,"issues":2113,"prs":6569,"releases":173,"issues_open":1130,"issues_closed":983,"prs_open":331,"prs_closed":836,"prs_merged":5402,"discussions":21},"growth":{"day":{"stars":1,"forks":3,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[9556,9566,9565,9567,9578,9583,9584],"forks":[911,911,913,916,921,922,925],"watchers":[null,39,38,38,38,38,38],"issues_open":[null,1088,1101,1107,1145,1143,1130],"prs_open":[null,325,344,344,344,326,331]},"boards":{},"same_owner":[],"issues":[{"number":7874,"title":"Auto Researcher (#4448, after merge): deferred low-severity findings from adversarial gate round 1","comments":28,"created_at":"2026-10-24T18:54:42Z"},{"number":4964,"title":"Notes (#3277): post-merge follow-ups","comments":21,"created_at":"2026-07-04T22:48:47Z"},{"number":7137,"title":"v2.0.0 release tracker","comments":16,"created_at":"2026-10-03T21:21:02Z"},{"number":4961,"title":"Zotero page UX: smoother collection selection and friendlier sync feedback","comments":14,"created_at":"2026-07-04T18:52:07Z"},{"number":6300,"title":"Legacy 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 rows","comments":11,"created_at":"2026-09-06T19:44:05Z"},{"number":3826,"title":"Huge memory leak from LDR - my host ran out of memory and became unresponsive :(","comments":11,"created_at":"2026-05-06T13:52:51Z"},{"number":6640,"title":"report_generator: detailed-mode discards initial research synthesis and only passes 1000 chars to outline planner","comments":10,"created_at":"2026-09-19T12:53:33Z"},{"number":6569,"title":"bug(search): global search.max_results silently overwrites per-engine default_params.max_results for all engines","comments":10,"created_at":"2026-09-17T16:46:53Z"}],"discussions":[{"number":8536,"title":"A month of sponsored agent usage for local-deep-research contributors","comments":0,"category":"General","created_at":"2026-11-11T09:24:41Z"},{"number":4378,"title":"Share with other users","comments":2,"category":"Ideas","created_at":"2026-05-28T05:05:30Z"},{"number":4017,"title":"Add fireworks support","comments":0,"category":"Ideas","created_at":"2026-05-11T21:42:14Z"},{"number":2696,"title":"[Feature Request] - API Testing","comments":0,"category":"Ideas","created_at":"2026-03-11T18:22:53Z"},{"number":2691,"title":"Configuration WebUI","comments":1,"category":"General","created_at":"2026-03-11T09:38:22Z"},{"number":2445,"title":"OIDC?","comments":2,"category":"Ideas","created_at":"2026-02-26T13:50:14Z"},{"number":2444,"title":"MFA?","comments":2,"category":"Q&A","created_at":"2026-02-26T13:49:08Z"},{"number":2443,"title":"How to manage users, particularly delete one?","comments":2,"category":"Q&A","created_at":"2026-02-26T13:46:34Z"}],"latest_release":{"name":"Release 2.0.0","tag":"v2.0.0","published_at":"2026-11-07T20:10:39Z","body":"## LDR 2.0\r\n\r\n**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.\r\n\r\nSeveral 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.\r\n\r\n### ⚠️ Before you upgrade\r\n\r\n- **Take a verified offline backup first.** 2.0 changes your databases, and v1.10.7 can't use them afterwards. LDR's built-in backups aren't a substitute (see the next point). Never start v1.10.7 on upgraded data, because doing so can delete your remaining built-in backups. Follow the [upgrade and rollback guide](https://github.com/LearningCircuit/local-deep-research/blob/main/docs/deployment/upgrading.md), which also covers failed upgrades.\r\n- **Pre-migration backups now live in their own folder.** Each user gets `encrypted_databases/backups/<user hash>/pre-migration/`. Copy that folder out of the data directory after each user's first sign-in. With the default retention (1 backup, 7 days), the first login backup after the upgrade removes the regular backups made before it. Raise **Max Backups** and **Backup Retention (days)** first if you want to keep them.\r\n- **Check your settings and environment overrides.** Invalid configured values now raise an error instead of silently falling back to a default. This includes bad `LDR_*` booleans (only `true/1/yes/on/enabled` and `false/0/no/off/disabled` are accepted), `llm.request_timeout` below 1 second, and `llm.max_retries` outside 0–5. The settings page, research form and API errors name the offending key.\r\n- **Everyone must sign in again** after upgrading.\r\n\r\n### Breaking changes for operators\r\n\r\n- **Reverse proxies:**\r\n  - If a trusted proxy terminates TLS, set `TRUST_PROXY_HEADERS=true` and block direct access to the backend.\r\n  - Rate limiting now trusts forwarded headers only from private or loopback peers.\r\n  - A proxy on a public or CGNAT address (cloud load balancers, Tailscale) needs `LDR_SERVER_FORWARDED_ALLOW_IPS` set to its address. Otherwise all clients behind it share one rate-limit bucket and one login-lockout counter.\r\n  - A single proxy must *overwrite* `X-Forwarded-For` and `X-Real-IP`, not append to them.\r\n  - Proxy chains (for example CDN → nginx) can use the new `LDR_SERVER_TRUSTED_PROXY_COUNT`. See \"Proxy chains\" in `docs/deployment/reverse-proxy.md`.\r\n- **Socket.IO moved** from `/socket.io` to `/ws/socket.io`. Update any explicit proxy `location` rules and custom clients.\r\n- **Direct (non-container) launches bind to `127.0.0.1`.** Set `LDR_WEB_HOST=0.0.0.0` if you want remote access. Docker images already set this.\r\n- **Research-library storage path is operator-managed.** Users can no longer change it in Settings. Use `LDR_RESEARCH_LIBRARY_STORAGE_PATH` instead. The legacy shared-directory PDF read fallback has been removed.\r\n- **LAN notification targets** (self-hosted Apprise plugins on private hosts) now need `LDR_NOTIFICATIONS_ALLOW_PRIVATE_IPS=true`, plus an egress scope that permits the host.\r\n- **Linux servers are now non-dumpable.** They write no core dumps, and same-user `py-spy`, `gdb` and `lsof` no longer work against them. Startup fails if a seccomp profile denies `prctl`.\r\n- **Non-Docker installs must install NLTK data once.** Uploaded Office, HTML and email documents are now parsed in bounded child processes, which need the `punkt_tab` and `averaged_perceptron_tagger_eng` packages. The Docker image ships them.\r\n- **FAISS indexes convert on their next write.** No re-embedding is needed. Older LDR versions must rebuild a converted index before they can read it.\r\n\r\n### Breaking changes for API clients\r\n\r\n- **CSRF tokens are now required** for session-authent","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}