deer-flow

DeerFlow(Deep Exploration and Efficient Research Flow)는 ByteDance가 만든 오픈소스 "슈퍼 에이전트 하네스"입니다. 하위 에이전트, 장기 메모리, 샌드박스 실행, 확장 가능한 스킬을 조율하여 심층 연구, 코딩, 콘텐츠 제작처럼 수 분에서 수 시간이 걸릴 수 있는 장기 작업을 처리합니다. 버전 2.0은 처음부터 다시 작성되었으며 1.x 브랜치와 코드를 공유하지 않습니다. 원래의 심층 연구 프레임워크는 별도로 유지 관리됩니다. 이 프로젝트는 최소한의 config.yaml과 .env를 생성하는 설정 마법사(make setup), make doctor 진단, 이슈 보고를 위한 support-bundle 명령을 제공합니다. 개발 또는 프로덕션용 Docker Compose(make docker-start, make up)로 실행하거나, Node.js 22+, pnpm, uv, nginx와 함께 로컬(make dev)로 실행할 수 있습니다. 배포 규모 가이드는 로컬 평가, Docker 개발, 장기 실행 서버를 다룹니다. LangChain OpenAI 호환 ChatOpenAI, OpenAI Responses API, CLI 기반 제공자(Codex CLI, Claude Code OAuth), 로컬 모델용 vLLM, OpenRouter 게이트웨이를 통해 다양한 LLM 제공자를 지원합니다. 모델별 설정에는 추론/사고 토글, 노력 수준, API 키, 기본 URL, 가격이 포함됩니다. 핵심 기능에는 Claude Code 통합이 포함된 확장 가능한 Skills & Tools 시스템, 세션 목표, 수동 컨텍스트 압축, 하위 에이전트, 샌드박스 및 파일 시스템 격리, 컨텍스트 엔지니어링, 장기 메모리가 있습니다. 또한 MCP 서버 지원, IM 채널 통합, LangSmith, Langfuse 또는 Monocle을 통한 선택적 추적, 여러 제공자 사용, 개인 액세스 토큰, 예약 작업, 내장 Python 클라이언트, 터미널 워크벤치(TUI)를 제공합니다. 웹 UI는 http://localhost:2026에서 제공되며 HttpOnly 세션 쿠키를 사용한 브라우저 로그인이 필요합니다. 프로덕션 다중 워커 배포에는 Postgres와 Redis 스트림 브리지가 필요합니다. README에는 부적절한 배포가 보안 위험을 초래할 수 있다는 보안 경고와 권장 사항이 포함되어 있습니다. Doubao-Seed-2.0-Code, DeepSeek v3.2, Kimi 2.5와 같은 모델로 실행할 것을 권장하며, 웹/이미지 검색 및 크롤링을 위해 BytePlus InfoQuest를 통합합니다. 이 프로젝트는 MIT 라이선스이며 기여 가이드라인과 문서 링크를 포함합니다.