amosblomqvist/learnharness

• 무엇인지 — LearnHarness는 AI 에이전트가 학습자의 현재 이해 수준을 측정하고, 목표까지의 학습 계획을 세운 뒤, 단계별로 가르치고 연습시키며, 배운 내용을 지식 그래프로 쌓아 가는 오픈소스 데스크톱 학습 앱이다.
• 왜 지금 떴나 — 급등일인 2026-10-24 직후 기술 블로그 소개 글(10-25)과 HN 게시물(10-26)이 이어졌고, 같은 주에 v0.3.7~v0.4.1 릴리스가 연달아 나와 Copilot·Grok 로그인, Claude Code CLI, 로컬 엔드포인트 지원이 추가되었다.
• 어떤 의미인지 — 자기 API 키나 기존 구독으로 '설명만 해주는 챗봇'이 아니라 학습자 모델을 유지하는 튜터 에이전트를 로컬에서 돌려 볼 수 있으며, 시스템 프롬프트를 보고 고칠 수 있어 교육용 에이전트 설계를 참고하기 좋은 사례다.

• 2026-10-25 explainx.ai 블로그가 LearnHarness를 이번 주 GitHub 트렌딩 저장소로 소개했다. 측정·계획·교육·연습·기억의 흐름을 사용자 키로 로컬에서 실행한다는 점을 짚었다. explainx.ai (확인)
• 2026-10-25 v0.3.7이 나왔다. API 키 없이 GitHub Copilot·Grok 계정으로 로그인하는 기능과 macOS Dock 아이콘 수정이 들어갔다. GitHub 릴리스 (확인)
• 2026-10-26 Hacker News에 'LearnHarness – An Agent Harness for Learning' 게시물이 올라왔다. 같은 날 렌더링·복구·보안 수정을 담은 v0.3.8이 릴리스되었다. HN · GitHub 릴리스 (확인)
• 2026-10-27 v0.3.9가 나왔다. 받아쓰기 언어 선택, 실패한 응답 재시도, 세션 복구 안정성이 개선되었다. GitHub 릴리스 (확인)
• 2026-10-29 v0.4.0이 Claude Code CLI 연동과 OpenAI 호환 커스텀·로컬 엔드포인트 지원을 추가해 사용할 수 있는 모델 경로를 넓혔다. GitHub 릴리스 (확인)
• 2026-10-31 v0.4.1이 나왔다. 여러 파일·폴더 노트 가져오기, PDF 가져오기, 소스 폴더 정리 기능이 들어가 지식 그래프 쪽 기능이 강화되었다. GitHub 릴리스 (확인)

LearnHarness는 AI에게 설명을 받기만 해서는 어려운 내용을 제대로 이해하기 힘들다는 문제를 다룬다. 학습자가 무엇을 이해하고 있고 어떻게 추론하는지를 에이전트가 파악한 뒤, 그 상태에서 목표까지 필요한 다음 단계를 정해 가르치는 '학습용 에이전트 하네스'다.

흐름은 네 단계다. Measure 단계에서는 수업이 의존하는 각 요소에 대해 학습자의 이해가 어디서 끊기는지를 답변·확신도·사고 과정으로 찾는다. Plan 단계에서는 출발점에서 목표까지의 의존성 지도를 만들고, 이해 수준이 예상과 다르면 계획을 조정한다. Teach 단계에서는 예측 → 설명 → 확인 순서로 한 추론 단계씩 쌓으며, 오개념을 먼저 바로잡는다. Practice 단계는 별도 세션에서 개념 이름을 미리 알려주지 않은 채 다양한 문제를 내고, 학습자의 추론에 맞춰 문제와 힌트를 바꾼다. 'thinking' 입력란에 타이핑이나 받아쓰기로 자기 생각을 말로 풀어 쓰게 하는 것이 핵심 입력이다. 에이전트는 이 밖에 백그라운드 조사, 시각 자료 생성, 인터랙티브 데모 제작도 한다.

배운 내용은 명제와 추론 사슬(주장과 그 전제)로 이루어진 지속형 지식 그래프에 쌓이고, 원래 세션으로 연결된다. 다음 세션은 이 그래프를 읽고 이어서 진행하며, 외부 노트와 PDF도 가져올 수 있다. 그래프에는 능력 점수가 아니라 아이디어와 그 연결 관계를 저장한다.

