LLM-WIKI

LLM WIKI는 Markdown, TXT, PDF 자료를 로컬에서 읽고 검토 가능한 Markdown Wiki 페이지로 바꾸는 작은 지식베이스 도구입니다. 빈 Wiki로 시작해도 되고, 직접 자료를 넣어 개인용 문서 저장소처럼 키워도 됩니다.

자료 저장, 초안 생성, Wiki 반영, 검증은 모두 로컬 파일과 MCP Tool을 통해 동작합니다. 선택적 Chat 기능은 사용자의 로컬 CLI가 있을 때만 읽기 전용 subprocess로 연결됩니다.

Wiki가 렌더링된 화면 예시는 demo/usage-example.png에 있습니다. 예시 이미지는 실행 데이터로 사용되지 않습니다.

포함된 구성

• AGENTS.md, RULES.md: Agent가 Wiki를 다룰 때 지켜야 할 운영 규칙
• skills/wiki-curator/: 자료 정리, 초안 작성, 링크 추천, 검증을 위한 재사용 가능한 Skill
• raw/: 사용자가 추가한 원본 자료 저장소
• wiki/: 승인된 Markdown Wiki 페이지 저장소
• schema/: Wiki 페이지와 raw item 규약
• tools/mcp_server.py: Agent와 Viewer가 함께 사용할 수 있는 stdio MCP 서버
• app/: 브라우저에서 Wiki를 보고 자료를 추가하는 Viewer
• demo/: 실제 렌더링 화면 예시

Repository 구조

기본 저장소의 raw/와 wiki/에는 .gitkeep만 들어 있습니다. 개인 자료나 미리 채워진 Wiki 페이지는 포함하지 않습니다.

빠른 시작

1. 설치 및 실행

• Python 3.10 이상
• 인터넷 연결: 최초 실행 시 pypdf 설치에 필요

run.py는 다음 작업을 자동으로 처리합니다.

• .venv 생성
• requirements.txt 의존성 설치
• MCP 기반 로컬 서버 실행
• 8000번 포트가 사용 중이면 다른 포트 선택
• 브라우저 열기

자료 추가, 초안 생성, Wiki 저장은 Python 서버와 MCP subprocess만으로 동작합니다. Codex CLI는 선택적 Chat 탭에서만 사용됩니다.

2. 자료 추가

• 화면 중앙의 첫 자료 추가 또는 상단의 + 자료 추가를 누릅니다.
• .md, .txt, 텍스트 기반 .pdf 중 하나를 선택합니다.
• 페이지 유형을 고릅니다.
• note
• concept
• guide
• reference
• project
• journal
• 제목과 태그를 확인합니다.
• 자동 생성된 Markdown 초안과 저장 경로를 검토합니다.
• 문제가 없으면 승인하고 Wiki에 저장을 누릅니다.

스캔 이미지 PDF는 텍스트가 추출되지 않을 수 있으므로 OCR 처리 후 넣어야 합니다.

3. 결과 확인

승인 후 다음 변화가 생깁니다.