MonkeyCode: AI làm PPT, tài liệu, code cho cả team, tự host — hướng dẫn cài đặt và dùng

Tóm tắt nhanh
MonkeyCode (tên mới là 百智办公 · MonkeyAI) là nền tảng mã nguồn mở giúp cả nhóm giao việc cho AI bằng tiếng thường: làm PPT, tài liệu, bảng tính, viết code, thiết kế. Bạn có thể cài lên server riêng bằng một lệnh, cấu hình tối thiểu 1 nhân CPU và 1 GB RAM. Cài khá dễ, nhưng tài liệu chính viết bằng tiếng Trung và giao diện demo cũng vậy.
MonkeyCode là một bàn làm việc AI mã nguồn mở dành cho cả nhóm. Trong README, tác giả gọi nó là 百智办公 · MonkeyAI, tức “nền tảng quản lý văn phòng AI cấp doanh nghiệp”. Bạn mô tả việc cần làm bằng ngôn ngữ thường, AI sẽ làm PPT, viết tài liệu, xử lý bảng, viết code hoặc thiết kế poster, rồi giao kết quả lại cho bạn.
Repo hợp với ba nhóm người. Nhóm thứ nhất là chủ doanh nghiệp nhỏ hoặc trưởng nhóm muốn mọi người dùng chung một hệ thống AI, thay vì mỗi người một tài khoản riêng. Nhóm thứ hai là nhân viên văn phòng hay phải làm báo cáo, slide, bảng số liệu. Nhóm thứ ba là lập trình viên muốn một nơi chạy AI viết code mà dữ liệu nằm trên server của mình. Hiện repo có khoảng 5.188 sao và 777 fork, và vẫn được cập nhật trong những tháng gần đây.
Điểm đáng giá nhất là phần quản trị cho cả nhóm. Bạn chia sẻ model, kho kiến thức, kỹ năng (skill), “chuyên gia”, kết nối MCP và quy tắc cho cả nhóm dùng chung. Bạn cũng kiểm soát quyền truy cập, xem thống kê sử dụng và tính phí theo mức dùng. Nếu muốn, bạn tự cài lên server của mình bằng đúng một lệnh.
chaitin/MonkeyCode
MonkeyCode (百智办公 · MonkeyAI) là bàn làm việc AI mã nguồn mở cho cả nhóm: làm PPT, xử lý bảng, viết code, thiết kế, tự cài trên server riêng.
I.MonkeyCode làm được gì
Theo README, một bàn làm việc này gồm ba kiểu việc và một lớp quản trị cho cả nhóm.
A.Ba kiểu việc: văn phòng, lập trình, thiết kế
- Văn phònglàm PPT, viết tài liệu, xử lý bảng, sắp xếp file. Bạn đưa tài liệu rời rạc vào, AI gom lại thành một sản phẩm gọn gàng. Lợi ích thực tế là bạn không phải ngồi chép số từ bảng sang slide.
- Lập trìnhtừ thiết kế kiến trúc, viết code đến sửa lỗi. README nêu ví dụ: viết tính năng theo bản yêu cầu, bổ sung test, rồi sửa lỗi phát sinh khi chạy. Bạn giữ phần quyết định kỹ thuật, còn việc lặp đi lặp lại giao cho AI.
- Thiết kếposter, thiết kế đồ họa, thiết kế tương tác và cả làm phim ngắn. Ví dụ trong README là làm poster theo chủ đề sự kiện kèm thiết kế trang đi kèm.
Cách làm chung cho cả ba kiểu rất đơn giản. Bạn cung cấp tài liệu, nói rõ mục tiêu và yêu cầu đầu ra, rồi để AI thực hiện và sắp xếp kết quả.
B.Quản trị cho cả nhóm
Đây là phần làm repo khác với một ứng dụng chat AI thông thường. Bảng điều khiển dành cho doanh nghiệp cho phép:
- Chia sẻ tài nguyênmodel lớn, kho kiến thức, kỹ năng, chuyên gia, kết nối MCP và quy tắc. Người mới vào nhóm dùng lại ngay những gì đồng nghiệp đã cấu hình.
- Theo dõi sử dụng và tính phíbiết ai dùng bao nhiêu, và quản lý chi phí theo mức dùng.
- Phân quyền và kiểm toánkiểm soát ai được truy cập tài nguyên nào, và ghi lại lịch sử sử dụng.
- Thống kê của cả nhómsố liệu để bạn quyết định nên cấu hình thêm hay bớt tài nguyên nào.
Nhóm có thể đưa dịch vụ model của riêng mình vào, nối công cụ nghiệp vụ qua MCP, rồi kết hợp với kho kiến thức, kỹ năng và quy tắc cho hợp quy trình làm việc.
C.Dùng trên nhiều thiết bị
README liệt kê bản Web, ứng dụng cho Windows x64, macOS (Apple Silicon và Intel) và Linux x64 (AppImage). Android, iOS, Linux ARM64 và máy tính HarmonyOS được ghi là “sắp có”, tức chưa phát hành.
II.Cần chuẩn bị gì
Tư liệu nói khá ít về yêu cầu, nên mình chỉ ghi những gì có:
- Máy chủ riêng (nếu tự cài)cấu hình nhẹ là 1 nhân CPU và 1 GB RAM. README nói thêm rằng bạn nên tăng cấu hình theo quy mô nhóm, dung lượng lưu trữ và khối lượng tác vụ.
- Một cửa sổ dòng lệnh chạy được
bashvàcurllệnh cài là lệnh bash. README không ghi rõ hệ điều hành máy chủ nào được hỗ trợ, nên bạn hãy xem thêm trong tài liệu sản phẩm trước khi cài. - Dịch vụ modelnhóm tự cấu hình model của mình. README nhắc đến việc “tiếp nhập dịch vụ model của riêng mình” nhưng không nêu tên nhà cung cấp hay key cụ thể. Cách cấu hình nằm trong tài liệu sản phẩm.
- Emailbản demo đăng nhập bằng mã xác thực gửi qua email.
- Phần cứng GPUREADME không yêu cầu.
Nếu chỉ muốn thử, bạn không cần chuẩn bị server. Bạn dùng ngay bản demo ở phần sau.
III.Cài đặt từng bước
Có hai đường: thử nhanh bằng bản demo, hoặc tự cài lên server của bạn.
- Chọn cách dùngThử bản demo hoặc tự cài server riêng
- Chuẩn bị serverCó máy chủ nhỏ (tối thiểu 1 nhân CPU, 1 GB RAM) và mở được terminal
- Chạy lệnh càiDán đúng một lệnh trong README vào terminal
- Đọc tài liệu cấu hìnhCấu hình model, quyền, kho kiến thức theo tài liệu sản phẩm
- Tải ứng dụng kháchTải bản Windows, macOS hoặc Linux, hoặc dùng bản Web
- Đăng nhậpNhập địa chỉ server và nhận mã xác thực qua email
A.Cách nhanh nhất: thử bản demo
Trước khi cài gì cả, bạn nên thử bản demo để biết nó hợp hay không. README hướng dẫn như sau: tải ứng dụng khách cho đúng hệ điều hành, điền địa chỉ máy chủ demo, rồi đăng nhập bằng mã xác thực gửi qua email.
https://demo.work.baizhi.cloud/Bạn cũng có thể mở thẳng địa chỉ trên trong trình duyệt để dùng bản Web. Chỗ người mới hay vấp là ô nhập địa chỉ máy chủ trong ứng dụng khách. Bạn phải điền địa chỉ ở trên, không phải địa chỉ website chính của dự án.
B.Tự cài lên server của bạn bằng một lệnh
Mở terminal trên máy chủ của bạn (ví dụ qua SSH), rồi chạy đúng lệnh README ghi:
bash -c "$(curl -kfsSL https://release.monkeycode-ai.com/public/monkeyai-install.sh)"Lệnh này tải một script cài đặt từ máy chủ phát hành của dự án rồi chạy nó. Bạn chỉ cần dán nguyên dòng, không sửa gì. Bạn cần chạy nó trên máy chủ, không phải trên máy tính cá nhân, nếu mục đích là dựng server cho cả nhóm.
Lệnh trên tải rồi chạy luôn một script từ internet, và cờ -k bỏ qua bước kiểm tra chứng chỉ HTTPS. Vì vậy bạn chỉ nên chạy trên máy chủ bạn chấp nhận rủi ro, tốt nhất là máy thử nghiệm trước. Nếu muốn an toàn hơn, hãy tải script về và đọc nội dung trước khi chạy.
C.Cài từ mã nguồn bằng Docker Compose
README có nhắc đến cách khởi động từ mã nguồn bằng Docker Compose, kèm cấu hình proxy, chứng chỉ, sao lưu và nâng cấp. Tuy nhiên README chính chưa ghi lệnh cụ thể cho cách này. Bạn xem mục “服务部署与运维” (triển khai và vận hành) trong thư mục docs/ của repo, hoặc tài liệu sản phẩm mà README dẫn tới. Để lấy mã nguồn về xem, lệnh phổ thông là:
git clone https://github.com/chaitin/MonkeyCode.git
cd MonkeyCodeD.Tải ứng dụng khách và đăng nhập
README có đường dẫn tải cho Windows x64, macOS Apple Silicon, macOS Intel và Linux x64 AppImage. Danh sách mới nhất nằm ở mục tải ứng dụng khách trên trang chủ dự án. Sau khi cài, bạn điền địa chỉ server (server demo hoặc server của bạn) và đăng nhập bằng email.
IV.Kiểm tra đã chạy được chưa
Tư liệu không nêu lệnh kiểm tra riêng sau khi cài, nên bạn kiểm tra bằng những dấu hiệu sau:
- Với bản demo: mở địa chỉ Web demo hoặc ứng dụng khách, nhập email và nhận được mã xác thực, đăng nhập vào được màn hình làm việc.
- Với server của bạn: script chạy xong không báo lỗi, rồi bạn mở được trang quản trị và đăng nhập bằng tài khoản mà tài liệu cài đặt hướng dẫn. Địa chỉ và cổng cụ thể, README không ghi, bạn xem trong phần kết quả của lệnh cài hoặc trong tài liệu sản phẩm.
- Thử một việc nhỏ: giao cho AI một câu như “tóm tắt file này thành 5 ý”. Nếu AI trả lời, nghĩa là đường đi từ ứng dụng đến model đã thông.
Bạn cũng nên xem thử bảng quản trị demo của dự án để biết mình đang hướng tới màn hình nào. README cung cấp tài khoản demo công khai: tên đăng nhập admin@baizhi.cloud, mật khẩu work.baizhi.cloud, địa chỉ https://admin.demo.work.baizhi.cloud/. Ở đó bạn xem được tài nguyên nhóm, quyền, thống kê dùng và quản lý tính phí.
V.Dùng vào việc thật
Các ví dụ dưới đây bám theo những gì README mô tả. Giao diện và cách thao tác chi tiết bạn xem trong tài liệu sản phẩm.
A.Chủ shop làm báo cáo cuối tháng
Chị Lan bán đồ gia dụng online, cuối tháng phải làm báo cáo cho đối tác. Chị có vài file bảng doanh thu và ghi chú rời rạc. Chị gom tài liệu vào, rồi dùng đúng kiểu câu lệnh README gợi ý, viết cho mình:
Hãy tổng hợp các tài liệu này thành slide báo cáo, và tóm tắt số liệu chính trong bảng tính.Kết quả là một bản nháp PPT kèm phần tóm tắt số liệu. Chị chỉ cần đọc lại, sửa vài chỗ rồi gửi đi. Việc của chị chuyển từ “làm từ đầu” sang “duyệt và chỉnh”.
Giao việc cho AI giống giao cho nhân viên mới: nói rõ mục tiêu, đưa đủ tài liệu, rồi duyệt kết quả.
Ông T
B.Nhân viên văn phòng phân tích bảng
Anh Hùng ở bộ phận kinh doanh nhận một bảng dữ liệu bán hàng khá dài. README nói bạn có thể nhờ AI “phân tích bảng này”. Anh đính kèm file và viết yêu cầu:
Phân tích bảng này, cho tôi biết 3 điểm đáng chú ý nhất và đề xuất việc cần làm tiếp.AI trả về phần phân tích bằng chữ để anh dùng ngay trong buổi họp. Lưu ý: nếu số liệu nhạy cảm, hãy xem phần dữ liệu bên dưới ở mục “Có nên dùng không” trước khi tải lên.
C.Lập trình viên giao việc viết code
Một dev nhỏ trong nhóm có bản yêu cầu tính năng và muốn có bản chạy được. Theo ví dụ trong README, họ giao việc trọn gói:
Hãy thực hiện tính năng theo bản yêu cầu này, bổ sung test, và sửa các lỗi phát sinh khi chạy.AI viết code, thêm test và xử lý lỗi. Dev vẫn phải đọc lại code và tự chạy test trước khi dùng, vì nhận kết quả chưa có nghĩa là kết quả đúng.
D.Trưởng nhóm thiết lập tài nguyên chung
Chị Mai là quản lý của một nhóm nhỏ, tối đa dùng 10 chỗ ở bản miễn phí. Chị vào bảng quản trị, đưa model của nhóm vào, thêm kho kiến thức công ty, và đặt quyền cho từng người. Sau đó nhân viên mới chỉ cần đăng nhập là dùng được ngay, và chị xem được thống kê ai dùng nhiều, dùng vào việc gì. Để tập làm quen với các màn hình này, chị thử trước trên tài khoản demo mà README công bố.
VI.Lỗi hay gặp và cách xử lý
Tư liệu README không liệt kê lỗi cụ thể. Dưới đây là những chỗ rất dễ vấp với loại công cụ tự host này.
A.Lệnh cài không tải được script
Nếu curl báo lỗi hoặc treo, thường do máy chủ không ra được internet hoặc bị chặn. Bạn kiểm tra kết nối mạng của server trước, rồi chạy lại. Nếu vẫn lỗi, hãy xem phần triển khai trong tài liệu sản phẩm. Đừng tự sửa lệnh trong script khi bạn chưa hiểu nó làm gì.
B.Máy chủ chạy chậm hoặc treo
Cấu hình 1 nhân CPU và 1 GB RAM chỉ là mức nhẹ nhất theo README. Khi nhiều người dùng cùng lúc hoặc giao việc nặng, máy dễ quá tải. Cách xử lý an toàn là tăng RAM và CPU theo quy mô nhóm, đúng như README khuyên.
C.Ứng dụng khách không kết nối được
Lỗi này hay do nhập sai địa chỉ máy chủ, hoặc server của bạn chưa mở truy cập từ bên ngoài (tường lửa, proxy). Bạn kiểm tra lại địa chỉ đã điền, thử mở bằng trình duyệt trước. Phần cấu hình proxy và chứng chỉ có nhắc trong phần vận hành của repo.
D.Không nhận được mã xác thực email
Với bản demo, thử kiểm tra hộp thư rác và thử lại sau ít phút. Với server riêng, mã xác thực phụ thuộc cách bạn cấu hình đăng nhập, bạn xem tài liệu sản phẩm. Ghi chú: tư liệu không mô tả chi tiết phần email của server tự cài.
E.AI không trả lời hoặc trả lời lỗi
Bản tự cài cần có dịch vụ model do chính bạn cấu hình. Nếu chưa khai báo model hoặc key sai, AI sẽ không làm việc được. Bạn quay lại phần cấu hình model trong tài liệu sản phẩm và kiểm tra lại. Không dán key vào những nơi công khai.
VII.Có nên dùng không
Điểm mạnh. Đây là một bộ công cụ hoàn chỉnh cho cả nhóm, không chỉ một ô chat. Bạn có quản lý tài nguyên chung, phân quyền, kiểm toán và thống kê. Cài đặt tự host chỉ một lệnh, cấu hình nhẹ. Mã nguồn mở theo giấy phép AGPL-3.0, bạn xem, sửa và làm bản riêng được, miễn tuân theo giấy phép. Bản miễn phí cho tối đa 10 chỗ.
Giới hạn cần biết.
- Tài liệu chính, README và giao diện demo viết bằng tiếng Trung. Bạn nên dùng thêm trình dịch khi đọc.
- Dữ liệu của nhóm nằm trên server của bạn, nhưng nếu dùng model hoặc công cụ bên ngoài thì nội dung vẫn bị gửi đến dịch vụ đó. Đây là điều chính README cũng nói rõ. Nếu có dữ liệu nhạy cảm, hãy chọn dịch vụ model bạn tin tưởng.
- Bản miễn phí không có máy tính đám mây và không có hỗ trợ kỹ thuật. Các thứ này thuộc bản trả phí, mà README chỉ nói “liên hệ để mua”.
- AGPL-3.0 có yêu cầu riêng khi bạn sửa và cung cấp dịch vụ cho người khác. Nếu định làm thương mại, hãy đọc kỹ giấy phép.
- Bản Android, iOS, Linux ARM64 và HarmonyOS hiện chưa có.
- Repo còn chứa nhiều thành phần (backend, frontend, desktop, extension trình duyệt, mobile). Nếu bạn chỉ cần một công cụ AI cho cá nhân, thứ này có thể hơi “to” so với nhu cầu.
Tóm lại: nên thử nếu nhóm bạn muốn một chỗ chung để dùng AI có quản lý, và bạn không ngại tài liệu tiếng Trung. Nếu bạn chỉ làm một mình, hoặc cần giao diện và hỗ trợ tiếng Việt đầy đủ, hãy cân nhắc công cụ khác.
Câu hỏi thường gặp
MonkeyCode có miễn phí không?
Mã nguồn mở theo giấy phép AGPL-3.0, và có bản miễn phí giá 0 đồng với tối đa 10 chỗ trong nhóm. Bản miễn phí không có máy tính đám mây và không có hỗ trợ kỹ thuật. Bản trả phí README chỉ ghi là liên hệ tư vấn, chưa nêu giá.
Cài MonkeyCode có cần GPU không?
README không yêu cầu GPU. Cấu hình nhẹ được nêu là 1 nhân CPU và 1 GB RAM, và bạn nên tăng theo quy mô nhóm và khối lượng việc. Phần chạy model phụ thuộc vào dịch vụ model bạn cấu hình.
Dùng được trên Windows không?
Có ứng dụng khách cho Windows x64, macOS (Apple Silicon và Intel) và Linux x64, ngoài ra còn bản Web. Bản Android, iOS, Linux ARM64 và HarmonyOS chưa phát hành. Hệ điều hành cho phía máy chủ, README chưa ghi rõ.
Dữ liệu của tôi có an toàn không?
Khi tự cài, dữ liệu nhóm được lưu trên server của bạn, và bạn tự quyết quyền truy cập, sao lưu. Tuy nhiên nếu dùng model hoặc công cụ bên ngoài thì nội dung liên quan vẫn gửi đến dịch vụ đó. Bạn nên chọn dịch vụ model phù hợp yêu cầu bảo mật.
Không biết lập trình có dùng được không?
Được. Các việc văn phòng như làm PPT hay phân tích bảng có thể giao bằng tiếng thường, chỉ cần đưa file và nói rõ mục tiêu. Riêng việc tự cài server thì bạn cần biết mở terminal và dán lệnh.
Có nối được với model và công cụ của riêng tôi không?
Có. README nói nhóm cấu hình được dịch vụ model riêng, nối công cụ qua kết nối MCP, rồi kết hợp kho kiến thức, kỹ năng, chuyên gia và quy tắc. Cách làm chi tiết nằm trong tài liệu sản phẩm, README chính không viết các bước đó.
Có tiếng Việt không?
Tư liệu chưa nói gì về giao diện tiếng Việt. README, tài liệu và bản demo đều bằng tiếng Trung, nên bạn có thể phải dùng thêm công cụ dịch khi đọc.


