Bỏ qua tới nội dung
Ông T.vn

Graphify: biến cả codebase thành đồ thị tri thức để hỏi đáp — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

Bài này là một góc nhìn khác về Graphify-Labs/graphify — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Graphify: biến cả dự án thành đồ thị tri thức để hỏi đáp — hướng dẫn cài đặt và dùng →

Graphify: biến cả codebase thành đồ thị tri thức để hỏi đáp — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Graphify là một skill kèm công cụ dòng lệnh bằng Python. Bạn gõ /graphify trong trợ lý AI, nó quét dự án (code, tài liệu, PDF, ảnh, video) và dựng thành đồ thị tri thức để hỏi đáp thay vì đọc từng file. Cài chỉ cần hai lệnh nếu máy đã có Python 3.10 trở lên và uv.

Graphify là một skill cho trợ lý lập trình AI (Claude Code, Cursor, Codex, Gemini CLI và hơn 20 công cụ khác), kèm một công cụ dòng lệnh tên graphify. Nó đọc toàn bộ dự án của bạn rồi dựng thành một đồ thị tri thức: mỗi khái niệm là một nút, mỗi mối liên hệ (gọi hàm, import, kế thừa…) là một đường nối. Sau đó bạn hỏi đồ thị thay vì bắt AI đi lục từng file.

Vấn đề nó giải quyết rất đời thường. Khi tiếp quản một dự án lạ, bạn không biết bắt đầu từ đâu. AI cũng vậy: nó phải đọc rất nhiều file, tốn thời gian và tốn token. Graphify tạo sẵn một tấm bản đồ để cả bạn lẫn AI nhìn vào đó trước. Nó hợp với lập trình viên mới, người phải đọc code của người khác, hoặc người làm văn phòng được giao một kho tài liệu và code mà không biết chúng liên quan nhau thế nào.

Điểm đáng giá nhất: phần code được phân tích ngay trên máy bạn bằng tree-sitter (cây cú pháp), không dùng mô hình AI, không gửi code ra ngoài. Mỗi đường nối đều được gắn nhãn cho biết nó đọc thẳng từ nguồn hay là suy ra. Repo hiện có khoảng 146971 sao và 14096 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây.

Skill

Graphify-Labs/graphify

Graphify biến code, tài liệu, PDF thành đồ thị tri thức để bạn hỏi đáp qua lệnh /graphify trong Claude Code, Cursor, Codex, Gemini CLI.

★ 147kPythonApache-2.0
Xem repo trên GitHub

I.Graphify làm được gì

Sau khi chạy, bạn nhận được một đồ thị lưu thành file, cùng các cách để khai thác nó:

  • Nút trung tâm (god nodes). Đây là những khái niệm được nối nhiều nhất. Nhìn vào là biết mọi thứ trong dự án đang chảy qua đâu, nên biết nên đọc phần nào trước.
  • Chia cụm (communities). Đồ thị được chia thành các hệ thống con bằng thuật toán Leiden, nhãn đặt không cần AI. Bạn thấy ngay dự án gồm những khối nào.
  • Liên kết giữa các file. Các quan hệ calls, imports, inherits, mixes_in được nối xuyên file, qua khoảng 40 ngôn ngữ lập trình nhờ tree-sitter. Bạn không phải tự lần theo từng dòng import.
  • Hỏi, tìm đường, giải thích. Có ba kiểu: hỏi bằng câu thường (query), tìm đường nối giữa hai thứ (path), và giải thích một khái niệm (explain). Tất cả chạy trên file graph.json, không cần đọc lại source.
  • Lý do thiết kế được đưa vào đồ thị. Các comment dạng # NOTE:, # WHY: và các trích dẫn ADR/RFC thành nút riêng, nối với đoạn code liên quan. Nhờ vậy bạn thấy cả vì sao code viết như thế.
  • Không chỉ code. Tài liệu, PDF, ảnh, video và âm thanh cũng được đưa vào cùng một đồ thị.
  • Nhãn độ tin cậy. Đường nối EXTRACTED là có rõ ràng trong nguồn. Đường nối INFERRED là do Graphify suy ra. Bạn biết chỗ nào chắc chắn, chỗ nào cần kiểm tra lại.

