DeepTutor 1.7부터 기본 설치는 코어만…웹앱은 `deeptutor[full]`로 설치

본문

DeepTutor가 2026년 10월 28일 공개한 1.7.0에서 설치 구성을 모듈형으로 바꿨습니다. 이제 기본 deeptutor 패키지는 코어 채팅과 CLI, SDK를 제공하고 웹앱과 표준 기능 모듈을 포함하는 전체 설치는 deeptutor[full]로 선택합니다. 설치·활성화 상태는 deeptutor module list에서 확인하며, 코어와 기능 모듈의 버전은 서로 맞아야 합니다.

업그레이드 경로와 데이터

웹앱을 쓰는 사용자는 실행 중인 DeepTutor를 멈추고 런타임 홈을 백업한 뒤 python -m pip install --upgrade "deeptutor[full]==1.7.0"을 실행하는 것이 릴리스 안내입니다. 이어 python -m pip check와 deeptutor module list로 설치 상태를 확인하고, 기존 DEEPTUTOR_HOME을 유지해 다시 시작합니다. 패키지를 제거해도 설정과 대화 기록 등 런타임 홈의 데이터는 남습니다.

기존 deeptutor-cli 패키지가 설치돼 있다면 새 코어나 전체 설치를 하기 전에 python -m pip uninstall deeptutor-cli를 먼저 실행해야 합니다. 구 CLI가 새 코어와 공유하는 파일을 소유해 같은 업그레이드 작업에서 함께 갱신하면 새 코어에 필요한 파일이 제거될 수 있다고 프로젝트가 설명합니다. 새 버전에서 deeptutor-cli는 호환용 별칭으로 다시 설치할 수 있습니다.

바뀐 기능과 범위

1.7.0에는 학습 워크스페이스 개편, 블록 단위 노트와 Dito를 통한 문장별 학습 지원, 내레이션을 넣은 비디오 레슨이 포함됩니다. 비디오 레슨을 만들려면 백엔드에 Node.js 22 이상과 npm이 필요하며, 내레이션을 사용할 수 없는 경우 자막을 유지한 채 소리 없이 재생합니다. 릴리스 노트는 튜터링과 색인 안정성 개선도 언급하지만, 이전 버전과 비교한 독립 성능 수치는 제시하지 않습니다.

자료: GitHub / 정리·해설: Trawling

참고 자료

• Release v1.7.0 · HKUDS/DeepTutor · GitHub — https://github.com/HKUDS/DeepTutor/releases/tag/v1.7.0