Kiwi Mu

나만의 학습 위키를 만드세요

전공책, PDF, 웹 콘텐츠를 넣으면 — LLM이 챕터/개념별로 분석하여 상호 링크된 학습 위키를 자동 생성합니다.

30초 데모 체험

API key 없이 바로 체험할 수 있습니다:

mkdir my-wiki && cd my-wiki
bunx @open330/kiwimu init --demo
# → 양자역학 샘플 위키 + 학습 퀴즈가 즉시 생성됩니다
# → http://localhost:8000 에서 확인하세요

Quickstart for Agents

mkdir my-wiki && cd my-wiki
bunx @open330/kiwimu init
bunx @open330/kiwimu add "<YOUR_URL_OR_PDF>"
bunx @open330/kiwimu serve

Why Kiwi Mu?

교과서 한 권을 읽으면 수십 개의 개념이 서로 연결됩니다. Kiwi Mu는 LLM을 활용해 이 연결을 자동으로 만들어, 지식을 빠르게 탐색할 수 있는 위키로 변환합니다.

• LLM 기반 문서 분석 — 챕터/섹션 구조를 보존한 원본 페이지 + 핵심 개념별 자동 생성 페이지
• 원본/개념 분리 — 📖 원본 문서와 📝 개념 문서를 시각적으로 구분
• 자동 상호 링크 — 원본↔개념 간 유기적 cross-link + 외부 참고 자료 (Wikipedia 등)
• 학습 퀴즈 — 개념 페이지 기반 빈칸 채우기 / OX / 단답형 퀴즈 자동 생성
• 지식 그래프 — D3.js 인터랙티브 그래프 (원본: 파란색, 개념: 초록색)
• 데모 모드 — API key 없이 --demo로 즉시 체험
• 다양한 파일 지원 — URL, PDF, DOCX, PPTX, PPT, DOC, KEY, RTF
• 4개 LLM 프로바이더 — Google Gemini, Azure OpenAI, OpenAI, Anthropic
• 다크 모드 — 시스템 테마에 자동 대응
• 모바일 지원 — 햄버거 메뉴 + 슬라이드 사이드바
• 웹 UI — 브라우저에서 문서 추가, 설정 변경, 빌드 실행
• 토큰 사용량 추적 — API 호출 수, 토큰, 예상 비용을 웹에서 확인
• 원클릭 배포 — GitHub Pages / Vercel

Quick Start

설치

# npm/bunx로 바로 사용 (설치 불필요)
bunx @open330/kiwimu init

# 또는 글로벌 설치
bun add -g @open330/kiwimu

데모 모드 (API key 불필요)

mkdir my-wiki && cd my-wiki
bunx @open330/kiwimu init --demo

양자역학 샘플 위키가 생성되어 바로 체험할 수 있습니다:

• 📖 원본 문서 + 📝 개념 페이지
• 🔗 자동 상호 링크
• 📊 지식 그래프
• 📝 학습 퀴즈
• 🎲 임의 문서 탐험

프로젝트 생성 (Interactive CLI)

mkdir my-wiki && cd my-wiki
bunx @open330/kiwimu init

Interactive 프롬프트가 실행됩니다:

🥝 Kiwi Mu — 새 학습 위키 만들기

◆ 위키 이름
│  Radio Astronomy Wiki

◆ LLM 프로바이더
│  ● Google Gemini  (무료 API key: aistudio.google.com)
│  ○ Azure OpenAI
│  ○ OpenAI
│  ○ Anthropic Claude

◆ 모델명
│  gemini-2.0-flash-lite

◆ API Key
│  ••••••••••••

🥝 'Radio Astronomy Wiki' 위키가 생성되었습니다!

문서 추가

# URL 추가
bunx @open330/kiwimu add "https://www.cv.nrao.edu/~sransom/web/Ch1.html"

# 파일 추가 (PDF, DOCX, PPTX, DOC, PPT, KEY, RTF)
bunx @open330/kiwimu add textbook.pdf
bunx @open330/kiwimu add lecture.pptx

LLM이 문서를 분석하여:

1. 📖 원본 페이지 — 원래 챕터/섹션 구조 보존
2. 📝 개념 페이지 — 핵심 용어·정의·법칙 자동 생성
3. 🔗 Cross-link — 원본↔개념 간 유기적 연결
4. 📝 퀴즈 — 개념별 학습 퀴즈 자동 생성

학습 퀴즈

# 터미널에서 퀴즈 풀기
bunx @open330/kiwimu quiz

# 문제 수 지정
bunx @open330/kiwimu quiz -n 10

웹에서도 http://localhost:8000/quiz.html에서 카드 플립 방식으로 퀴즈를 풀 수 있습니다.

빌드 및 서버

