DeepTutor: 자료를 지식베이스로 연결하는 AI 학습 작업공간
자료를 지식베이스로 연결하고 대화, 문제 풀이, 연습, 독서와 학습 기록을 한 작업공간에서 관리하는 AI 학습 도구예요.
주요 기능
- 선택한 지식베이스를 근거로 설명·풀이·질문 생성·연구를 수행하며, 기능별 모듈과 검색 엔진을 선택해요.
- 책·몰입형 읽기·Mastery Path·문제 연습과 노트·학습 일정 등을 작업공간별로 관리해요.
- 웹 앱뿐 아니라 터미널 대화, 단일 작업 실행, NDJSON 출력과 SDK로 다른 에이전트에 연결할 수 있어요.
구조
Python 코어와 deeptutor_cli 진입점에 버전이 일치하는 기능 패키지를 붙이는 모듈형 구조예요. 전체 앱은 FastAPI 백엔드와 Next.js 16·React 19 프런트엔드를 포함해요. 기본 deeptutor 설치와 deeptutor[full]은 같지 않으며, 자료·설정은 런타임 홈에 보관해요.
누구에게 쓸모 있나요
개인 자료로 학습 환경을 만들려는 학습자·교사, AI 튜터를 자체 운영하려는 개발자에게 적합해요. 정답이나 교육 효과를 보장하는 검증된 교사 대체 서비스는 아니에요.
설치 전 준비
- pyproject.toml의 Python 범위는 >=3.11,<3.15예요. 웹 PyPI 경로는 README 기준 Node.js 20.9 이상, 소스 개발은 Node.js 22 LTS를 안내해요.
- 실제로 사용할 언어 모델과 공급자 설정이 필요하며, 임베딩·검색·음성 등은 기능에 맞는 별도 설정과 의존성이 필요해요.
- Docker 경로는 Docker와 영속 볼륨이 필요해요. CLI 코어만 사용하면 Node.js와 웹 프런트엔드가 필요하지 않습니다.
- Python CLI·SDK 및 Node 기반 웹 앱
- Docker 전체 웹 앱
- macOS·Windows 데스크톱은 dev 워크플로 아티팩트 기반 Preview로 안내; 이번 조사에서 설치 파일 실행 미검증
설치 방법
웹 앱과 CLI 설치
별도 Python 환경과 작업 폴더를 준비한 뒤 공식 PyPI 절차를 따릅니다. 아래 명령은 안내일 뿐 실행하지 않았어요.
python -m pip install -U "deeptutor[full]"
deeptutor init
deeptutor start최소 CLI 경로
bare 패키지는 코어 채팅·SDK 중심이에요. 지식베이스·연구 등은 대응 모듈이 있어야 해요.
python -m pip install -U deeptutor
deeptutor init --cli
deeptutor chat사용 방법
- 초기 설정에서 공급자·모델을 선택하고, 웹 앱은 터미널에 표시된 주소(기본 http://127.0.0.1:3782)를 엽니다.
- 주제별 작업공간을 만들고 자료와 지식베이스를 연결한 뒤 근거 인용을 원문과 대조해요.
- deeptutor doctor와 deeptutor module list로 준비 상태를 점검해요. 모듈 설치·제거 전 앱을 중지하고 런타임 홈을 백업해요.
비용과 API 키
Apache-2.0 소스는 무료로 이용할 수 있지만 선택한 모델·임베딩·검색·음성·호스팅 비용은 별도예요. README의 무료 오픈소스 설명을 무제한 무료 AI 호출로 해석하면 안 돼요.
라이선스
루트 LICENSE와 pyproject.toml에서 Apache-2.0을 확인했어요. 재배포·수정 시 라이선스 및 해당 고지를 확인해야 하며 모델·외부 서비스 약관은 별도예요.
주의사항과 알려진 이슈
- 학습 자료와 질문이 선택한 외부 모델·검색 서비스로 전송될 수 있으므로 민감한 학생 정보·저작권 자료의 업로드 범위를 먼저 정해야 해요.
- 기본 패키지에 모든 학습 기능이 포함되지 않습니다. 코어·기능 패키지 버전 불일치와 Python별 선택 의존성 제약에 유의해야 해요.
- 도구 실행·MCP·플러그인 연결은 권한 범위를 넓힙니다. 공개 서버 운영과 외부 플러그인 신뢰는 별도 검토가 필요해요.
- 데스크톱 Windows Preview는 README가 서명되지 않았다고 밝힙니다. 경고 우회를 권하지 않으며 배포 출처와 서명을 검토해야 해요.
#2374 특정 문서 범위의 RAG 검색 보고
v1.7.1에서 source_path를 넣은 텍스트 검색이 시각 자료 검사로 분기되어 실패한다는 열린 보고예요. source_path 제거는 문서 범위를 보장하는 해결책이 아니에요.
#2373 Responses 도구 결과 후속 요청 보고
reasoning 항목의 status=null로 후속 요청이 거부된다는 보고예요. 관련 PR #2376은 조사 당시 열려 있었으며 현재 main에 해결되었다고 간주하지 않았어요.
확인 범위
확인 날짜: 2026-11-02
확인 커밋: f7aed0744c36c5afef16a4261c31ebee1208cac2
확인한 범위: 공식 main 커밋, 고정 커밋의 README·LICENSE·manifest 및 공개 이슈를 읽기 전용으로 확인했어요.
확인 한계: 외부 코드·의존성 설치나 실행, 모델 호출, 로그인, 성능 측정, 전체 보안 감사는 하지 않았어요. 설치·사용법은 공식 문서의 안내이며 실기 검증 결과가 아니에요. 이슈는 보고 내용으로, 재현하거나 확정 결함으로 판정하지 않았어요.