Graphify là gì: biến codebase thành đồ thị tri thức cho AI

Q: Graphify có dùng được ngoài Claude Code không?

Bản v1.0.0 viết cho Claude Code. Graphify có cờ --mcp để chạy máy chủ MCP, nhờ đó agent khác hỗ trợ MCP có thể truy vấn đồ thị.

Thử hình dung anh chị vừa nhận bàn giao một phần mềm nội bộ. Người viết đã nghỉ, tài liệu không có, thư mục code thì hàng trăm file. Hỏi AI "luồng tạo đơn hàng chạy qua đâu?" thì mỗi lần nó lại đọc lại từ đầu, tốn lượt, và thỉnh thoảng trả lời rất tự tin về một hàm không hề tồn tại.

Cái thiếu ở đây là một tấm bản đồ. Graphify vẽ tấm bản đồ đó một lần, lưu lại, rồi để anh chị hỏi bao nhiêu lần cũng được.

Đọc nhanh trong 30 giây

Graphify là skill mã nguồn mở cho Claude Code, ra bản ổn định v1.0.0 ngày 05/04/2026.

Nó biến một thư mục gồm code, tài liệu, PDF, ảnh thành đồ thị tri thức: khái niệm là nút, quan hệ là đường nối, mỗi đường có nhãn độ tin cậy.

Cài bằng pip install graphifyy && graphify install, rồi gõ /graphify . trong Claude Code.

Hợp với người nhận bàn giao dự án lạ hoặc giữ kho tài liệu lớn. Thừa với dự án vài file.

Graphify là gì, dùng vào việc gì?

Graphify là một skill Claude Code kèm gói Python, dùng để biến thư mục bất kỳ thành đồ thị tri thức lưu trên máy. README lấy ví dụ thói quen của Andrej Karpathy: ông có một thư mục /raw để thả bài báo, tweet, ảnh chụp, ghi chú vào. Thư mục lớn dần thì không ai nhớ trong đó có gì.

Ví von cho dễ hình dung: đồ thị tri thức giống tấm sơ đồ họ hàng treo trong ngày giỗ. Mỗi người là một ô, mỗi quan hệ là một đường nối. Nhìn vào là biết ai con ai, ai thông gia với ai, không cần hỏi lại từng cô dì chú bác. Graphify làm việc đó cho file của anh chị: mỗi hàm, mỗi khái niệm là một nút, mỗi lời gọi hàm hay mỗi lần một tài liệu nhắc tới khái niệm khác là một cạnh.

Theo README bản v1.0.0, Graphify xử lý bốn loại file:

Loại	Đuôi file	Cách đọc
Code	`.py .ts .js .go .rs .java .c .cpp .rb .cs .kt .scala .php`	Phân tích cú pháp bằng tree-sitter, thêm bước dò lời gọi hàm
Tài liệu	`.md .txt .rst`	Claude rút khái niệm và quan hệ
Bài báo	`.pdf`	Dò trích dẫn, rút khái niệm
Ảnh	`.png .jpg .webp .gif`	Claude đọc ảnh chụp màn hình, sơ đồ

Bên trong Graphify có gì?

Graphify chạy hai đường song song rồi gộp lại: code đi qua tree-sitter trên máy, còn tài liệu và ảnh đi qua Claude.

Kiến trúc Graphify: bốn loại file đi qua tree-sitter và Claude, gộp thành đồ thị NetworkX gom cụm Leiden, xuất ra thư mục graphify-out

Hai đường đọc, một đồ thị, nhiều kiểu đầu ra.

Theo README, Graphify dùng NetworkX dựng đồ thị, thuật toán Leiden gom cụm, vis.js vẽ đồ thị trên trình duyệt. Không cần Neo4j, không cần máy chủ.

Sau mỗi lần chạy, Graphify tạo thư mục graphify-out/ gồm:

graph.html: đồ thị tương tác, bấm vào nút, tìm kiếm, lọc theo cụm.
GRAPH_REPORT.md: báo cáo các "nút trung tâm" mà mọi thứ đều đi qua, các mối liên hệ bất ngờ giữa những cụm khác nhau, và 4 tới 5 câu hỏi gợi ý.
graph.json: đồ thị lưu bền, vài tuần sau vẫn hỏi được mà không đọc lại file.
obsidian/: mở thành kho ghi chú Obsidian.
cache/: bộ nhớ đệm theo mã băm SHA256, lần chạy sau chỉ xử lý file đã đổi.

Ba nhãn giúp phân biệt thật và đoán

Mỗi cạnh trong đồ thị Graphify mang một trong ba nhãn: EXTRACTED (tài liệu nói rõ), INFERRED (suy ra hợp lý) hoặc AMBIGUOUS (chưa chắc, cần người xem). Đây là điểm tôi thấy đáng tin nhất.

Giống biên bản khám hiện trường của bên bảo hiểm: dòng nào tận mắt thấy, dòng nào do chủ xe khai, dòng nào còn nghi vấn đều ghi riêng. Người đọc biết ngay chỗ nào phải đi kiểm lại.

Mẹo

Mở GRAPH_REPORT.md trước khi mở đồ thị. Mấy "nút trung tâm" trong báo cáo thường là những file nên đọc đầu tiên khi nhận bàn giao.

Cài Graphify cho Claude Code

Yêu cầu theo README: Claude Code và Python 3.10 trở lên.

Các bước cài Graphify: cài gói graphifyy, gõ lệnh graphify trong Claude Code, cài git hook