# 정적 사이트 빌드
bunx @open330/kiwimu build

# 로컬 서버 실행 (웹에서 문서 추가 가능)
bunx @open330/kiwimu serve
# → http://localhost:8000

# 포트 변경
bunx @open330/kiwimu serve -p 3000

관리 페이지

kiwimu serve 실행 후 콘솔에 표시되는 admin URL로 접속:

• 위키 이름 변경
• LLM 프로바이더/모델/API Key 설정
• 토큰 사용량 및 예상 비용 확인
• 파일 업로드 (PDF, DOCX, PPTX 등)
• URL 추가
• 수동 빌드 실행
• 페르소나 관리

배포

# GitHub Pages (기본)
bunx @open330/kiwimu deploy

# Vercel
bunx @open330/kiwimu deploy --target vercel

Commands

| 명령 | 설명 | |------|------| | kiwimu init [name] | 새 위키 프로젝트 생성 (interactive CLI) | | kiwimu init --demo | 샘플 데이터로 즉시 체험 (API key 불필요) | | kiwimu add <source> | URL 또는 파일 추가 (PDF, DOCX, PPTX, DOC, PPT, KEY, RTF) | | kiwimu build | 정적 위키 사이트 빌드 | | kiwimu serve [-p port] | 웹 서버 실행 (문서 추가/관리 가능) | | kiwimu quiz [-n count] | 터미널에서 학습 퀴즈 풀기 | | kiwimu expand [--provider] | LLM으로 문서 내용 확장 (선택) | | kiwimu deploy [--target] | GitHub Pages / Vercel에 배포 | | kiwimu status | 현재 위키 상태 표시 |

Supported File Formats

| 형식 | 방법 | |------|------| | URL (HTTP/HTTPS) | Cheerio 웹 크롤링 | | PDF | pdf-parse | | DOCX | mammoth | | PPTX | ZIP/XML 파싱 | | DOC / PPT / RTF | macOS textutil | | KEY (Keynote) | 텍스트 추출 (제한적) |

Supported LLM Providers

| 프로바이더 | 추천 모델 | 비고 | |-----------|----------|------| | Google Gemini | gemini-2.0-flash-lite | 무료 API key | | Azure OpenAI | gpt-5-nano | Azure 구독 필요 | | OpenAI | gpt-4o | API key 필요 | | Anthropic | claude-sonnet-4-20250514 | API key 필요 |

Architecture

소스 (URL / PDF / DOCX / PPTX / DOC / PPT / KEY / RTF)
    ↓
[ Ingest ]      ── Cheerio / pdf-parse / mammoth / jszip / textutil
    ↓
[ Phase 1 ]     ── LLM: 원본 구조 추출 (📖 원본 페이지) — 병렬 처리 (concurrency=3)
    ↓
[ Phase 2 ]     ── LLM: 개념 추출 (📝 개념 페이지)
    ↓
[ Phase 2.5 ]   ── LLM: 학습 퀴즈 자동 생성 (📝 퀴즈) — 병렬 처리
    ↓
[ Phase 3 ]     ── [[wiki link]] 해석 + 원본↔개념 cross-link
    ↓
[ Build ]       ── 정적 HTML (사이드바, KaTeX, 지식 그래프, 퀴즈, 다크 모드)
    ↓
[ Deploy ]      ── GitHub Pages / Vercel

project-dir/
├── kiwi.toml          # 프로젝트 + LLM 설정
├── kiwi.db            # SQLite (문서, 링크, 퀴즈, 사용량)
├── uploads/           # 업로드된 파일
└── _site/             # 빌드 결과
    ├── index.html     # 홈 (문서 목록)
    ├── graph.html     # 지식 그래프
    ├── quiz.html      # 학습 퀴즈
    ├── wiki/          # 각 문서 페이지
    │   └── random.html  # 임의 문서
    ├── static/        # CSS, JS, 로고
    └── search-index.json

Tech Stack

• Bun — 런타임, 패키지 매니저, 빌트인 SQLite
• TypeScript — 타입 안전한 파이프라인
• @clack/prompts — Interactive CLI
• Cheerio — 웹 페이지 파싱
• Mammoth — DOCX 파싱
• JSZip — PPTX 파싱
• Marked + sanitize-html — Markdown → 안전한 HTML
• D3.js — 지식 그래프
• KaTeX — 수학 수식 렌더링
• gh-pages — GitHub Pages 배포

Security

• Bearer 토큰 인증 (serve 모드)
• SSRF 방지 (프라이빗 IP 차단, 리다이렉트 재검증)
• Path Traversal 방지 (resolve 검증)
• XSS 방지 (sanitize-html, CSP 헤더, escapeHtml)
• 파일 업로드 제한 (50MB)

License

MIT