AbdullahAlhariri/penmentor

어떤 프로젝트인가요?

핵심 기능

• 01화면에 손글씨 풀이를 표시하고, 처음 발견한 실수에는 동그라미를, 맞는 줄에는 체크 표시를 합니다.
• 02정답을 통째로 알려주는 대신 단계별 힌트를 제공합니다.
• 03페이지에서 상자로 선택한 영역을 바탕으로 상호작용형 manim 애니메이션을 생성합니다.
• 04모델 접두사를 통해 Claude Code, Codex, Antigravity CLI와 연동합니다.
• 05모델이 페이지 전체를 확인할 수 있도록 xournal++ 플러그인을 제공합니다.
• 06기억 확인 질문과 오류 찾기 연습을 제공합니다.

활용 사례

• xournal++에서 펜 태블릿으로 미적분이나 다른 수학 문제를 손으로 풀며 공부하기.
• 풀이를 채팅 창에 복사하지 않고 과제 풀이 단계에 대한 피드백 받기.
• 적분이나 극한 같은 개념을 상호작용형 애니메이션으로 시각화하기.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/AbdullahAlhariri/penmentor ~/src/penmentor
2. 2

   셀프 테스트를 실행합니다

   ~/src/penmentor/bin/penmentor --selftest
3. 3

   윈도우 매니저에서 bin/penmentor를 키에 바인딩합니다(i3 예시와 가이드 참조)

사용 전 알아둘 점

• !Linux의 X11에서만 작동하며, i3에서 가장 잘 작동합니다.
• !설치되어 로그인된 에이전트 CLI(claude, codex 또는 agy)와 rofi, slop, xdotool, PyQt6가 필요합니다.
• !README에 설명된 xournal++ 워크플로를 통해 작동합니다.

토픽

자주 묻는 질문

penmentor은(는) 무엇인가요?

손글씨 풀이에 답 대신 힌트를 표시하고, manim으로 개념을 애니메이션화하는 AI 수학 멘토입니다. penmentor는 손으로 수학을 공부할 때 사용하는 데스크톱 도우미입니다. 펜 태블릿에 풀이를 작성하다가 키를 누르면 현재 페이지가 AI 모델로 전송되고, 모델은 선생님이 색깔 펜으로 표시하듯 화면에 피드백을 남깁니다. 처음 발견한 실수에는 동그라미를 치고, 맞는 줄에는 체크 표시를 하며, 그 실수에 영향을 받는 이후 단계에는 밑줄을 긋습니다. 힌트는 가벼운 도움말부터 풀이 기법을 알려주는 단계까지 차례로 제공하며, 기억을 확인하는 질문이나 오류 찾기 연습도 요청할 수 있습니다.

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

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

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

활발히 유지보수 중. penmentor의 마지막 커밋은 2026년 10월 20일입니다.

penmentor은(는) 어디에 사용할 수 있나요?

xournal++에서 펜 태블릿으로 미적분이나 다른 수학 문제를 손으로 풀며 공부하기. 풀이를 채팅 창에 복사하지 않고 과제 풀이 단계에 대한 피드백 받기. 적분이나 극한 같은 개념을 상호작용형 애니메이션으로 시각화하기.

penmentor는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/AbdullahAlhariri/penmentor ~/src/penmentor 셀프 테스트를 실행합니다: ~/src/penmentor/bin/penmentor --selftest 윈도우 매니저에서 bin/penmentor를 키에 바인딩합니다(i3 예시와 가이드 참조)

penmentor은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/AbdullahAlhariri/penmentor