langchain-ai/local-deep-researcher

어떤 프로젝트인가요?

핵심 기능

• 01Ollama 또는 LM Studio를 통해 LLM을 로컬에서 실행합니다.
• 02반복 검색, 요약, 검토를 통해 지식 공백을 보완합니다.
• 03기본 검색 엔진은 DuckDuckGo이며, SearXNG, Tavily 또는 Perplexity도 선택할 수 있습니다.
• 04사용한 모든 출처를 인용한 Markdown 요약을 출력합니다.
• 05리서치 반복 횟수와 전체 페이지 가져오기를 설정할 수 있습니다.

활용 사례

• 프롬프트와 데이터를 로컬에 보관하면서 주제를 조사할 때
• LangGraph를 활용한 다단계 검색·요약 에이전트를 프로토타이핑할 때
• 유료 검색 API 키 없이 출처가 포함된 배경 조사 보고서를 만들 때

빠른 시작

1. 1

   리포지토리를 클론합니다

   git clone https://github.com/langchain-ai/local-deep-researcher.git
2. 2

   프로젝트 디렉터리로 이동해 예제 환경 파일을 복사합니다

   cd local-deep-researcher && cp .env.example .env
3. 3

   Ollama로 로컬 모델을 가져옵니다(Ollama 앱을 먼저 설치하세요)

   ollama pull deepseek-r1:8b
4. 4

   uv로 LangGraph 서버를 시작합니다

   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은(는) 무엇인가요?

Ollama 또는 LM Studio에서 실행하는 LLM으로 반복 검색, 요약, 지식 공백 검토를 수행하는 완전한 로컬 웹 리서치 도우미입니다. Local Deep Researcher는 조사 주제를 입력받아 로컬 LLM으로 웹 검색어를 만들고, 검색 결과를 수집해 요약합니다. 그런 다음 요약을 검토해 부족한 지식을 파악하고, 이를 보완할 후속 검색어를 생성한 뒤 설정된 횟수만큼 이 과정을 반복합니다. 최종 결과는 사용한 출처가 포함된 Markdown 보고서이며, 수집한 출처는 모두 LangGraph state에 보관됩니다.

local-deep-researcher은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

local-deep-researcher은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

local-deep-researcher은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. local-deep-researcher의 마지막 커밋은 2026년 10월 15일입니다.

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 uv로 LangGraph 서버를 시작합니다: 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