SamurAIGPT/llm-wiki-agent

A personal knowledge base that builds and maintains itself. Drop in sources — Claude (or Codex/Gemini) reads them, extracts knowledge, and maintains a persistent interlinked wiki. Works with Claude Code, Codex, OpenCode, Gemini CLI. No API key needed.

해결하는 문제

LLM Wiki Agent는 흩어져 있는 문서(PDF, DOCX 등) 모음을 구조화되고 상호 연결된 마크다운 위키로 변환합니다. 쿼리 중에 원시 텍스트 청크를 검색하는 전통적인 RAG 시스템과 달리, 이 도구는 지식을 영구적인 페이지로 컴파일하여 시간이 지남에 따라 축적 및 복합화하며, 자동으로 교차 참조를 생성하고 소스 간의 모순을 표시합니다.

작동 방식

이 시스템은 코딩 에이전트(Claude Code, Codex 또는 Gemini CLI 등)를 위한 기술로 작동합니다. 일련의 스키마 파일(CLAUDE.md 등)을 사용하여 에이전트에게 위키를 유지 관리하는 방법을 지시합니다.

사용자가 ingest 명령을 트리거하면 에이전트는 소스 문서를 읽고(markitdown을 통해 비 마크다운 파일 변환), 지식을 추출하여 엔티티 페이지(사람, 회사), 개념 페이지(아이디어, 프레임워크) 및 라이브 개요를 생성하거나 업데이트합니다. 또한 NetworkX와 Louvain 커뮤니티 탐지를 사용하여 지식 그래프를 구축하고, 명시적인 위키 링크와 추론된 의미적 관계를 모두 시각화하는 독립형 graph.html 파일을 생성합니다.

대상 사용자

연구자: 여러 학술 논문과 보고서에서 정보를 합성해야 하는 분.
학생 또는 독서가: 책의 등장인물과 논쟁에 대한 테마 지도를 만들고 싶은 분.
지식 노동자: 개인 지식 베이스 또는 비즈니스 인텔리전스(회의록, 프로젝트 문서)를 관리하는 분.
경쟁 분석가: 시장 트렌드와 기업 발표를 지속적으로 추적하는 분.

주요 특징

영구적 지식: 일시적인 채팅 기록에 의존하는 대신 세션 간에 유지되는 구조화된 마크다운 페이지를 생성합니다.
자동 합성: 엔티티 및 개념 페이지를 자동으로 생성하고 모든 수집된 자료의 라이브 개요를 업데이트합니다.
모순 탐지: 수집 시점에 새로운 소스와 기존 소스 간의 충돌하는 주장을 표시합니다.
다중 포맷 지원: PDF, DOCX, PPTX, XLSX 및 HTML을 포함한 다양한 형식을 수집합니다.
Obsidian 통합: Obsidian과 호환되도록 설계되어 사용자가 에이전트가 생성한 위키를 볼트(vault)로 브라우징할 수 있습니다.
시각적 지식 그래프: 지식 네트워크의 인터랙티브한 HTML 시각화를 생성합니다.