LLM Wiki

내 문서들을 상호 연결된 위키형 지식 베이스로 자동 정리하는 프로젝트입니다. Andrej Karpathy의 LLM Wiki 패턴을 따릅니다.

핵심 비유: 내 PDF·문서는 소스 코드, 정리된 위키는 컴파일된 결과물. 매번 검색하는 RAG와 달리, 문서를 한 번 위키로 정리해 두고 질문 때는 위키를 읽습니다. 새 문서를 넣을 때마다 기존 위키에 병합되어 지식이 누적됩니다.

이 프로젝트의 동작 방식 (중요)

별도의 앱을 설치/배포하지 않습니다. 이 폴더 자체가 위키 작업공간이고, 로컬 Claude Code 가 "컴파일러" 역할을 합니다.

• 무거운 일(문서→텍스트 변환, 파일 검색)은 tools/의 파이썬 스크립트가 합니다.
• 정리(분석 → 위키 페이지 작성/병합)는 Claude Code가 직접 합니다 — .claude/skills/llm-wiki 스킬에 그 방법이 적혀 있습니다.
• 그래서 API 키 설정이 필요 없습니다. Claude Code에게 한국어로 시키면 됩니다.

purpose.md / schema.md   ← ① 스키마: 위키의 목적·규칙 (먼저 편집)
raw/sources/             ← ② 원본 문서 (불변, 보관용)
raw/extracted/           ← 문서에서 뽑은 텍스트 (에이전트가 읽는 입력)
wiki/                    ← ③ 컴파일된 위키 (concepts/ entities/ sources/)
tools/                   ← 파이썬 도구 (ingest / find_docs / reindex)
.claude/skills/llm-wiki/ ← 컴파일 절차를 담은 Claude Code 스킬
desktop-viewer/          ← (선택) 예전에 만든 Electron GUI 뷰어

시작하기

🪟 Windows 사용자는 docs/SETUP-Windows.md 의 단계별 가이드를 따르세요 (Claude Code 설치 + setup.bat 자동 설치 포함).

0. 준비 (한 번만)

git clone <이 저장소> && cd llmwiki
pip install -r tools/requirements.txt        # 문서 변환 도구(markitdown)

한컴(hwp/hwpx)·구형 ppt/doc 도 쓰려면 LibreOffice 를 설치하세요:

• macOS: brew install --cask libreoffice
• Ubuntu: sudo apt install libreoffice
• Windows: https://www.libreoffice.org/download

그리고 purpose.md(목적)와 schema.md(규칙)를 내 상황에 맞게 한 번 편집합니다.

1. 문서 넣기

지원 형식: pdf, docx, pptx, xlsx, xls, csv, hwp, hwpx, ppt, doc, txt, md, html 등

# 다른 폴더에서 문서 찾아보기
python tools/find_docs.py ~/Downloads -q 보고서

# 원본 보관 + 텍스트 추출 (파일 또는 폴더 단위)
python tools/ingest.py ~/Downloads/논문.pdf ~/문서/회의록.hwp
python tools/ingest.py ~/Downloads          # 폴더 전체
python tools/ingest.py ~/Downloads --link   # 원본을 복사 대신 링크해 디스크 절약

2. 위키로 컴파일 (Claude Code에게)

이 폴더를 Claude Code로 열고 그냥 말하면 됩니다:

"새로 추출한 문서들을 위키로 컴파일해줘"

그러면 Claude Code가 llm-wiki 스킬에 따라:

1. 각 문서를 분석해 개념·개체·연결·검토 항목을 뽑고,
2. wiki/에 페이지를 만들거나 기존 페이지에 병합하고([[위키링크]]로 연결),
3. python tools/reindex.py로 색인·개요를 갱신합니다.

3. 질문하기

"트랜스포머랑 어텐션이 어떻게 연결되는지 위키에서 정리해줘"

Claude Code는 원본 전체를 다시 읽지 않고 컴파일된 위키를 먼저 읽어 답합니다 (RAG와의 핵심 차이).

4. (선택) 결과 보기

• 위키는 그냥 마크다운 파일이라 VSCode, Obsidian([[링크]] 그래프 지원), GitHub 등 어디서든 열립니다.
• 예전에 만든 Electron 뷰어를 쓰고 싶으면 desktop-viewer/ 참고.

왜 Electron 앱이 아니라 이 방식인가

문서는 내 컴퓨터에 있습니다. 그래서 로컬에서 도는 게 자연스럽고, 컴파일하는 두뇌(Claude Code)가 이미 로컬에 있으니 앱을 따로 만들거나 배포할 필요가 없습니다. 위키도 평범한 마크다운이라 어떤 도구로든 열 수 있어 잠김(lock-in)이 없습니다.

라이선스

MIT