Graphify 설치 및 테스트 방법

Codex 환경에서 Graphify를 설치하고 테스트하는 과정은 크게 가상 환경 설정, 패키지 설치, 데이터 준비, 그래프 생성 및 Codex 연동의 5단계로 진행됩니다.

1. Codex 실행 및 가상 환경 세팅

먼저 작업을 진행할 프로젝트 폴더를 생성하고 Codex를 실행합니다.

• Codex 실행: 실행 시 --dangerously-bypass-permissions 플래그를 사용하면 권한 요청 과정을 줄여 더 원활하게 작업할 수 있습니다.
• 패키지 관리자 활용: 가상 환경 세팅을 위해 uv 패키지 관리자 사용이 권장됩니다. 다음 명령어를 통해 Graphify를 설치합니다.
  • pip install graphify (또는 에이전트에게 설치 지시)

2. 분석 대상 데이터 준비

지식 그래프로 변환할 자료를 특정 폴더에 모읍니다.

• 예를 들어, 프로젝트 루트에 notes/ 폴더를 만들고 그 안에 마크다운(.md), PDF, 이미지 등 분석하고 싶은 원본 데이터를 넣습니다.
• Graphify는 기존 LLM 위키와 달리 폴더 구조를 복잡하게 미리 구성할 필요 없이 데이터를 한곳에 넣기만 하면 바로 진행 가능하다는 장점이 있습니다.

3. 지식 그래프 생성 (Build)

데이터가 준비되면 다음 명령어를 통해 그래프 생성을 실행합니다.

• 명령어: $graphify ./notes (현재 폴더의 notes 폴더를 대상으로 실행).
• 작동 원리: Graphify는 AST(추상 구문 트리) 분석 기술을 사용하여 지식을 기계적으로 먼저 분석합니다. 이를 통해 지식의 뼈대를 먼저 뽑아내기 때문에, 모든 내용을 LLM에 통으로 넘기던 방식보다 토큰 사용량을 대폭(약 5배 이상) 절감할 수 있습니다.

4. Codex 연동 설정 (Install)

그래프 생성이 완료되면 Codex가 이 결과를 인지하고 질문에 답변할 때 참조하도록 설정해야 합니다.

• 연동 명령어: graphify codex install.
• 효과: 이 명령을 수행하면 Codex 설정에 그래프 우선 참조 지침이 추가됩니다. 이후 Codex는 사용자의 질문을 받으면 먼저 생성된 지식 그래프를 확인하고, 그 안에서 답을 찾도록 유도됩니다.

5. 테스트 및 결과 확인

설정이 완료되면 데이터를 기반으로 실제 질의를 던져 테스트합니다.

• 질의 테스트: 예를 들어 입력한 문서에 인스타그램 관련 내용이 있다면 "인스타그램 포스팅은 어떻게 해야 해?"와 같은 질문을 던집니다. 그러면 Codex가 스스로 그래프 노드를 탐색하여 관련 근거를 찾아 답변하는 것을 확인할 수 있습니다.
• 시각적 확인: 생성된 graphify-out/ 폴더 내의 graph.html 파일을 열면, 내 지식들이 어떻게 연결되어 지식 그래프를 형성했는지 웹 브라우저를 통해 시각적으로 확인할 수 있습니다.

요약하자면, Graphify는 설치 후 $graphify로 그래프를 빌드하고 graphify codex install로 연동하기만 하면, 토큰 비용을 아끼면서 나만의 지식 베이스에 기반한 강력한 AI 비서를 구축할 수 있게 해줍니다.