lucasastorian/llmwiki

LLM Wiki – AI가 유지 관리하는 개인 지식 기반

정의 – LLM Wiki는 이미 읽은 파일(PDF, Word 문서, 슬라이드, 노트, 웹 클리핑 등)을 검색 가능하고 상호 연결된 "개인 위키백과"로 바꿔주는 자체 호스팅 도구입니다. 무거운 작업은 Anthropic의 Claude 모델이 수행하며, MCP 프로토콜을 통해 연결합니다. 매일 밤 Claude 루틴이 추가된 새 자료를 읽고 텍스트를 추출하여 마크다운 페이지를 업데이트하거나 생성하므로, 수동으로 편집하지 않아도 위키가 최신 상태로 유지됩니다.

주요 구성 요소

• CLI(./llmwiki …)는 기존 문서 폴더를 인덱싱하고, 로컬 API 서버와 Next.js 웹 UI를 시작하며, 마크다운 페이지의 wiki/ 폴더를 생성합니다.
• Chrome 확장 프로그램은 웹 페이지나 PDF를 클리핑하고, 섹션을 강조 표시하고, 주석을 추가할 수 있습니다. 저장된 데이터는 동일한 작업 공간에 배치되어 Claude가 수집할 수 있습니다.
• MCP 서버는 작업 공간을 Claude(Claude Desktop, Claude Code 또는 Claude Cowork)에 노출합니다. 그런 다음 Claude는 작은 도구 세트(search, read, create, edit, append, delete, lint 등)를 사용하여 소스를 읽고 마크다운 페이지를 작성할 수 있습니다.
• 백엔드 추상화 – 로컬에서는 데이터가 SQLite 인덱스와 함께 파일 시스템에 저장됩니다. 동일한 코드가 Postgres + S3를 사용하는 호스팅 모드에서 실행될 수 있으므로 Claude 도구는 동일하게 동작합니다.
• 그래프 뷰어 및 시각화 – 웹 UI는 개념이 어떻게 연결되는지 보여주고 Mermaid 다이어그램, 차트 등을 렌더링할 수 있습니다.

사용 방법

1. 설치 – Python 3.11+, Node 20+, Office 파일용 선택적 LibreOffice. 저장소를 클론하고, 가상 환경을 만들고, Python 종속성(api/requirements.txt, mcp/requirements.txt)과 web/의 npm 종속성을 설치합니다.
2. 폴더 지정 – 모든 연구 파일이 포함된 폴더를 지정합니다. CLI는 숨겨진 .llmwiki/ 인덱스와 생성된 페이지용 wiki/ 폴더를 만들지만 원본 파일을 이동하거나 업로드하지는 않습니다.
3. 서비스 시작(./llmwiki open <folder>). API, MCP 서버, 웹 UI가 http://localhost:3000에서 사용 가능해집니다.
4. Claude 연결 – ./llmwiki mcp-config <folder>를 실행하고 출력된 JSON을 Claude의 구성 파일에 붙여넣습니다. 그런 다음 Claude에게 "내 소스를 수집하고 위키 구축을 시작하세요"라고 지시합니다.
5. 루틴 예약 – 다음과 같은 프롬프트로 매일 밤 실행되는 Claude Routine(또는 로컬 예약 작업)을 만듭니다:

   "가이드를 읽으세요. 마지막 실행 이후 추가된 모든 것을 찾아 위키를 업데이트하고, 새 페이지를 만들거나 기존 페이지에 자료를 통합하고, 인용과 상호 참조를 수정하세요." 루틴은 자동으로 위키를 최신 상태로 유지합니다.

6. 콘텐츠 추가 – 웹 UI에 파일을 끌어다 놓거나, 작업 공간 폴더에 직접 넣거나, Chrome 확장 프로그램을 사용하여 웹 콘텐츠를 클리핑하고 주석을 답니다.

지원되는 소스 유형 – PDF(선택적 Mistral OCR), Word/PowerPoint(LibreOffice 변환을 통해), Excel 시트, HTML 페이지(Markdown으로 변환), 일반 텍스트 파일(.md, .txt, .csv, .json 등), 이미지(인라인으로 저장되며 요청 시 Claude가 읽을 수 있음).

얻을 수 있는 것

• wiki/ 아래의 마크다운 페이지 세트. 수동으로 편집하거나, 버전 관리하거나, Claude가 수정하도록 할 수 있습니다.
• 전체 텍스트 검색과 인용 그래프 쿼리를 지원하는 검색 가능한 인덱스(.llmwiki/index.db).
• 페이지 간 상호 연결 및 원본 소스로의 링크, 시각적 그래프 및 다이어그램 지원.

로드맵 하이라이트 – Slack, 회의 노트 서비스(Granola), 이메일 전달에서 수집, 웹훅이 있는 공개 수집 API, 이미 사용 중인 도구에서 콘텐츠를 캡처하기 위한 Zapier 통합 추가.

라이선스 – Apache 2.0.

---

결론 – LLM Wiki는 Andrej Karpathy가 대중화한 "AI가 유지 관리하는 개인 위키" 아이디어의 구체적인 오픈소스 구현입니다. 간단한 로컬 워크플로(폴더 기반 저장 + SQLite)와 Claude 기반 자율 업데이트, Chrome 클리핑 확장 프로그램, 현대적인 Next.js UI를 결합하여 읽고 연구함에 따라 자동으로 성장하는 세컨드 브레인을 구축하는 실용적인 방법을 제공합니다.