Nó cũng không phải kho vector: không có embedding, không cần vector store. Đây là một đồ thị thật để duyệt qua lại.

II.Cần chuẩn bị gì

Theo README và pyproject.toml, bạn cần:

  • Python 3.10 trở lên. File pyproject.toml ghi rõ phiên bản Python >=3.10 và <3.15. Kiểm tra bằng python --version.
  • uv (khuyên dùng) hoặc pipx để cài công cụ. Kiểm tra bằng uv --version hoặc pipx --version.
  • Một trợ lý AI bạn đang dùng, ví dụ Claude Code, Cursor, Codex hoặc Gemini CLI. Graphify đăng ký skill vào trợ lý đó.
  • Hệ điều hành: macOS, Linux và Windows đều được hỗ trợ.
  • API key: phần code không cần. Phần tài liệu, PDF, ảnh, video dùng mô hình của trợ lý bạn, hoặc một API key nếu bạn tự cấu hình. README còn liệt kê các tuỳ chọn như Ollama, OpenAI, Gemini, Anthropic, AWS Bedrock. Nếu chỉ phân tích code thì bạn không cần key.

README không nói về yêu cầu GPU hay dung lượng ổ đĩa, nên mình không kết luận gì về chuyện đó.

Cài uv nhanh nếu máy chưa có:

Terminal
brew install python@3.12 uv

Dòng trên dành cho macOS (dùng Homebrew). Trên Windows, README dùng winget:

PowerShell
winget install astral-sh.uv

Trên Ubuntu/Debian:

Terminal
curl -LsSf https://astral.sh/uv/install.sh | sh

Tên gói chính thức trên PyPI là graphifyy, có HAI chữ y. Các gói graphify* khác trên PyPI không liên quan tới dự án này. Lệnh chạy vẫn là graphify (một chữ y).

III.Cài đặt từng bước

  1. Chuẩn bị Python và uvKiểm tra Python 3.10+ và cài uv (hoặc pipx)
  2. Cài công cụChạy uv tool install graphifyy để có lệnh graphify
  3. Đăng ký skillChạy graphify install để nó tự nhận ra trợ lý AI của bạn
  4. Mở trợ lý AIMở Claude Code, Cursor, Codex… trong thư mục dự án
  5. Dựng đồ thịGõ /graphify . và đợi ra thư mục graphify-out

A.Kiểm tra Python và uv

Mở terminal (Terminal trên macOS/Linux, PowerShell trên Windows) rồi gõ:

Terminal
python --version
uv --version

Python phải từ 3.10 trở lên. Nếu uv báo không tìm thấy, quay lại phần cài uv ở trên. Người mới hay quên mở lại terminal sau khi cài, nên máy chưa nhận lệnh mới.

B.Cài công cụ graphify

README đưa ba cách cài, chọn một:

Terminal
uv tool install graphifyy   # recommended, isolated env (if 'graphify' isn't found after, run: uv tool update-shell)
pipx install graphifyy      # alternative
pip install graphifyy       # may need PATH setup, see Troubleshooting below

Mình khuyên cách đầu (uv tool install) vì nó cài vào môi trường riêng, không đụng các thư viện Python khác của bạn. Cách pip có thể cần chỉnh PATH, nên với người mới thì nên tránh. Chú ý gõ đúng graphifyy hai chữ y.

C.Đăng ký skill vào trợ lý AI

Terminal
graphify install

Lệnh này chạy một lần. Nó dò xem bạn đang dùng trợ lý nào và đăng ký skill, nên không phải cấu hình riêng cho từng công cụ. Nếu bạn dùng Windows với Claude Code, README nói nó tự nhận; ngoài ra có thể ghi rõ graphify install --platform windows.

Một số trợ lý có lệnh riêng, ví dụ:

Terminal
graphify install --platform codex
graphify install --platform gemini
graphify cursor install

Bảng đầy đủ hơn 20 nền tảng nằm trong phần Pick your platform của README. Với Codex, bạn còn phải thêm multi_agent = true dưới mục [features] trong file ~/.codex/config.toml để trích xuất song song.