Ba lệnh: cài gói, vẽ đồ thị, bật tự cập nhật.

Cài gói và đăng ký skill:

pip install graphifyy && graphify install

Tên gói trên PyPI có hai chữ y. README giải thích đây là tên tạm trong lúc tác giả xin lại tên graphify, còn lệnh và skill vẫn là graphify.

Mở Claude Code trong thư mục cần phân tích và gõ:

/graphify .

Muốn đồ thị tự cập nhật sau mỗi lần commit, cài git hook:

graphify hook install

Thử Graphify với hai việc thật

Việc 1: nhận bàn giao một dự án cũ. Chạy /graphify . ở thư mục gốc, mở graph.html để xem các cụm chức năng, đọc GRAPH_REPORT.md để biết hàm nào là trung tâm. Sau đó hỏi theo đường đi giữa hai khái niệm:

/graphify query "luồng tạo đơn hàng đi tới bước gửi hóa đơn thế nào?"
/graphify path "OrderService" "InvoiceSender"
/graphify explain "PaymentGateway"

Việc 2: thư mục nghiên cứu thị trường. Phòng kế hoạch có thư mục gồm báo cáo PDF, ghi chú họp, ảnh chụp bảng số liệu. Chạy Graphify với cờ xuất wiki để agent khác đọc được:

/graphify ./nghien-cuu --wiki
/graphify add https://arxiv.org/abs/1706.03762

Lệnh add tải một bài báo hoặc trang web về rồi cập nhật đồ thị. README không nói riêng về tài liệu tiếng Việt, nên thử trên thư mục nhỏ trước.

Graphify khác gì Serena và RAG vector?

Graphify dựng bản đồ toàn cảnh lưu lại được, còn Serena tra cứu ký hiệu trong code theo thời gian thực, và RAG vector tìm đoạn văn giống câu hỏi.

So sánh đọc thẳng file, RAG vector và Graphify theo cách lưu, câu hỏi hợp và độ tin cậy

Ba cách cho AI hiểu một thư mục, mỗi cách hợp một kiểu câu hỏi.

Nói gọn: RAG vector tìm đoạn văn giống câu hỏi. Graphify lưu quan hệ rõ ràng kèm nhãn độ tin cậy, nên hỏi được "đường đi từ A tới B" hay "cái gì nối hai cụm này".

Lưu ý

Tiết kiệm token tùy quy mô. README công bố trên bộ 52 file gồm repo của Karpathy, 5 bài báo và 4 ảnh, mỗi câu hỏi tốn ít hơn 71,5 lần token so với đọc file gốc. Với 6 file thì gần như không tiết kiệm. Đây là số tác giả tự đo.

Dữ liệu đi đâu. Phần code đọc bằng tree-sitter chạy trên máy. Phần tài liệu và ảnh do Claude đọc, tức nội dung được gửi lên mô hình mà Claude Code đang dùng.

Chi phí. Mỗi lần chạy trên tài liệu là lượt dùng Claude. Bộ nhớ đệm giúp lần sau chỉ xử lý file đã đổi.

Tên gói tạm. Gõ nhầm pip install graphify sẽ ra gói khác, phải dùng graphifyy.

Nhận xét của chuyên gia

Nhiều doanh nghiệp Việt tôi gặp có chung một nỗi đau: phần mềm nội bộ do người cũ hoặc đối tác viết, người đó nghỉ, tài liệu không có. Graphify không thay được tài liệu, nhưng cho người mới một tấm bản đồ để bắt đầu hỏi đúng câu. Nhãn AMBIGUOUS cũng hợp với văn hóa kiểm soát rủi ro: cái gì chưa chắc thì đánh dấu để người kiểm tra, không giấu đi.

Hợp với ai: đội kỹ thuật nhận bàn giao dự án; bộ phận nghiên cứu có kho tài liệu lớn; người dựng hệ thống AI cần cho agent một bản đồ dự án.

Chưa hợp với ai: dự án vài file, vì Claude đọc thẳng còn nhanh hơn; tài liệu mật không được gửi ra ngoài.

Cách bắt đầu của tôi: chạy trên một module nhỏ mà mình đã hiểu rõ, đối chiếu báo cáo với hiểu biết của mình. Thấy đúng mới chạy trên cả dự án. Rủi ro lớn nhất là tin đồ thị quá mức, vì cạnh INFERRED vẫn chỉ là suy luận.

Một câu để nhớ: Graphify không đọc hộ anh chị, nó chỉ cho anh chị biết nên đọc chỗ nào trước.

Xem Graphify trong chuỗi dòng thời gian AI.

Câu hỏi thường gặp

Graphify có cần Neo4j hay máy chủ riêng không?

Không. Theo README, Graphify chạy hoàn toàn trên máy với NetworkX. Nếu muốn, anh chị xuất file Cypher bằng cờ --neo4j để nạp vào Neo4j.

Graphify có dùng được ngoài Claude Code không?

Bản v1.0.0 viết cho Claude Code. Graphify có cờ --mcp để chạy máy chủ MCP, nhờ đó agent khác hỗ trợ MCP có thể truy vấn đồ thị.

Graphify có miễn phí không?

Có. File cấu hình gói ghi giấy phép MIT. Chi phí phát sinh là lượt dùng Claude khi đọc tài liệu và ảnh.

Nguồn: Graphify trên GitHub, bản v1.0.0, 05/04/2026.