개요
Graphify는 코드·문서·PDF·이미지·영상을 쿼리 가능한 지식 그래프로 변환하는 오픈소스 AI 코딩 어시스턴트 스킬. Andrej Karpathy의 LLM Wiki 아이디어에서 영감받아 48시간 만에 개발됨.
- GitHub: https://github.com/safishamsi/graphify
- 공식 사이트: https://graphify.net
- PyPI:
pip install graphifyy(패키지명 주의: y 두 개) - 특징: 벡터 임베딩 불필요, RAG 대비 71.5배 적은 토큰 사용
핵심 기능
| 기능 | 설명 |
|---|---|
| 코드 그래프화 | 23개 언어 Tree-sitter AST 파싱 → 콜그래프 생성 |
| 문서 처리 | PDF·마크다운 개념 추출 |
| 이미지 처리 | 비전 모델로 다이어그램 분석 |
| 오디오/영상 | faster-whisper 로컬 변환 후 처리 |
| Obsidian 내보내기 | --obsidian 플래그로 vault에 바로 저장 |
| 로컬 처리 | 코드 내용 외부 전송 없음 (프라이버시 보장) |
설치
pip install graphifyy # PyPI 패키지명 (y 두 개)
graphify install # CLI 초기화사용법
# 현재 디렉토리 그래프화
graphify .
# 특정 폴더
graphify ./src
# Obsidian vault로 내보내기
graphify . --obsidian
# 출력 결과
# graph.html — 인터랙티브 시각화
# graph.json — 쿼리용 데이터
# GRAPH_REPORT.md — 감사 보고서AI 에이전트에서 슬래시 명령
/graphify # Claude Code, Cursor, Codex, Gemini CLI 등에서 호출
지원 플랫폼
Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot CLI, OpenCode 등
지원 언어 (23개)
Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, Kotlin, Swift, Ruby, PHP, C#, Scala, Haskell, Lua, R, Julia, Elixir, OCaml, Zig 등
RAG vs Graphify
| 항목 | RAG | Graphify |
|---|---|---|
| 방식 | 청크 검색 + 벡터 DB | 지식 그래프 |
| 벡터 DB | 필요 | 불필요 |
| 토큰 사용 | 높음 | 71.5배 적음 |
| 코드 이해 | 텍스트 수준 | AST·콜그래프 수준 |
| Obsidian 연동 | 별도 설정 | --obsidian 플래그 |
Claude Code + Obsidian 연동 워크플로우
코드베이스 → graphify . --obsidian
↓
Obsidian vault 자동 생성
↓
Graph View로 구조 시각화
↓
Claude Code에서 /graphify로 쿼리