Nếu muốn cài skill vào riêng dự án hiện tại thay vì cho cả tài khoản máy, thêm cờ --project:

Terminal
graphify install --project
graphify install --project --platform codex

Cách này ghi file vào ngay thư mục bạn đang đứng (ví dụ .claude/skills/graphify/SKILL.md hoặc .agents/skills/graphify/SKILL.md), tiện để đưa vào git cho cả nhóm dùng chung.

D.Cài thêm phần mở rộng nếu cần

Mặc định Graphify chưa đọc PDF hay Word. Muốn thêm thì cài kèm extra tương ứng:

Terminal
uv tool install "graphifyy[pdf]"
uv tool install "graphifyy[office]"
uv tool install "graphifyy[video]"

Lần lượt là: PDF, file .docx/.xlsx, và phiên âm video/âm thanh. README còn có các extra khác (mcp, watch, neo4j, svg…) khi bạn cần.

E.Dựng đồ thị lần đầu

Mở terminal, cd vào thư mục dự án của bạn, mở trợ lý AI ở đó, rồi gõ trong khung chat của trợ lý (không phải trong terminal thường):

Code
/graphify .

Dấu chấm nghĩa là thư mục hiện tại. Riêng Codex thì dùng $graphify thay cho /graphify.

IV.Kiểm tra đã chạy được chưa

Sau khi chạy xong, dự án của bạn có thêm thư mục graphify-out/ với ba file:

Code
graphify-out/
├── graph.html       open in any browser: click nodes, filter, search
├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions
└── graph.json       the full graph: query it anytime without re-reading your files

Cách kiểm tra nhanh:

  • Mở graph.html bằng trình duyệt: bạn sẽ thấy đồ thị, bấm vào nút được, lọc và tìm được.
  • Mở GRAPH_REPORT.md: có các khái niệm chính, những liên kết bất ngờ và gợi ý câu hỏi.
  • Thử một lệnh hỏi. README minh hoạ trên dự án FastAPI:
Terminal
graphify explain "APIRouter"
graphify path "FastAPI" "ModelField"

Kết quả mong đợi: lệnh explain in ra nút, file nguồn, cụm, số kết nối và danh sách đường nối kèm nhãn [EXTRACTED] hoặc [INFERRED]. Lệnh path in đường đi ngắn nhất giữa hai khái niệm, kèm số bước (hop).

Thay tên trong dấu ngoặc kép bằng khái niệm có thật trong dự án của bạn. Gõ tên không tồn tại thì dĩ nhiên không ra kết quả.

V.Dùng vào việc thật

A.Lập trình viên mới nhận dự án cũ

Bạn vừa vào công ty và được giao một codebase vài trăm file, không ai có thời gian giải thích. Bạn chạy /graphify . ở thư mục gốc, rồi mở GRAPH_REPORT.md để xem các nút trung tâm và các cụm. Sau đó mở graph.html bấm thử vào từng cụm. Với một khái niệm lạ, bạn gõ:

Terminal
graphify explain "tên_khái_niệm"

Kết quả là nó nằm ở file nào, dòng nào, nối với những gì. Thay vì mất nửa ngày đọc lan man, bạn có bức tranh tổng thể sau vài phút.

Đừng để AI lục từng file. Đưa cho nó tấm bản đồ trước, rồi hãy hỏi.

Ông T

B.Hỏi bằng câu thường về một mảng chức năng

Bạn làm sản phẩm hoặc hỗ trợ khách hàng, có hiểu biết kỹ thuật cơ bản, và cần biết phần thanh toán của hệ thống đụng tới những module nào. Bạn dùng:

Terminal
graphify query "phần thanh toán liên quan tới những module nào?"

Theo README, graphify query trả về một đồ thị con đúng phạm vi câu hỏi. Bạn nhận được danh sách module liên quan, đủ để đem đi hỏi đội kỹ thuật cho chính xác. Nếu hệ thống của bạn không có phần đó, kết quả sẽ không đầy đủ, nên hãy dùng tên gọi gần với tên trong code.

C.Tìm xem hai thứ nối với nhau thế nào

Bạn sắp sửa một chức năng và muốn biết sửa chỗ A thì có ảnh hưởng chỗ B không. Chạy:

