LLM_WIKI

Andrej Karpathy의 LLM Wiki 패턴을 Markdown + MCP 도구 + 그래프 뷰어로 구현한 재사용 가능한 템플릿이다. clone 한 뒤 자기 자료를 넣으면, AI agent가 읽고 정리해 링크로 연결된 지식 그래프 위키로 쌓아 준다.

핵심 아이디어: 자료를 매번 다시 검색·요약하는 대신, LLM이 한 번 읽고 지속 갱신되는 위키 페이지로 축적한다. 요약·링크·반론·미해결 질문이 채팅에서 사라지지 않고 파일로 남는다.

위: 실제 지식베이스가 그래프 뷰어에 렌더링된 화면 (노드=페이지, 색=도메인, 엣지=Related 링크).

30분 퀵스타트 — 자료 1건으로 첫 위키 페이지 만들기

처음 보는 사람이 30분 안에 자기 자료 1건 → 첫 위키 페이지 → 화면 확인까지 가는 경로다.

0. 사전 요구

• Python ≥ 3.10 (python --version), Git. 그 외 설치 없음(뷰어·챗봇은 표준 라이브러리만).
• (챗봇 답 생성용) 로그인된 claude CLI. 없어도 그래프·페이지·검색은 정상 동작.

1. 실행 — 설치 불필요 (clone-and-run)

→ ** 에 그래프·페이지·검색 + 챗봇 탭. pip install 없이 바로 뜬다. 어느 머신·어느 클론 위치든 동일.

2. 자기 자료 넣기

처리할 자료를 Markdown으로 inbox/에 둔다. (논문 요약, 강의 노트, 문서 발췌 등 무엇이든)

3. agent로 위키화 (통합 요청)

Claude(Code/Desktop)에 자연어로 요청:

"inbox/my-first-source.md를 ingest 해줘. sources/에 출처 노트 만들고 wiki/concepts/에 개념 페이지 생성해."

• 무설치 경로: Claude가 페이지 템플릿 형식으로 파일을 직접 작성(제목 아래 Domain: ... · Maturity: ... 한 줄 필수). 또는 /wiki-keeper 스킬로 절차 진행. pip 불필요.
• 선택 — MCP tool 연결: cd mcp-wiki && pip install -e . 후 Claude Desktop에 등록(mcp-wiki/README §4.3) → create_page 등 tool이 index.md·log.md를 자동 반영. (권한·역할: 에이전트 사양 — Wiki Guide=읽기·질의, Wiki Keeper=편집.)

4. 화면에서 확인

§1의 serve_all이 떠 있으면 브라우저 새로고침 → 새 페이지가 그래프 노드로 뜨고 도메인 색·maturity 필터·검색이 동작하면 성공. 챗봇 탭에서 질문하면 위키 근거로 답한다(별도 포트·API 키 없음 — 로컬 claude CLI 사용).