구조 면에서는 TypeScript로 작성된 macOS·Windows·Linux 데스크톱 앱이다. 모델은 제공사 API 키, ChatGPT·Copilot·Grok 구독 연결, Claude Code CLI, OpenAI 호환 로컬 서버 가운데서 고른다. 대화·그래프·설정·키는 로컬 평문 파일로 저장하고, 시스템 프롬프트는 보고 편집할 수 있다. 라이선스는 AGPL-3.0이다.

• amosblomqvist/learn — 같은 저자의 개인용 'AI 학습 시스템' 설정 저장소로, LearnHarness는 이를 설치형 앱으로 일반화한 후속작으로 보인다. github.com · trendshift.io (추정)
• HugeCatLab/ChatTutor — 시각적·인터랙티브 AI 튜터를 표방한다. 반면 LearnHarness는 학습자 이해 측정과 지속형 지식 그래프를 중심에 둔다. trendshift.io · GitHub (추정)
• HumphreySun98/Smart-Study-Agent — 강화학습으로 행동을, FSRS로 복습 시점을 정하고 LLM은 퀴즈 작성에만 쓰는 Chrome 확장이다. LearnHarness는 LLM 에이전트가 계획과 교육 전반을 맡는 데스크톱 앱이라는 점이 다르다. trendshift.io · GitHub (추정)

• explainx.ai 리뷰는 어려운 주제 하나를 골라 직접 써 보면서 비용 계측기를 지켜보라고 권한다. 측정→계획→교육→연습→기억 흐름을 사용자 키로 로컬에서 돌리는 튜터로 평가했다. explainx.ai (확인)
• 강의 자료나 노트(Markdown·텍스트·PDF)를 폴더째 가져와 지식 그래프에 반영하고, 이를 바탕으로 교육·연습 세션을 이어 가는 학습 방식이 지원된다. GitHub 릴리스 · GitHub (확인)
• Ollama 같은 로컬 모델 서버나 이미 설치한 Claude Code CLI를 연결해, 추가 API 과금 없이 기존 구독이나 로컬 환경으로 튜터를 돌릴 수 있다. GitHub 릴리스 · GitHub (추정)

• AGPL-3.0이므로 코드를 수정해 네트워크 서비스로 제공하면 소스 공개 의무가 생긴다. 사내 서비스나 상용 제품에 포함하려면 라이선스 검토가 필요하다. GitHub (확인)
• 데이터는 로컬에 저장되지만 모델 요청 컨텍스트, 웹 검색, Deepgram 받아쓰기는 외부 서비스로 전송된다. 오프라인 처리가 아니므로 민감한 학습 자료는 조심해야 한다. GitHub (확인)
• Windows 설치 파일이 서명되지 않아 SmartScreen 경고가 뜬다. Copilot 무료 플랜 호환성도 아직 해결되지 않았다. 일주일 사이 릴리스가 연달아 나오며 복구·렌더링 버그를 고치는 중이라 초기 단계 소프트웨어로 보는 것이 맞다. GitHub · GitHub 릴리스 · GitHub 릴리스 · GitHub 릴리스 (추정)
• 개인 계정 저장소이고 저자의 다른 저장소도 개인 설정 위주라, 유지보수가 한 사람에게 쏠려 있을 가능성이 있다. github.com (추정)

• 2026-11-02 처음 작성 — 기준일 2026-10-31 · 근거 28건

• E1 amosblomqvist/learnharness — GitHub
• E2 amosblomqvist/learnharness 0.4.1 — GitHub 릴리스 · 2026-10-31
• E3 amosblomqvist/learnharness 0.4.0 — GitHub 릴리스 · 2026-10-29
• E4 amosblomqvist/learnharness 0.3.9 — GitHub 릴리스 · 2026-10-27
• E5 amosblomqvist/learnharness 0.3.8 — GitHub 릴리스 · 2026-10-26
• E6 amosblomqvist/learnharness 0.3.7 — GitHub 릴리스 · 2026-10-25
• E7 LearnHarness – An Agent Harness for Learning — HN · 2026-10-26
• E9 LearnHarness: Free AI Tutor Harness, 1.5k Stars in 9 Days | explainx.ai Blog | explainx.ai — explainx.ai · 2026-10-25
• E10 amosblomqvist (Eero Alvar) · GitHub — github.com · 2026-05-03
• E11 amosblomqvist/learn — GitHub trending stats & insights | Trendshift — trendshift.io · 2026-10-11