gg-framework: Coding agent tiết kiệm gói AI bạn đang trả — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về KenKaiii/gg-framework — 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: GG Coder (gg-framework): trợ lý lập trình tiết kiệm gói AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
gg-framework là bộ mã nguồn đứng sau GG Coder, một ứng dụng desktop giúp bạn viết code bằng AI trên Windows, macOS và Linux. Nó dùng lại gói AI bạn đã có (Claude, ChatGPT, Kimi Code, MiniMax, MiMo, API key hoặc model chạy local). Cài bằng file tải về, không cần gõ lệnh, nên khá dễ với người mới.
gg-framework là kho mã nguồn của GG Coder, một ứng dụng desktop giúp bạn viết code bằng AI. Bạn mô tả việc cần làm, nó đọc dự án, sửa file, chạy kiểm tra rồi báo kết quả. Cùng kho này còn có bộ thư viện để bạn tự dựng agent AI của riêng mình.
Vấn đề tác giả muốn giải: bạn trả tiền cho một gói AI, nhưng công cụ code lại ngốn hết hạn mức quá nhanh. GG Coder được làm theo hướng gọn và tiết kiệm. Theo bảng đo của tác giả (7 tác vụ, mỗi tác vụ chạy 5 lần, cùng một model), một lượt chạy trọn bộ mất khoảng 102 giây và tốn khoảng 0,014 USD. Claude Code trong cùng bài đo mất khoảng 142 giây và tốn khoảng 0,037 USD. Đây là số do chính tác giả đo, nên bạn coi như tham khảo chứ không phải kết luận độc lập.
Ai nên dùng? Người làm kinh doanh hay văn phòng muốn thử làm một công cụ nhỏ bằng AI. Lập trình viên mới muốn có trợ lý nhưng chưa rành dòng lệnh. Dev đã có gói Claude hay ChatGPT và muốn dùng chúng hiệu quả hơn. Điểm đáng giá nhất là cài như một ứng dụng bình thường, kèm các bước kiểm tra như bảo mật, kiểm thử, khả năng truy cập để bạn không phải biết trước mình cần hỏi gì.
KenKaiii/gg-framework
GG Coder là ứng dụng desktop viết code bằng AI, dùng chính gói Claude, ChatGPT hay API key bạn có, và tự kiểm tra kết quả trước khi báo xong.
I.GG Coder làm được gì
Dưới đây là các tính năng chính theo README, kèm lợi ích thực tế.
- Tiết kiệm hạn mức gói AI. Tác giả cho biết GG Coder nhanh và gọn nhất trong 20 agent được đem ra so. Nếu bạn hay chạm giới hạn gói của mình, đây là lý do chính để thử.
- Agent Steroids. Tính năng này tìm trong mã nguồn mở thật, còn mới, ngay trên máy bạn. README nói không dùng MCP server bị giới hạn lượt gọi, nên không bị chặn số lần tìm. Lợi ích: AI dựa trên code có thật thay vì đoán.
- Ken Autopilot. Nó giữ cho công việc tiếp tục chạy đến khi kết quả thực sự được kiểm tra. Bạn bớt phải ngồi nhắc AI làm tiếp hay kiểm tra lại.
- Kiểm tra một cú bấm. Có các bước kiểm tra về bảo mật, tuân thủ, an toàn dữ liệu, khả năng truy cập, kiểm thử và hơn thế nữa, cùng điểm Project health (sức khoẻ dự án). Người mới không cần biết phải hỏi gì vẫn có thể rà dự án của mình.
- Dùng gói bạn đang có. Hỗ trợ gói Claude, ChatGPT, Kimi Code, MiniMax, MiMo, bất kỳ API key nào, hoặc model chạy local.
- GG Goals. Bạn giao cả một mục tiêu, một nhóm worker sẽ làm đến cùng.
- Chat. Hội thoại có nhớ ngữ cảnh.
- GG Motion. Biến ý tưởng của bạn thành video.
Ngoài ứng dụng, kho này còn có các gói cho người muốn tự xây: @kenkaiiii/gg-ai (kết nối nhà cung cấp AI, nhận phản hồi dạng stream), @kenkaiiii/gg-agent (dựng agent dùng công cụ của bạn), @kenkaiiii/gg-core (chọn model, xác thực, phát hiện model local) và @kenkaiiii/ggcoder (agent code, phiên làm việc và công cụ phía sau app và CLI).
II.Cần chuẩn bị gì
Tư liệu của repo nói khá ít về yêu cầu, nên mình chỉ nêu đúng những gì có.
- Hệ điều hành: macOS (Apple Silicon), Windows, hoặc Linux x86_64. Mac chip Intel không được nhắc tới trong README.
- Tài khoản AI: bạn cần một nhà cung cấp để kết nối khi mở app: gói Claude, ChatGPT, Kimi Code, MiniMax hoặc MiMo, hoặc một API key, hoặc model chạy local. README chưa nói gói nào là tối thiểu.
- Chỉ khi chạy bản phát triển: cần Node.js, pnpm và các điều kiện tiên quyết của Tauri (README có dẫn tới trang hướng dẫn của Tauri). README không ghi số phiên bản cụ thể.
- Phần cứng: README không nêu yêu cầu GPU hay RAM. Nếu bạn muốn chạy model local thì cấu hình phụ thuộc vào model đó, repo chưa có thông tin.
III.Cài đặt từng bước
Với người dùng thông thường, bạn chỉ cần tải bản cài rồi mở app. Cách chạy từ mã nguồn dành cho người muốn sửa code.
- Tải bản càiVào trang Releases của repo và lấy file đúng hệ điều hành
- Cài ứng dụngMở .dmg (Mac), chạy .exe (Windows) hoặc cài .deb/.rpm (Linux)
- Mở appKhởi động GG Coder sau khi cài xong
- Kết nối AIChọn nhà cung cấp AI của bạn trong app
- Chọn chế độChọn Code, Chat hoặc Motion để bắt đầu
A.Tải bản cài đúng hệ điều hành
Vào trang Releases của repo trên GitHub (bản mới nhất) và tải file tương ứng. Trên macOS Apple Silicon là file .dmg. Trên Windows là file .exe. Trên Linux x86_64 là file .deb hoặc .rpm. Chỗ người mới hay vấp: Releases có nhiều file, hãy chọn đúng đuôi file theo máy của bạn.
B.Cài trên macOS và Windows
Trên macOS, mở file .dmg vừa tải rồi làm theo cửa sổ hiện ra. Trên Windows, bấm đúp file .exe để chạy trình cài đặt. README không ghi thêm thao tác nào khác cho hai hệ này.
C.Cài trên Linux
Mở terminal tại thư mục chứa file vừa tải rồi chạy một trong hai lệnh dưới đây, tuỳ bạn tải .deb hay .rpm.
sudo apt install ./GG*.debsudo dnf install ./GG*.rpmLệnh đầu dùng cho các bản Linux dùng apt (như Ubuntu). Lệnh sau dùng cho các bản dùng dnf (như Fedora). Dấu ./ nghĩa là file nằm ngay trong thư mục hiện tại, nên bạn phải mở terminal đúng thư mục tải về.
D.Mở app và kết nối AI
Mở GG Coder, kết nối nhà cung cấp AI của bạn, rồi chọn Code, Chat hoặc Motion. README không mô tả chi tiết từng màn hình kết nối. Nếu bạn cần hướng dẫn có hình, tác giả nói có bản hướng dẫn cho Mac và Windows trong cộng đồng miễn phí RAID (trang chủ dự án).
E.Tuỳ chọn: chạy từ mã nguồn (dành cho dev)
Cách này cần Node.js, pnpm và các điều kiện của Tauri đã cài sẵn. Mở terminal rồi chạy lần lượt:
git clone https://github.com/KenKaiii/gg-framework.git
cd gg-framework
pnpm install
pnpm build
pnpm --filter gg-app tauri devLệnh git clone tải mã nguồn về, cd đi vào thư mục dự án. pnpm install cài các thư viện phụ thuộc, pnpm build biên dịch, và lệnh cuối mở app ở chế độ phát triển. Lần đầu có thể mất khá lâu. Nếu lệnh cuối báo lỗi, nhiều khả năng bạn thiếu điều kiện tiên quyết của Tauri.
F.Tuỳ chọn: dùng thư viện để tự dựng agent
Nếu bạn chỉ muốn phần lõi mà không cần app, cài hai gói này vào dự án của bạn:
npm install @kenkaiiii/gg-ai @kenkaiiii/gg-agentCách dùng chi tiết từng gói nằm ở trang của gói đó, README repo không viết thêm ví dụ code.
Khi kết nối AI, hãy dùng gói hoặc API key của chính bạn và đừng chia sẻ key cho người khác. Agent code có thể chạy nhiều lượt liên tiếp nên với API key tính tiền theo lượt, bạn nên theo dõi mức chi tiêu trên trang của nhà cung cấp.
IV.Kiểm tra đã chạy được chưa
README không đưa lệnh kiểm tra riêng, nên cách đơn giản nhất là xem app có làm được những việc sau không.
- App mở lên bình thường và cho bạn chọn giữa Code, Chat và Motion.
- Sau khi kết nối nhà cung cấp AI, bạn gửi được một tin nhắn ngắn ở chế độ Chat và nhận được trả lời.
- Ở chế độ Code, bạn mở một thư mục dự án nhỏ và nhờ nó mô tả dự án đó làm gì.
Nếu bạn chạy bản phát triển, lệnh pnpm --filter gg-app tauri dev sẽ mở cửa sổ ứng dụng. Cửa sổ hiện ra nghĩa là phần dựng đã ổn.
V.Dùng vào việc thật
Dưới đây là các tình huống mình thấy hợp với khả năng mà README mô tả. README không có prompt mẫu chính thức, nên các câu lệnh dưới đây là gợi ý của mình.
A.Chủ shop muốn có một trang giới thiệu đơn giản
Bạn bán hàng online và cần một trang giới thiệu sản phẩm. Mở GG Coder, chọn Code, tạo một thư mục trống rồi gõ yêu cầu bằng tiếng Việt, ví dụ: Làm giúp mình một trang giới thiệu cửa hàng bán trà, có tên shop, 3 sản phẩm và số điện thoại liên hệ. Với Ken Autopilot, công cụ sẽ tiếp tục cho đến khi kết quả được kiểm tra. Bạn nhận được một dự án chạy thử được trên máy. Hãy tự mở ra xem và nhờ nó chỉnh những chỗ chưa vừa ý.
B.Nhân viên văn phòng cần một công cụ nhỏ
Bạn muốn một tiện ích nhỏ, như gộp danh sách khách hàng từ vài nguồn. Trong chế độ Code, hãy mô tả đầu vào, đầu ra bạn muốn và nhờ nó viết kèm kiểm thử. Bạn có file chạy được cùng bộ kiểm thử, và biết chắc nó không hỏng khi dữ liệu đổi.
Người mới không cần biết phải hỏi AI những gì, chỉ cần bấm kiểm tra và đọc kết quả.
Ông T
C.Lập trình viên mới muốn rà dự án trước khi chia sẻ
Bạn vừa làm xong một dự án nhỏ và muốn đưa cho người khác dùng. Hãy dùng các bước kiểm tra một cú bấm về bảo mật, an toàn dữ liệu, khả năng truy cập và kiểm thử, rồi xem điểm Project health. Bạn nhận được danh sách việc cần sửa trước khi phát hành. Đây là điểm rất hợp với người chưa có kinh nghiệm, vì thường chính câu hỏi cần đặt mới là thứ khó.
D.Dev muốn dựng agent riêng cho công việc của mình
Nếu bạn đã biết code, hãy cài hai gói @kenkaiiii/gg-ai và @kenkaiiii/gg-agent như ở phần cài đặt. Gói đầu lo kết nối nhà cung cấp AI và stream phản hồi, gói sau giúp agent dùng các công cụ của bạn để làm việc. Lưu ý giấy phép AGPL-3.0: nếu bạn phân phối bản sửa hoặc chạy nó như một dịch vụ qua mạng, bạn phải chia sẻ mã nguồn theo cùng giấy phép.
VI.Lỗi hay gặp và cách xử lý
README không có mục xử lý sự cố, nên phần này là các lỗi rất dễ gặp với loại công cụ này.
- Tải nhầm file cài. Máy Mac chip Intel hoặc Linux ARM có thể không dùng được bản tải sẵn, vì README chỉ nhắc macOS Apple Silicon và Linux x86_64. Hãy kiểm tra chip của máy trước khi tải.
- Lệnh
apt installhoặcdnf installbáo không tìm thấy file. Thường do terminal đang mở sai thư mục. Hãycdtới thư mục chứa file vừa tải rồi chạy lại. pnpmhoặctauri devbáo lỗi khi chạy từ mã nguồn. Thường do thiếu Node.js, pnpm hoặc các điều kiện tiên quyết của Tauri. Đọc trang hướng dẫn Tauri mà README dẫn tới, cài đủ rồi chạy lại từpnpm install.- Kết nối AI không được. Kiểm tra lại gói hoặc API key còn hiệu lực, và bạn đang chọn đúng nhà cung cấp. README chưa mô tả các thông báo lỗi cụ thể.
- Hạn mức bị dùng nhanh. Dù được thiết kế để tiết kiệm, những tác vụ lớn vẫn tốn lượt. Hãy giao việc nhỏ, rõ ràng và theo dõi mức dùng trên trang của nhà cung cấp.
VII.Có nên dùng không
Điểm mạnh: cài như ứng dụng thường, chạy được trên Windows, macOS và Linux, dùng lại gói AI bạn đang có, có nhiều bước kiểm tra sẵn cho người mới, và mã nguồn mở. Repo vẫn được cập nhật trong 3 tháng gần đây, hiện có khoảng 296 sao và 50 fork.
Giới hạn: các số liệu tốc độ và chi phí do chính tác giả đo, trên các dự án thử nhỏ và một model cụ thể, nên kết quả của bạn có thể khác. README chưa nêu rõ yêu cầu phần cứng hay phiên bản Node, pnpm. Hướng dẫn chi tiết nằm ở cộng đồng RAID của tác giả chứ không nằm trong README. Giấy phép AGPL-3.0 cũng cần cân nhắc nếu bạn định phân phối hoặc chạy bản sửa như một dịch vụ.
Khi nên chọn cách khác: nếu bạn đã quen với một công cụ code AI khác và thấy ổn, chưa cần đổi. Nếu bạn cần một công cụ có tài liệu đầy đủ, ổn định cho cả đội, hãy xem kỹ giấy phép và tài liệu trong thư mục docs/ của repo trước khi quyết định. Với người mới muốn thử, đây là lựa chọn đáng cài một lần để tự đánh giá.
Câu hỏi thường gặp
GG Coder có miễn phí không?
Repo là mã nguồn mở theo giấy phép AGPL-3.0 và README không nhắc phí mua ứng dụng. Tuy nhiên bạn vẫn cần gói hoặc API key của nhà cung cấp AI để nó làm việc, và khoản đó do nhà cung cấp tính. Chi tiết về các gói trả phí khác của tác giả, repo chưa có thông tin.
Cài đặt có khó không, có cần biết dòng lệnh không?
Không bắt buộc. Bạn chỉ cần tải file .dmg, .exe, .deb hoặc .rpm từ trang Releases rồi cài như phần mềm thường. Dòng lệnh chỉ cần khi cài trên Linux hoặc khi chạy từ mã nguồn.
Chạy trên Windows được không?
Được. README có bản cài .exe cho Windows. Ngoài ra còn có bản cho macOS Apple Silicon và Linux x86_64.
Có cần GPU không?
README không nêu yêu cầu GPU. Ứng dụng kết nối tới nhà cung cấp AI nên không thấy yêu cầu riêng. Nếu bạn muốn chạy model local thì cấu hình cần thêm phụ thuộc vào model, repo chưa có thông tin cụ thể.
Dùng những gói AI nào với GG Coder?
README nói hỗ trợ gói Claude, ChatGPT, Kimi Code, MiniMax và MiMo, bất kỳ API key nào, hoặc model chạy local. Cách kết nối từng loại chưa được mô tả chi tiết trong README.
GG Coder khác gì Claude Code?
Theo bảng đo của tác giả, trên cùng model và cùng bộ tác vụ, Claude Code mất khoảng 142 giây và dùng nhiều hơn khoảng 169% so với GG Coder. Đây là số do tác giả tự đo nên chỉ nên coi là tham khảo. GG Coder còn có Agent Steroids, Ken Autopilot và các bước kiểm tra một cú bấm.
Tôi có thể dùng thư viện để tự làm agent không?
Có. README giới thiệu các gói @kenkaiiii/gg-ai, @kenkaiiii/gg-agent, @kenkaiiii/gg-core và @kenkaiiii/ggcoder. Để bắt đầu, README đưa lệnh npm install @kenkaiiii/gg-ai @kenkaiiii/gg-agent. Lưu ý giấy phép AGPL-3.0 khi phân phối hoặc chạy như dịch vụ mạng.


