Модульный учебный проект по Agentic RAG на LangGraph: иерархическая индексация, память диалога и уточнение запросов.
langchain-ai/local-deep-researcher
Полностью локальный веб-ассистент для исследований: выполняет циклы поиска, суммаризации и анализа пробелов с помощью LLM, запущенных через Ollama или LM Studio.
- Звёзды
- 9,378
- Форки
- 981
- Открытые issues
- 47
- Последний коммит
- 5 дней назад
Что это?
Local Deep Researcher получает тему исследования, с помощью локальной LLM формирует поисковый запрос, собирает результаты и суммирует их. Затем он анализирует получившееся резюме, выявляет пробелы в знаниях, генерирует уточняющий запрос и повторяет процесс заданное число циклов. В итоге создаётся отчёт в формате Markdown со списком использованных источников, а все собранные источники сохраняются в состоянии LangGraph.
Ассистент запускает LLM через Ollama или OpenAI-совместимый сервер LM Studio, поэтому модели работают на вашем компьютере. По умолчанию для поиска используется DuckDuckGo, не требующий API-ключа. Поиск можно переключить на SearXNG, Tavily или Perplexity с помощью переменных окружения. Для моделей, которым сложно выдавать структурированный JSON, предусмотрен механизм fallback.
Проект построен на LangGraph и запускается локально через LangGraph Studio, где можно увидеть каждый этап исследования. В комплект входит Dockerfile, но Ollama нужно запускать отдельно.
Ключевые возможности
- 01Запускает LLM локально через Ollama или LM Studio.
- 02Выполняет итеративный поиск, суммаризацию и анализ, чтобы восполнять пробелы в знаниях.
- 03По умолчанию использует DuckDuckGo; доступны также SearXNG, Tavily и Perplexity.
- 04Формирует сводку в формате Markdown со ссылками на все использованные источники.
- 05Позволяет настроить число циклов исследования и загрузку полных страниц.
Сценарии использования
- Исследовать тему, не передавая запросы и данные за пределы своего компьютера.
- Создавать прототипы многоэтапных агентов для поиска и суммаризации на LangGraph.
- Готовить справочные отчёты со ссылками на источники без платного API-ключа для поиска.
Быстрый старт
- 1
Клонируйте репозиторий
git clone https://github.com/langchain-ai/local-deep-researcher.git - 2
Перейдите в каталог проекта и скопируйте пример файла окружения
cd local-deep-researcher && cp .env.example .env - 3
Загрузите локальную модель с помощью Ollama (сначала установите приложение Ollama)
ollama pull deepseek-r1:8b - 4
Запустите сервер LangGraph с помощью uv
uvx --refresh --from "langgraph-cli[inmem]" --with-editable . --python 3.11 langgraph dev
Что важно знать
- Инструкции по настройке в README предназначены в основном для Mac и Windows, а руководство по Ollama — конкретно для Mac.
- Качество вывода зависит от локальной модели; некоторым моделям сложно генерировать требуемый структурированный вывод в формате JSON.
- Для запуска необходим локальный LLM-сервер (Ollama или LM Studio) и оборудование, достаточное для работы выбранной модели.
Темы
Частые вопросы
- Что такое local-deep-researcher?
- Полностью локальный веб-ассистент для исследований: выполняет циклы поиска, суммаризации и анализа пробелов с помощью LLM, запущенных через Ollama или LM Studio. Local Deep Researcher получает тему исследования, с помощью локальной LLM формирует поисковый запрос, собирает результаты и суммирует их. Затем он анализирует получившееся резюме, выявляет пробелы в знаниях, генерирует уточняющий запрос и повторяет процесс заданное число циклов. В итоге создаётся отчёт в формате Markdown со списком использованных источников, а все собранные источники сохраняются в состоянии LangGraph.
- local-deep-researcher можно использовать бесплатно? Какая у него лицензия?
- local-deep-researcher распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- local-deep-researcher всё ещё поддерживается?
- Активно поддерживается. Последний коммит в local-deep-researcher — 15 окт. 2026 г..
- Для чего можно использовать local-deep-researcher?
- Исследовать тему, не передавая запросы и данные за пределы своего компьютера. Создавать прототипы многоэтапных агентов для поиска и суммаризации на LangGraph. Готовить справочные отчёты со ссылками на источники без платного API-ключа для поиска.
- Как установить local-deep-researcher?
- Клонируйте репозиторий: git clone https://github.com/langchain-ai/local-deep-researcher.git Перейдите в каталог проекта и скопируйте пример файла окружения: cd local-deep-researcher && cp .env.example .env Загрузите локальную модель с помощью Ollama (сначала установите приложение Ollama): ollama pull deepseek-r1:8b Запустите сервер LangGraph с помощью uv: uvx --refresh --from "langgraph-cli[inmem]" --with-editable . --python 3.11 langgraph dev
- Где скачать local-deep-researcher?
- Исходный код и инструкции по установке — на GitHub: https://github.com/langchain-ai/local-deep-researcher
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Подборка из 28 практических руководств по переходу от прототипа GenAI-агента к продакшену: память, RAG, развёртывание, безопасность и наблюдаемость.
Самостоятельно размещаемый ИИ-второй мозг, который отвечает на вопросы по вебу и вашим документам, поддерживает пользовательских агентов и автоматизацию по расписанию.
FastGPT — платформа с открытым исходным кодом для создания AI-агентов: обработка данных, базы знаний RAG и визуальная оркестрация рабочих процессов для приложений на LLM.
Открытая платформа для создания чат-ботов на базе ИИ, которые подключают LLM к Slack, Discord, Telegram, WeChat, Lark, DingTalk и другим платформам.
Инфраструктура памяти для LLM-агентов: сохраняет диалоги и выполнение задач в структурированном виде для приложений на Python и TypeScript.