기술

AI 과외 선생님 오픈소스 DeepTutor, 한국어 화면 미리보기까지

내 자료로 공부 계획, 퀴즈, 풀이, 영상 강의를 만드는 AI 학습 공간 DeepTutor. 11월 6일 v1.7.2의 한국어 화면 미리보기, 공부 모드, 설치 방법 세 가지, 모델 설정과 주의점을 정리했습니다.

HKUDS/DeepTutor는 과외, 조사, 만들기, 연습을 한 시스템에 묶은 AI 학습 공간입니다. Apache-2.0 라이선스이고 2026년 11월 7일 기준 깃허브 스타 55,952개입니다. 11월 6일에 나온 v1.7.2에는 데스크톱 설치 파일, 선택한 글 읽어 주기, 쉬워진 모델 설정과 함께 한국어 화면 미리보기가 들어갔습니다.

무엇을 하나

  • 여러 공부 모드: 대화, 질문하기, 퀴즈, 조사(출처가 붙은 보고서), 풀이, 시각화, 영상 강의, 학습 경로, 읽기가 같은 맥락을 공유하며 이어집니다.
  • 내 자료로 공부: PDF, 영상, 오디오를 지식 창고로 쌓고, 답할 때 출처를 붙입니다. 책에서 바로 퀴즈를 내기도 합니다.
  • 정리 도구: 할 일 보드, 캘린더, 학습 노트가 있고, Anki 카드와 캘린더 일정(.ics)으로 내보냅니다.
  • 보이는 기억: 튜터가 나에 대해 기억한 것을 기록, 사실, 종합 세 층으로 나눠 메모리 그래프에 보여 주고, 근거를 따라가 고칩니다.
  • 다른 에이전트와 함께: Claude Code, Codex 같은 에이전트에게 물어보거나, 기억과 자료를 가진 동료(Partner)를 따로 둡니다.

설치 세 가지

방법이럴 때
데스크톱 앱(미리보기)macOS(Apple Silicon·Intel), Windows. 터미널 없이 설치. 릴리스 페이지에서 받기
Docker파이썬, Node 없이 웹 앱 전체를 바로 써 보기
pip웹 앱과 CLI를 내 환경에 설치
docker run --rm --name deeptutor -p 127.0.0.1:3782:3782 \
  -v deeptutor-data:/app/data ghcr.io/hkuds/deeptutor:latest
python -m pip install -U "deeptutor[full]"   # Python 3.11~3.14, Node.js 20.9+
deeptutor init
deeptutor start

브라우저에서 http://127.0.0.1:3782를 엽니다. Windows 미리보기 빌드는 서명이 없어 SmartScreen 경고가 뜰 수 있다고 README가 밝힙니다.

쓰기 전에

  • 모델은 내가 연결합니다. 앱을 켠 뒤 설정에서 쓸 AI 서비스와 모델, 키를 넣어야 합니다. 비용은 그 서비스에 냅니다.
  • 한국어 화면은 아직 미리보기입니다. 번역이 덜 된 곳이 있을 수 있습니다.
  • 이미지, 영상 생성은 해당 생성 모델을 따로 설정해야 켜집니다.

오늘 할 일

시험 범위 PDF 하나를 넣고 퀴즈부터 만들어 보세요. 결과를 보고 학습 경로(Mastery Path)로 이어 가 보세요.

쇼츠로 보기

이 글은 비치콤버스 쇼츠 No.53의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/53.

김현빈 Developer & Writer

기술, 포스팅 관련 질문, 프로젝트 협업 등 연락주시면 언제든지 회신 드립니다.

esc

↑↓ 고르기↵ 열기? 단축키

해변에서 주운 것

읽으러 가기 →
guest@beachcombers — zsh

단축키

⌘K 또는 /
글·작업·개발일지 찾기
R
해변 산책 — 아무 글 하나 줍기
`
터미널 열기
←→
쪽 넘기기 (휠·스와이프도 됩니다)
?
이 안내
esc
닫기