zilliztech/deep-searcher

어떤 프로젝트인가요?

핵심 기능

• 01비공개 문서를 대상으로 여러 단계의 검색, 평가, 추론을 수행합니다.
• 02Milvus, Zilliz Cloud, Qdrant를 비롯한 벡터 데이터베이스와 연동합니다.
• 03OpenAI, DeepSeek, Claude, Gemini, Ollama 등 다양한 LLM 공급자를 지원합니다.
• 04로컬 PDF, 텍스트, Markdown 파일을 불러오고 FireCrawl, Crawl4AI 같은 크롤러를 통해 웹 페이지도 수집합니다.
• 05Python API, CLI, FastAPI 웹 서비스를 제공합니다.

활용 사례

• 사내에 보관해야 하는 회사 문서를 바탕으로 내부 질의응답 도우미를 구축합니다.
• PDF와 메모 모음에서 리서치 형식의 보고서를 생성합니다.
• Ollama를 통해 로컬 모델로 지식 베이스를 검색해 완전히 오프라인으로 사용합니다.
• 교체 가능한 LLM과 임베딩 모델을 활용해 검색 증강 생성 파이프라인을 프로토타이핑합니다.

빠른 시작

1. 1

   가상 환경을 만들고 활성화합니다

   python -m venv .venv && source .venv/bin/activate
2. 2

   pip로 DeepSearcher를 설치합니다

   pip install deepsearcher
3. 3

   OPENAI_API_KEY 환경 변수를 설정한 다음 README의 빠른 시작 Python 데모를 실행합니다

사용 전 알아둘 점

• !LLM API 키(예: OpenAI) 또는 Ollama처럼 로컬에서 실행되는 모델이 필요합니다.
• !Milvus 또는 Zilliz Cloud와 같은 벡터 데이터베이스가 필요해 설정 작업이 추가됩니다.
• !문서 웹 크롤링 기능은 아직 개발 중이며 FIRECRAWL_API_KEY가 필요합니다.

토픽

자주 묻는 질문

deep-searcher은(는) 무엇인가요?

LLM과 벡터 데이터베이스를 활용해 비공개 데이터를 검색하고 추론하는 오픈소스 심층 리서치 도구입니다. DeepSearcher는 비공개 데이터를 대상으로 질의응답과 보고서 생성을 지원하는 Python 프로젝트입니다. OpenAI, Qwen, DeepSeek, Claude, Llama 같은 대규모 언어 모델을 Milvus, Zilliz Cloud 같은 벡터 데이터베이스와 결합해, 질문을 여러 단계로 나누고 자체 문서를 검색한 뒤 결과를 종합해 답변합니다.

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

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

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

활발히 유지보수 중. deep-searcher의 마지막 커밋은 2026년 9월 22일입니다.

deep-searcher은(는) 어디에 사용할 수 있나요?

사내에 보관해야 하는 회사 문서를 바탕으로 내부 질의응답 도우미를 구축합니다. PDF와 메모 모음에서 리서치 형식의 보고서를 생성합니다. Ollama를 통해 로컬 모델로 지식 베이스를 검색해 완전히 오프라인으로 사용합니다. 교체 가능한 LLM과 임베딩 모델을 활용해 검색 증강 생성 파이프라인을 프로토타이핑합니다.

deep-searcher는 어떻게 설치하나요?

가상 환경을 만들고 활성화합니다: python -m venv .venv && source .venv/bin/activate pip로 DeepSearcher를 설치합니다: pip install deepsearcher OPENAI_API_KEY 환경 변수를 설정한 다음 README의 빠른 시작 Python 데모를 실행합니다

deep-searcher은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zilliztech/deep-searcher