llm-wiki

Obsidian 문서 기반 LLM wiki를 위한 파일 우선(file-first) 저장소입니다.

이 저장소의 목적은 Karpathy의 LLM Wiki 아이디어를 실제 운영 가능한 형태로 구체화하는 것입니다. 핵심은 질문 시점마다 원문을 다시 벡터 검색하는 것이 아니라, LLM이 raw/의 원천 자료를 읽고 wiki/에 구조화된 지식을 지속적으로 축적하고 유지하는 것입니다.

구조

• raw/: 원천 자료 보관소. 원문, 클리핑, 노트, 이미지 등. 불변(immutable) 계층입니다.
• wiki/: LLM이 관리하는 markdown wiki. 요약, 엔터티, 개념, 종합 분석, 인덱스, 로그가 위치합니다.
• scripts/: PowerShell 기반 보조 도구. 검색, 최근 로그 조회, 위키 검사, 소스 스캐폴딩에 사용합니다.
• AGENTS.md: 이 저장소에서 에이전트가 wiki를 어떻게 유지해야 하는지 정의하는 운영 스키마입니다.

기본 운영 루프

• 새 자료를 raw/에 넣습니다.
• LLM에게 ingest를 요청합니다.
• LLM은 wiki/의 요약/개념/인덱스/로그를 갱신합니다.
• 질의 결과 중 장기 가치가 있는 내용은 wiki/에 다시 저장합니다.
• 주기적으로 scripts/Test-Wiki.ps1로 링크/인덱스/고립 페이지를 점검합니다.

시작 파일

• AGENTS.md
• wiki/index.md
• wiki/log.md
• wiki/overview.md
• wiki/concepts/llm-wiki-pattern.md
• wiki/sources/karpathy-llm-wiki-links.md

Obsidian 사용

이 폴더 전체를 Obsidian vault로 열면 됩니다. wiki/index.md를 시작점으로 사용하고, graph view로 연결 구조를 확인하는 것을 권장합니다.

서버 MVP

현재 저장소에는 FastAPI 기반의 서버 MVP도 포함되어 있습니다.

• 업로드 페이지: /
• source 등록 API: POST /api/sources
• source 목록 API: GET /api/sources
• job 조회 API: GET /api/jobs/{job_id}
• query API: POST /api/query
• wiki 페이지 목록 API: GET /api/wiki/pages