Terminal
graphify path "A" "B"

Bạn nhận đường đi ngắn nhất giữa hai khái niệm, và độ tin cậy của cả đường bằng độ tin cậy của đoạn yếu nhất. Nếu cả đường đều là EXTRACTED, bạn yên tâm hơn. Nếu có đoạn INFERRED, hãy mở code ra kiểm tra lại trước khi sửa.

D.Gộp code với tài liệu và PDF

Bạn có thư mục dự án chứa cả code, tài liệu thiết kế và file PDF đặc tả. Cài thêm extra pdf, rồi chạy /graphify . như thường. README nói tài liệu, PDF, ảnh, video đều được đưa vào cùng một đồ thị với code. Bạn có thể hỏi một câu xuyên suốt, chẳng hạn một quy định trong PDF được hiện thực ở đoạn code nào. Phần này dùng mô hình của trợ lý (hoặc API key bạn cấu hình), nên có thể phát sinh chi phí token.

VI.Lỗi hay gặp và cách xử lý

A.Gõ graphify báo không tìm thấy lệnh

Sau khi cài bằng uv tool install, terminal đôi khi chưa biết đường dẫn của công cụ. README gợi ý chạy:

Terminal
uv tool update-shell

Rồi đóng terminal, mở lại. Nếu vẫn lỗi, xem trang Installation và Troubleshooting trên docs.graphify.com mà README dẫn tới.

B.Cài nhầm gói trên PyPI

Gõ pip install graphify (một chữ y) có thể cài một gói khác hoàn toàn. Hãy chắc là bạn gõ graphifyy với hai chữ y. Đây là lỗi người mới rất dễ mắc vì nhìn thoáng qua thấy giống nhau.

C.Python quá cũ hoặc quá mới

pyproject.toml yêu cầu Python từ 3.10 đến dưới 3.15. Kiểm tra bằng python --version. Nếu máy bạn dùng bản ngoài khoảng đó thì cài không được hoặc chạy lỗi. Theo README, uv tự quản lý Python của nó nên cách dùng uv ít vướng nhất.

D.Không thấy nội dung PDF hay file Word trong đồ thị

Đa phần là do chưa cài extra. Cài bằng uv tool install "graphifyy[pdf]" cho PDF, hoặc "graphifyy[office]" cho .docx và .xlsx, rồi chạy lại /graphify ..

E.Gõ /graphify mà trợ lý không hiểu

Hãy chắc là bạn đã chạy graphify install ít nhất một lần, và mở lại trợ lý sau đó. Với Codex, dùng $graphify chứ không phải /graphify, và nhớ bật multi_agent = true trong ~/.codex/config.toml. Nếu trợ lý của bạn có lệnh cài riêng thì dùng lệnh đó theo bảng trong README.

Phần code được xử lý ngay trên máy bạn. Nhưng khi đồ thị gồm tài liệu, PDF, ảnh hoặc video, bước hiểu ngữ nghĩa sẽ gọi mô hình của trợ lý hoặc API key bạn cấu hình. Nếu dự án có thông tin nhạy cảm, hãy cân nhắc trước khi đưa những file đó vào, và đừng dán API key vào chỗ công khai.

VII.Có nên dùng không

Điểm mạnh. Cài nhanh, chỉ hai lệnh. Phần code chạy cục bộ, có thể lặp lại cùng kết quả, không tốn token. Mỗi đường nối có nhãn nên bạn biết chỗ nào đáng tin. Hỗ trợ rất nhiều trợ lý AI và cả ba hệ điều hành lớn. README cũng có bảng đo hiệu năng (xem file BENCHMARKS.md trong repo): ví dụ trên một bộ thử tên LOCOMO, Graphify đạt recall@10 là 0,497 mà không tốn credit LLM nào khi dựng đồ thị. Bạn nên đọc kỹ cách đo trước khi tin các con số.

