VisualLM (LLM Inference Visualizer)

LLM 추론 과정을 “수식”이 아니라 데이터(토큰/벡터/확률)의 흐름으로 시각화하는 인터랙티브 교육용 웹 프로젝트입니다.

• 에이전트 공통 지침: agents/AGENTS.md (우선 참조)
• 협업 규칙(커밋/기여): CONTRIBUTING.md
• 기획서: docs/PROJECT_SPEC.md

---

1차 방향 (v0.1)

• Desktop 우선 (모바일은 Phase 3에서 단순화 대응)
• 클라이언트 추론 기본: Transformers.js + Xenova/gpt2-quantized
• 성능 전략: Web Worker 분리 + Progressive Loading
• 입력 가드레일: 한 줄 입력 + 토큰 수 제한(권장 24~48)
• Embedding: 사전 계산된 2D 의미 지도(초기 ~500 단어, PCA 2D)
• Attention: Curated Mode 기본, 실제 attention 기반은 Advanced(후순위 옵션)

---

개발 환경

• Node.js 18+ 권장
• Package manager: pnpm 10.x

Stable Baseline 정책

• Next는 보안 패치가 반영된 **14 LTS 라인(14.2.35)**으로 유지합니다.
• 핵심 체인(next, react, react-dom, eslint, eslint-config-next, typescript)은 exact version으로 고정합니다.
• 메이저 업그레이드(Next 15+/ESLint 9)는 별도 안정화 작업으로 분리합니다.

---

실행

# install
pnpm install

# dev
pnpm dev

# lint + typecheck
pnpm lint
pnpm typecheck

---

문서

• PRD: docs/PROJECT_SPEC.md