infinite-canvas: Canvas AI tạo ảnh, video, tự host — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về basketikun/infinite-canvas — 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: infinite-canvas: bảng vẽ vô hạn để tạo ảnh, video bằng AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
infinite-canvas là một công cụ mã nguồn mở (MIT) dạng bảng vẽ vô hạn để làm việc với AI: tạo ảnh, sửa ảnh theo ảnh tham chiếu, tạo video, dùng trợ lý và thư viện prompt trong cùng một giao diện. Bạn chạy bằng Docker hoặc bằng bun, rồi điền Base URL và API Key của dịch vụ tương thích OpenAI. Với người đã quen Docker thì cài khá nhanh; người mới cần làm quen thêm khái niệm API Key.
infinite-canvas ("Vô hạn canvas") là một ứng dụng web mã nguồn mở, biến trình duyệt của bạn thành một bảng vẽ rộng không giới hạn để làm việc với AI. Trên đó bạn tạo ảnh từ chữ, sửa ảnh dựa trên ảnh mẫu, hỏi đáp với trợ lý, tạo video, và nối các bước lại với nhau bằng các node có dây nối.
Repo này dành cho ai? Chủ shop cần ra nhiều phương án hình quảng cáo, nhân viên truyền thông cần thử ý tưởng hình ảnh liên tục, hoặc lập trình viên muốn một "bàn làm việc AI" tự host. Điểm đáng giá nhất: toàn bộ API Key, canvas, tài liệu và lịch sử tạo ảnh mặc định lưu ngay trong trình duyệt của bạn, và công cụ kết nối với bất kỳ dịch vụ nào tương thích giao diện OpenAI. Hiện repo có khoảng 10.282 sao và 2.389 fork, giấy phép MIT.
Một lưu ý trung thực ngay từ đầu: tác giả ghi rõ dự án vẫn đang trong giai đoạn phát triển, định dạng dữ liệu lưu cục bộ có thể bị đổi mà không đảm bảo tương thích với dữ liệu cũ. Vì vậy hãy xuất (export) những canvas quan trọng ra file để dự phòng. Bạn cũng có thể xem video ngắn bên dưới để thấy giao diện thực tế trước khi cài.
basketikun/infinite-canvas
infinite-canvas là bảng vẽ vô hạn mã nguồn mở: sinh ảnh, sửa ảnh theo ảnh mẫu, tạo video và trò chuyện với trợ lý AI ngay trên một canvas.
I.infinite-canvas 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ế.
- Canvas vô hạn, nhiều dự án. Bạn có nhiều canvas riêng, kéo thả và phóng to thu nhỏ các node, nối dây giữa chúng, có bản đồ nhỏ (minimap) để không bị lạc, có hoàn tác/làm lại và nhập/xuất canvas. Lợi ích: ý tưởng nào cũng đặt cạnh nhau để so sánh, không bị cuộn mất như trong khung chat.
- Sáng tạo bằng AI. Giao diện chạy trong trình duyệt và gọi thẳng tới API tương thích OpenAI mà bạn cấu hình. Hỗ trợ tạo ảnh từ chữ, ảnh từ ảnh, sửa theo ảnh tham chiếu, hỏi đáp văn bản, âm thanh và video. Lợi ích: bạn chọn nhà cung cấp và tự kiểm soát chi phí.
- Trợ lý trên canvas. Trợ lý trò chuyện dựa trên node bạn đang chọn và các node phía trước nó, rồi chèn kết quả trở lại canvas. Lợi ích: không phải copy qua lại giữa chat và công cụ vẽ.
- Canvas Agent cục bộ. Qua Canvas Agent chạy trên máy, Codex hoặc Claude Code có thể điều khiển canvas hiện tại thông qua MCP. Lợi ích: lập trình viên cho phép AI tự bố trí node, tự chạy quy trình.
- Plugin cho Codex app. Cài xong sẽ tự đăng ký MCP và cố gắng bật Agent cục bộ.
- Hệ thống plugin node. Cài, bật, cập nhật, gỡ node plugin từ xa qua URL, và có TypeScript SDK để tự viết node riêng.
- Tuỳ biến cách gọi API. Nếu API của bạn không giống chuẩn OpenAI, bạn có thể tự định nghĩa cách gọi ảnh/video. Lợi ích: dùng được nhiều trạm trung chuyển hoặc dịch vụ tự dựng.
- Thư viện prompt. Có sẵn 7 nguồn prompt mã nguồn mở, cho phép thêm nguồn JSON chuẩn của riêng bạn. Dữ liệu được trình duyệt tải trực tiếp và lưu vào IndexedDB.
Ngoài ra README có dẫn tới các tài liệu riêng: hướng dẫn thao tác node, phím tắt canvas, triển khai Render và Docker. Các mục này nằm trong thư mục docs/ của repo.
II.Cần chuẩn bị gì
Theo README, bạn cần tuỳ cách chạy:
- Chạy bằng Docker: cài Docker có hỗ trợ lệnh
docker compose. Repo có sẵnDockerfilevàdocker-compose.yml. Đây là cách dễ nhất cho người mới. - Chạy để phát triển: cài bun, vì README dùng
bun installvàbun run dev. README không nêu phiên bản bun cụ thể, nên bạn cứ dùng bản mới và xem thêm thư mụcweb/nếu gặp lỗi. - Git để tải mã nguồn về (hoặc tải ZIP từ GitHub).
- Một dịch vụ AI tương thích OpenAI: bạn cần
Base URLvàAPI Key. Công cụ không tự có mô hình; nó chỉ là giao diện. README nhắc tới việc tương thích với các kênh như chatgpt2api, grok2api, flow2api, newapi.
README không nói gì về hệ điều hành bắt buộc hay yêu cầu GPU. Vì ứng dụng chạy trên web và gọi API bên ngoài, về nguyên tắc bạn không cần card đồ hoạ riêng. Tuy vậy, mục này chưa được README xác nhận, nên mình chỉ nói là dựa trên cách hoạt động mô tả.
API Key là chìa khoá tính tiền của bạn. Mặc định nó lưu trong trình duyệt, nên đừng nhập key trên máy dùng chung, và đừng gửi ảnh chụp màn hình có lộ key. Mỗi lần tạo ảnh hoặc video đều có thể phát sinh chi phí theo bảng giá nhà cung cấp.
III.Cài đặt từng bước
- Mở terminalMở PowerShell (Windows) hoặc Terminal (macOS/Linux) ở thư mục bạn muốn đặt dự án
- Tải mã nguồnDùng git clone rồi cd vào thư mục repo
- Chạy ứng dụngDùng Docker (khuyên dùng) hoặc bun run dev
- Mở trình duyệtVào http://localhost:3000 (với Docker)
- Điền cấu hìnhNhập Base URL và API Key ở góc phải trên
A.Bước 1: Tải mã nguồn về máy
Mở terminal ở một thư mục bạn dễ tìm, ví dụ thư mục Documents. Rồi chạy:
git clone https://github.com/basketikun/infinite-canvas.git
cd infinite-canvasLệnh đầu tải toàn bộ repo về, lệnh thứ hai đi vào thư mục vừa tải. README gốc dùng địa chỉ SSH (git@github.com:...), nhưng địa chỉ HTTPS ở trên cho cùng kết quả và không đòi cấu hình khoá SSH, nên người mới dùng sẽ ít vấp hơn.
B.Bước 2A: Chạy bằng Docker (cách dễ nhất)
Đảm bảo Docker đã mở và đang chạy, rồi gõ trong thư mục infinite-canvas:
docker compose up -dLệnh này đọc file docker-compose.yml có sẵn, dựng và chạy ứng dụng ở chế độ nền (-d). Lần đầu có thể mất một lúc vì phải dựng image. README cho biết cổng mặc định là 3000.
Chỗ người mới hay vấp: gõ lệnh khi chưa cd vào đúng thư mục, hoặc Docker Desktop chưa mở. Cả hai đều làm lệnh báo lỗi.
C.Bước 2B: Chạy ở chế độ phát triển bằng bun
Nếu bạn là lập trình viên và muốn xem hoặc sửa mã, README hướng dẫn:
cd web
bun install
bun run devBạn đang ở thư mục infinite-canvas, nên cd web đi vào thư mục giao diện. bun install cài các thư viện cần dùng. bun run dev bật máy chủ phát triển. Terminal sẽ in ra địa chỉ để bạn mở trong trình duyệt; README không ghi rõ cổng của chế độ này, nên hãy đọc địa chỉ do terminal in ra.
Nếu máy chưa có bun, README chưa ghi cách cài bun. Bạn xem hướng dẫn trên trang chính thức của bun, hoặc chọn cách Docker ở bước 2A.
D.Bước 3: Mở trình duyệt và điền cấu hình
Với Docker, mở http://localhost:3000. Lần đầu vào, bấm nút cấu hình ở góc phải trên và điền hai thông tin:
Base URL: địa chỉ API tương thích OpenAI của bạn.API Key: khoá do nhà cung cấp cấp.
README cho biết các thông tin này được lưu cục bộ trong trình duyệt. Nghĩa là nếu bạn đổi trình duyệt hay xoá dữ liệu duyệt web, bạn phải nhập lại. Nếu dịch vụ của bạn gọi khác chuẩn OpenAI mặc định, README nói bạn có thể tự viết cách gọi tạo ảnh/video trong phần tuỳ chỉnh. Chi tiết nằm trong tài liệu của repo (thư mục docs/).
Nếu bạn chưa có API để dùng, README có gợi ý một dự án tạo ảnh miễn phí cùng tác giả tên chatgpt2api. Mình chưa kiểm chứng nó, nên hãy tự đọc kỹ điều khoản trước khi dùng.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu cho thấy mọi thứ ổn:
- Trang
http://localhost:3000mở ra giao diện canvas thay vì báo "không thể truy cập" (với Docker). - Bạn bấm được nút cấu hình ở góc phải trên và lưu được Base URL, API Key.
- Tạo một node tạo ảnh với prompt ngắn như "một cốc cà phê trên bàn gỗ" và nhận được ảnh trả về.
Nếu Docker chạy, bạn cũng có thể gõ docker compose ps để xem container có ở trạng thái đang chạy hay không. Nếu bước tạo ảnh báo lỗi nhưng giao diện hiển thị bình thường, nhiều khả năng là do cấu hình API, không phải do cài đặt. Xem phần lỗi thường gặp bên dưới.
V.Dùng vào việc thật
Các tình huống dưới đây bám sát những khả năng README mô tả. Prompt chỉ là ví dụ để bạn chỉnh theo nhu cầu.
A.Chủ shop thử nhiều phương án hình quảng cáo
Bạn bán đồ handmade và cần vài hướng hình cho đợt khuyến mãi. Mở một canvas mới, tạo node tạo ảnh, nhập prompt như: "Nến thơm đặt trên bàn gỗ, ánh sáng ấm buổi chiều, phong cách tối giản, nền trơn". Tạo vài ảnh rồi đặt cạnh nhau trên canvas để chọn.
Kết quả: bạn nhìn được tất cả phương án cùng lúc. Chọn ảnh ưng ý rồi dùng làm ảnh tham chiếu để thử biến thể về màu sắc hay bố cục. Canvas có thể xuất ra file để bạn lưu lại.
Canvas vô hạn hợp nhất ở chỗ: ý tưởng nào cũng nằm trước mắt, không bị chôn trong lịch sử chat.
Ông T
B.Nhân viên truyền thông sửa ảnh theo ảnh mẫu
Sếp đưa một ảnh sản phẩm cũ và muốn đổi bối cảnh cho mùa mới. Bạn thêm ảnh vào canvas, nối nó vào node tạo ảnh để dùng làm ảnh tham chiếu, rồi viết: "Giữ nguyên sản phẩm, đổi nền thành không khí mùa thu, tông cam nhạt". README xác nhận có chức năng sửa ảnh theo ảnh tham chiếu.
Kết quả: bạn nhận được ảnh mới ngay trên canvas, vẫn nối dây với ảnh gốc. Nếu chưa vừa ý, sửa prompt rồi tạo lại mà không mất ảnh gốc.
C.Dùng trợ lý canvas để lên ý tưởng nội dung
Bạn đang có vài node ảnh và ghi chú về chiến dịch. Chọn node cần bàn, mở trợ lý và hỏi: "Dựa trên ảnh này, gợi ý 5 câu mô tả ngắn cho bài đăng mạng xã hội". Theo README, trợ lý hiểu ngữ cảnh node đang chọn cùng các node nối phía trước.
Kết quả: câu trả lời gắn với nội dung bạn đang làm, và bạn chèn lại vào canvas để giữ cùng nhóm ý tưởng. Chất lượng phụ thuộc mô hình bạn cấu hình, vì bản thân công cụ không kèm mô hình.
D.Lập trình viên cho Agent điều khiển canvas
Bạn đã dùng Codex hoặc Claude Code. README cho biết repo có thư mục canvas-agent/ và plugins/, cho phép Agent thao tác canvas hiện tại qua MCP. Với Codex app, plugin sẽ tự đăng ký MCP và thử bật Agent cục bộ.
Cách làm: đọc mục "本地 Canvas Agent" và "Codex app 插件" trong README hoặc tài liệu trong docs/ để làm đúng các lệnh. README chưa liệt kê lệnh cài đặt phần này ngay trong trang chính, nên mình không đưa lệnh ở đây để khỏi sai. Kết quả mong đợi: Agent tạo và sắp xếp node trên canvas theo yêu cầu bằng ngôn ngữ tự nhiên của bạn.
VI.Lỗi hay gặp và cách xử lý
A.Lệnh docker compose báo lỗi hoặc không kết nối được Docker
Thường do Docker chưa chạy hoặc bạn đứng sai thư mục. Mở Docker Desktop và chờ nó sẵn sàng, rồi cd infinite-canvas và chạy lại docker compose up -d. Nếu vẫn lỗi, xem nội dung lỗi để biết là thiếu quyền hay thiếu ảo hoá trên máy.
B.Không mở được localhost:3000
Có thể container chưa lên xong, hoặc cổng 3000 đang bị chương trình khác dùng. Chạy docker compose ps để xem trạng thái. Nếu cổng bị chiếm, bạn có thể tắt chương trình kia hoặc đổi cổng trong docker-compose.yml. Hãy sửa thật cẩn thận và sao lưu file trước khi sửa.
C.Bấm tạo ảnh nhưng báo lỗi xác thực hoặc không phản hồi
Kiểm tra lại Base URL và API Key ở phần cấu hình: có thừa dấu cách, sai địa chỉ, key hết hạn hoặc hết số dư không. Vì trình duyệt gọi thẳng tới API (theo README), dịch vụ phía bên kia cũng phải cho phép trình duyệt gọi vào. Nếu bạn nghi ngờ vấn đề này, mở công cụ nhà phát triển của trình duyệt (F12) để xem thông báo lỗi trong tab Console hoặc Network.
D.Mất canvas hoặc cấu hình sau khi dọn trình duyệt
Dữ liệu mặc định nằm trong trình duyệt, nên xoá dữ liệu duyệt web hoặc đổi sang máy khác sẽ mất. Hãy dùng chức năng xuất canvas thường xuyên cho dự án quan trọng. Ngoài ra, tác giả cảnh báo định dạng lưu có thể đổi giữa các phiên bản, nên sau khi cập nhật hãy kiểm tra canvas cũ còn mở được không.
E.bun: command not found khi chạy chế độ phát triển
Máy chưa cài bun hoặc terminal chưa nhận. Cài bun theo trang chính thức của nó, mở lại terminal rồi chạy lại. Nếu không muốn cài thêm, chọn cách Docker.
VII.Có nên dùng không
Điểm mạnh:
- Miễn phí, mã nguồn mở theo giấy phép MIT; README nói rõ bạn có thể dùng, sửa và dùng thương mại.
- Gom tạo ảnh, sửa ảnh, video, trợ lý, prompt vào một canvas, giúp làm việc có hệ thống hơn so với chat đơn lẻ.
- Dữ liệu và API Key mặc định lưu trong trình duyệt của bạn, bạn giữ quyền kiểm soát.
- Linh hoạt về nguồn API: tương thích OpenAI và có thể tuỳ biến cách gọi.
- Có hệ thống plugin và hướng kết nối Agent cục bộ cho người muốn đi xa hơn.
Giới hạn:
- Bản thân công cụ không cung cấp mô hình AI. Bạn vẫn phải có API và có thể tốn phí.
- Dự án đang phát triển, dữ liệu cũ có thể không tương thích sau cập nhật.
- README và tài liệu chủ yếu bằng tiếng Trung, người đọc tiếng Việt có thể phải dùng công cụ dịch cho các phần chi tiết.
- Phần Canvas Agent và plugin Codex đòi hỏi kiến thức kỹ thuật; README chính chưa ghi lệnh cài rõ ràng.
- Dữ liệu chỉ nằm ở trình duyệt, nên làm việc nhóm hoặc đồng bộ nhiều máy không phải thế mạnh mặc định.
Khi nào chọn cách khác: nếu bạn chỉ cần tạo vài ảnh nhanh, dùng thẳng một trang tạo ảnh có sẵn sẽ đỡ mất công cài. Nếu cần canvas cộng tác nhiều người thì nên xem các nền tảng chuyên cho việc đó. Còn nếu bạn muốn một bàn làm việc AI trực quan, tự chủ dữ liệu và có thể mở rộng, infinite-canvas là lựa chọn đáng thử.
Câu hỏi thường gặp
infinite-canvas có miễn phí không?
Bản thân repo miễn phí và dùng giấy phép MIT, cho phép dùng, sửa, phân phối và dùng thương mại. Tuy nhiên bạn cần một dịch vụ AI tương thích OpenAI để tạo ảnh hay video, và dịch vụ đó có thể tính phí riêng. README không đưa ra bảng giá cụ thể.
Có cần GPU hay máy mạnh không?
README không nêu yêu cầu GPU. Ứng dụng chạy trên trình duyệt và gọi API do bạn cấu hình, nên phần tạo ảnh/video do dịch vụ bên kia xử lý. Tuy vậy tư liệu không ghi cụ thể cấu hình tối thiểu, nên chưa có thông tin chính thức.
Chạy được trên Windows không?
README không nói rõ hệ điều hành hỗ trợ. Hai cách chạy được ghi là Docker (docker compose up -d) và bun (bun run dev), cả hai đều có thể dùng trên nhiều hệ điều hành. Nếu bạn dùng Windows, cách Docker thường là hướng dễ thử nhất.
Dữ liệu và API Key của tôi có an toàn không?
Theo README, API Key, Base URL, canvas, tài liệu và lịch sử tạo ảnh mặc định lưu trong trình duyệt cục bộ của bạn. Giao diện cũng gọi thẳng tới API bạn cấu hình. Dù vậy bạn vẫn không nên nhập key trên máy dùng chung. Repo có file SECURITY.md để xem cách báo lỗ hổng.
Cách dùng nhanh nhất để thử là gì?
Tải repo, chạy docker compose up -d trong thư mục repo rồi mở http://localhost:3000. Sau đó vào cấu hình ở góc phải trên và điền Base URL cùng API Key của dịch vụ tương thích OpenAI. Đó là các bước README ghi ở phần Quick Start.
Nếu API của tôi không giống chuẩn OpenAI thì sao?
README cho biết bạn có thể tự tuỳ chỉnh cách gọi tạo ảnh/video bằng script riêng. Tác giả cũng nói công cụ tương thích nhiều kênh như chatgpt2api, grok2api, flow2api, newapi. Chi tiết cách viết cần xem thêm trong tài liệu của repo.
Dự án có ổn định để dùng lâu dài không?
Tác giả cảnh báo dự án đang trong giai đoạn phát triển và không đảm bảo tương thích dữ liệu cũ, các định dạng lưu cục bộ có thể bị đổi. Repo vẫn được cập nhật trong 3 tháng gần đây. Bạn nên xuất canvas quan trọng ra file để dự phòng.