Giới hạn. Công cụ hướng tới lập trình viên và người làm việc với trợ lý AI trong terminal, nên người chưa từng mở terminal sẽ cần làm quen. Đường nối INFERRED là suy luận, không phải sự thật tuyệt đối. Phần tài liệu và media phụ thuộc mô hình AI nên có thể tốn chi phí. README cũng có quảng bá gói đám mây Graphify Cloud (giữ đồ thị luôn cập nhật, hỗ trợ nhiều repo); đây là một sản phẩm riêng, bản mã nguồn mở bạn đang đọc không bắt buộc phải dùng nó.

Khi nào chọn cách khác. Nếu dự án chỉ vài file nhỏ, cứ để trợ lý đọc thẳng là đủ, không cần dựng đồ thị. Nếu bạn cần tìm kiếm ngữ nghĩa trên văn bản thuần tuý thì một công cụ tìm kiếm vector sẽ hợp hơn, vì Graphify cố ý không dùng vector. Còn nếu bạn muốn hiểu nhanh một codebase lạ và để AI trả lời có dẫn nguồn, Graphify rất đáng thử.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

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

Repo mã nguồn mở theo giấy phép Apache-2.0, bạn cài và dùng công cụ dòng lệnh không mất phí. README nói dựng đồ thị cho code tốn 0 credit LLM. Riêng phần tài liệu, PDF, ảnh, video dùng mô hình của trợ lý hoặc API key bạn cấu hình, nên chi phí phụ thuộc nhà cung cấp đó. Ngoài ra có gói Graphify Cloud là sản phẩm riêng.

Cần GPU hay máy mạnh không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng. Phần code được phân tích cục bộ bằng tree-sitter, không dùng mô hình AI. Yêu cầu duy nhất được ghi rõ là Python 3.10 trở lên.

Chạy trên Windows được không?

Được. README nói hỗ trợ macOS, Linux và Windows. Trên Windows bạn có thể cài uv bằng winget install astral-sh.uv, sau đó chạy uv tool install graphifyy và graphify install.

Code của tôi có bị gửi đi đâu không?

Theo README, code được phân tích cục bộ bằng tree-sitter và không rời khỏi máy bạn. Chỉ bước hiểu ngữ nghĩa với tài liệu, PDF, ảnh, video mới gọi một backend, và chỉ khi bạn cấu hình. Với dữ liệu nhạy cảm bạn nên tự cân nhắc trước khi đưa các loại file đó vào.

Dùng được với những trợ lý AI nào?

README nêu Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Aider, Kiro, Antigravity và hơn 20 công cụ khác. Mỗi nền tảng có lệnh cài riêng trong bảng của README; với Claude Code chỉ cần graphify install. Riêng Codex dùng $graphify thay cho /graphify.

Graphify khác gì việc để AI tự đọc code hoặc dùng grep?

Graphify dựng sẵn một đồ thị, nên bạn hỏi, tìm đường nối hoặc giải thích khái niệm mà không phải đọc lại file. Nó không dùng vector store hay embedding. README có bảng đo cho thấy kết quả tốt hơn cách grep/đọc file trong một bài thử với ERPNext, nhưng đó là số liệu của tác giả và bạn nên xem BENCHMARKS.md để hiểu cách đo.

Tên gói cài là gì, sao hay bị nhầm?

Tên gói chính thức trên PyPI là graphifyy, có hai chữ y, còn lệnh chạy là graphify. README cảnh báo các gói graphify* khác trên PyPI không liên quan tới dự án này, nên hãy gõ đúng tên gói khi cài.

Chuyển nhanh tới mục

  1. I.Graphify làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Python và uv
    2. B.Cài công cụ graphify
    3. C.Đăng ký skill vào trợ lý AI
    4. D.Cài thêm phần mở rộng nếu cần
    5. E.Dựng đồ thị lần đầu
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Lập trình viên mới nhận dự án cũ
    2. B.Hỏi bằng câu thường về một mảng chức năng
    3. C.Tìm xem hai thứ nối với nhau thế nào
    4. D.Gộp code với tài liệu và PDF
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ graphify báo không tìm thấy lệnh
    2. B.Cài nhầm gói trên PyPI
    3. C.Python quá cũ hoặc quá mới
    4. D.Không thấy nội dung PDF hay file Word trong đồ thị
    5. E.Gõ /graphify mà trợ lý không hiểu
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.