# infinite-canvas: Xưởng vẽ AI trên canvas vô hạn — hướng dẫn cài đặt và dùng

> infinite-canvas (Vô Hạn Canvas) là ứng dụng web mã nguồn mở giấy phép MIT, dùng để sáng tạo ảnh bằng AI trên một tấm canvas rộng không giới hạn. Bạn kết nối API tương thích OpenAI của riêng mình rồi tạo ảnh, sửa ảnh, nối các bước thành luồng làm việc. Cài bằng Docker chỉ cần vài lệnh, hoặc chạy bản dev bằng Bun.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-10 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/infinite-canvas-canvas-vo-han-sang-tao-anh-ai

infinite-canvas là một **ứng dụng web mã nguồn mở để làm việc với AI tạo ảnh trên một tấm canvas rộng vô hạn**. Bạn kéo thả các node (khối) lên canvas, nối dây giữa chúng, rồi cho AI tạo ảnh, sửa ảnh, hỏi đáp, thậm chí tạo video ngay trong cùng một màn hình.

Vấn đề repo giải quyết khá đời thường: làm ảnh bằng AI thường là chuỗi thử đi thử lại. Bạn viết prompt, ra ảnh, sửa tiếp, so sánh với bản cũ, lưu lại prompt hay. Nếu làm trên khung chat thông thường thì mọi thứ trôi tuột lên trên và rất khó quản lý. Canvas cho bạn nhìn thấy toàn bộ quá trình, và nhánh nào hay thì đi tiếp.

Repo hợp với chủ shop làm ảnh sản phẩm, người làm nội dung, designer thử ý tưởng và lập trình viên mới muốn có một công cụ AI sáng tạo tự host. Điểm đáng giá nhất: mã nguồn dùng giấy phép MIT, và theo README thì khóa API, địa chỉ API, canvas, tư liệu và lịch sử tạo ảnh mặc định lưu ngay trong trình duyệt của bạn. Hiện repo có khoảng 10.282 sao và 2.389 fork. Bạn có thể xem video ngắn bên dưới để hình dung giao diện trước khi cài.

```repo
- repo | basketikun/infinite-canvas
- kind | Ứng dụng
- desc | Infinite Canvas là web app mã nguồn mở gom canvas, AI tạo ảnh, sửa ảnh theo ảnh mẫu, trợ lý chat và thư viện prompt vào một giao diện.
- stars | 10k
- lang | TypeScript
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/wiHRUUieL3A
- facebook | https://www.facebook.com/reel/1704348461253027
- title | Video giới thiệu infinite-canvas
```

## 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 có nhiều dự án

Bạn có thể tạo nhiều canvas, kéo và thu phóng node, nối dây giữa các node, dùng bản đồ nhỏ (minimap) để không lạc, hoàn tác và làm lại, nhập và xuất canvas. Nhờ vậy mỗi chiến dịch hoặc mỗi sản phẩm có một canvas riêng, không lẫn vào nhau.

### Sáng tạo bằng AI

Ứng dụng gọi thẳng từ trình duyệt đến API tương thích OpenAI mà bạn cấu hình. Theo README, nó hỗ trợ tạo ảnh từ chữ, tạo ảnh từ ảnh, sửa ảnh theo ảnh tham chiếu, hỏi đáp văn bản, âm thanh và tạo video. Bạn không cần chuyển qua lại giữa nhiều công cụ.

### 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ó, tạo ảnh rồi chèn kết quả trở lại canvas. Nghĩa là AI hiểu ngữ cảnh bạn đang làm, bạn không phải dán lại mô tả mỗi lần.

### Agent chạy trên máy bạn

README giới thiệu Canvas Agent cục bộ: nó kết nối Codex hoặc Claude Code, để các agent này thao tác trên canvas hiện tại thông qua MCP. Ngoài ra có plugin cho ứng dụng Codex, cài xong sẽ tự đăng ký MCP và thử bật Agent cục bộ. Phần này dành cho người đã quen Codex hoặc Claude Code.

### Hệ thống plugin

Bạn có thể cài, bật, cập nhật, gỡ các plugin node từ xa qua URL. Lập trình viên có thể tự viết node bằng TypeScript SDK.

### Tự tùy biến cách gọi API

Nếu API trung gian của bạn không giống chuẩn OpenAI, bạn có thể tự định nghĩa cách gọi tạo ảnh hoặc video. Tính năng này hữu ích khi dùng các dịch vụ trung chuyển hoặc tự dựng.

### Thư viện prompt

Có sẵn 7 nguồn prompt mã nguồn mở, và bạn có thể thêm nguồn riêng theo định dạng JSON chuẩn. Dữ liệu được trình duyệt tải trực tiếp và cache vào IndexedDB.

## Cần chuẩn bị gì

Theo README, bạn cần chọn một trong hai cách chạy:

- **Chạy bằng Docker**: máy có Docker và lệnh `docker compose`. Repo có sẵn `Dockerfile` và `docker-compose.yml`.
- **Chạy bản phát triển (dev)**: máy có Git và công cụ **Bun**, vì README dùng `bun install` và `bun run dev`.

Bạn cũng cần:

- Một **Base URL** và **API Key** của dịch vụ tương thích OpenAI. Đây là thứ README yêu cầu nhập ở lần mở đầu tiên.
- Trình duyệt hiện đại để mở ứng dụng.

Tư liệu README không nêu phiên bản Bun hay Docker tối thiểu, không nói rõ hệ điều hành hỗ trợ và cũng không nói cần GPU. Vì ứng dụng gọi API bên ngoài để tạo ảnh nên việc nặng do dịch vụ API gánh, nhưng đây là suy luận của mình từ cách README mô tả, bạn nên kiểm tra thêm trong thư mục `docs/` của repo.

```note
API Key là chìa khóa tính tiền. Đừng gửi cho người khác và đừng chụp màn hình có lộ key. Phần lớn dịch vụ tạo ảnh và video tính phí theo lượt dùng, nên hãy đặt hạn mức chi tiêu trước khi chạy hàng loạt.
```

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

```steps
- Lấy mã nguồn | Tải repo về máy bằng git clone rồi vào thư mục dự án
- Chọn cách chạy | Dùng Docker (đơn giản nhất) hoặc Bun (bản dev)
- Chạy ứng dụng | docker compose up -d, hoặc bun install rồi bun run dev trong thư mục web
- Mở trình duyệt | Vào http://localhost:3000 (cách Docker)
- Nhập cấu hình API | Điền Base URL và API Key ở mục cấu hình góc trên bên phải
```

### Lấy mã nguồn về máy

Mở terminal (PowerShell trên Windows, Terminal trên macOS hoặc Linux) tại thư mục bạn muốn đặt dự án. README dùng đường dẫn SSH, nhưng nếu bạn chưa cấu hình khóa SSH cho GitHub thì dùng dạng HTTPS bên dưới sẽ dễ hơn:

```bash
git clone https://github.com/basketikun/infinite-canvas.git
cd infinite-canvas
```

Lệnh đầu tải toàn bộ repo về một thư mục tên `infinite-canvas`. Lệnh thứ hai đi vào thư mục đó. Người mới hay quên lệnh `cd` nên các lệnh sau báo không tìm thấy file.

Nếu bạn đã có SSH key, lệnh gốc trong README là:

```bash
git clone git@github.com:basketikun/infinite-canvas.git
cd infinite-canvas
```

### Cách A: chạy bằng Docker

Đây là cách README ghi để chạy ứng dụng. Bạn đứng trong thư mục `infinite-canvas` và chạy:

```bash
docker compose up -d
```

Lệnh này dựng và chạy ứng dụng ở chế độ nền (`-d`). Theo README, cổng mặc định là 3000, nên bạn mở trình duyệt vào `http://localhost:3000`. Trước khi chạy hãy chắc Docker đã được bật, nếu không lệnh sẽ báo lỗi không kết nối được.

### Cách B: chạy bản dev bằng Bun

Cách này hợp với lập trình viên muốn sửa code. README ghi như sau:

```bash
cd web
bun install
bun run dev
```

Bạn phải vào thư mục `web` (trong thư mục `infinite-canvas`) rồi mới chạy lệnh. `bun install` tải các thư viện cần thiết, còn `bun run dev` bật máy chủ phát triển. README không nói cổng của bản dev, nên hãy đọc dòng địa chỉ mà terminal in ra sau khi chạy và mở đúng địa chỉ đó.

### Nhập Base URL và API Key

Sau khi mở ứng dụng lần đầu, bấm vào **cấu hình ở góc trên bên phải**. Điền `Base URL` và `API Key` của dịch vụ tương thích OpenAI mà bạn dùng. Nếu API của bạn không giống kiểu gọi OpenAI mặc định, README cho biết bạn có thể tự viết cách gọi tạo ảnh hoặc video. Chi tiết nằm trong tài liệu của repo (thư mục `docs/`).

README còn gợi ý một dự án cùng tác giả tên chatgpt2api cho người chưa có API tạo ảnh. Mình chưa kiểm tra dự án đó nên bạn tự đọc kỹ trước khi dùng.

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

Theo README, dấu hiệu thành công khá đơn giản:

1. Trình duyệt mở được `http://localhost:3000` (cách Docker) và hiện giao diện canvas.
2. Bạn thấy mục cấu hình ở góc trên bên phải, điền được Base URL và API Key.
3. Sau khi điền, thử tạo một node tạo ảnh với prompt ngắn như một chiếc cốc trên bàn gỗ. Nếu ảnh hiện ra trên canvas thì mọi thứ đã nối thông.

Nếu trang mở được nhưng tạo ảnh báo lỗi thì ứng dụng đã chạy, vấn đề nằm ở phần API (sai địa chỉ, sai key, hết hạn mức). Xem mục lỗi bên dưới.

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

### Chủ shop làm ảnh sản phẩm

Bạn bán đồ gia dụng và có một tấm ảnh chụp sản phẩm nền lộn xộn. Hãy tạo một canvas riêng cho sản phẩm đó, đặt ảnh gốc làm ảnh tham chiếu, rồi dùng tính năng sửa ảnh theo ảnh tham chiếu với prompt kiểu:

```text
Giữ nguyên sản phẩm, đổi nền thành bàn bếp sáng, ánh sáng tự nhiên, phong cách tối giản
```

Bạn có thể nhân nhiều node với nhiều prompt nền khác nhau, đặt cạnh nhau để chọn ảnh ưng ý. Kết quả là một bộ ảnh nền khác nhau, và canvas lưu cả quá trình để bạn quay lại chỉnh.

> Canvas giúp bạn nhìn thấy cả quá trình thử, chứ không chỉ tấm ảnh cuối cùng.
>
> — Ông T

### Nhân viên marketing thử nhiều hướng ý tưởng

Bạn cần ba hướng hình ảnh cho một poster. Tạo ba nhánh trên cùng canvas, mỗi nhánh một phong cách, rồi dùng trợ lý canvas: chọn node vừa ưng, nhờ trợ lý đề xuất chỉnh sửa và sinh ảnh mới. Ảnh mới được chèn trở lại canvas. Kết quả là sếp xem được cả ba hướng cạnh nhau, và bạn xuất canvas ra để lưu hoặc gửi cho đồng nghiệp bằng tính năng nhập và xuất.

### Người làm nội dung dùng thư viện prompt

Bạn không giỏi viết prompt. Mở thư viện prompt có sẵn (7 nguồn mã nguồn mở), chọn mẫu gần với ý mình, chỉnh vài chữ rồi đưa vào node tạo ảnh. Bạn tiết kiệm thời gian mò mẫm, và có thể thêm nguồn prompt riêng của đội nếu đã có file JSON đúng định dạng.

### Lập trình viên mở rộng canvas

Bạn là dev và muốn có node riêng, ví dụ một bước xử lý ảnh theo quy trình của công ty. Repo có hệ thống plugin node cài qua URL và TypeScript SDK để tự viết. Bạn cũng có thể thử Canvas Agent cục bộ để Codex hoặc Claude Code thao tác trên canvas qua MCP. Cách cài chi tiết hai phần này README chưa ghi lệnh cụ thể, hãy xem thư mục `canvas-agent/`, `plugins/` và `docs/` trong repo.

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

### Mở localhost:3000 không được

Kiểm tra Docker đã chạy chưa và lệnh `docker compose up -d` đã chạy trong đúng thư mục `infinite-canvas` chưa. Nếu cổng 3000 đang bị chương trình khác dùng thì hãy tắt chương trình đó trước. Với bản dev bằng Bun, hãy mở đúng địa chỉ mà terminal in ra.

### Lệnh bun không nhận ra

Máy bạn chưa cài Bun. README dùng Bun cho bản dev nhưng không hướng dẫn cài, nên hãy cài Bun theo trang chính thức của nó, hoặc chọn cách Docker cho đơn giản.

### Tạo ảnh báo lỗi hoặc không ra ảnh

Thường do Base URL sai, API Key sai hoặc hết hạn mức. Mở lại mục cấu hình, kiểm tra từng ký tự, và thử gọi API đó bằng công cụ khác để chắc nó còn hoạt động. Nếu dịch vụ của bạn không theo chuẩn OpenAI, hãy dùng tính năng tùy biến cách gọi mà README nhắc tới.

### Mất canvas hoặc lịch sử

Dữ liệu mặc định nằm trong trình duyệt, nên xóa dữ liệu trình duyệt hoặc đổi máy sẽ mất. Ngoài ra README 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ũ khi cập nhật. Hãy thường xuyên xuất canvas quan trọng ra file để sao lưu trước khi nâng cấp.

### Docker lỗi khi kéo hoặc dựng ứng dụng

Đọc kỹ thông báo lỗi trong terminal. Lỗi thường gặp là Docker chưa bật hoặc mạng chậm. Chạy lại lệnh sau khi xử lý, và nếu vẫn lỗi thì xem `docker-compose.yml` cùng phần Docker trong tài liệu repo.

## Có nên dùng không

**Điểm mạnh:**

- Canvas giúp quản lý nhiều lần thử, hợp với việc sáng tạo lặp đi lặp lại.
- Mã nguồn mở, giấy phép MIT, dùng được cho cả mục đích thương mại.
- Dữ liệu và khóa API mặc định lưu trong trình duyệt của bạn.
- Không bị khóa vào một nhà cung cấp, vì dùng API tương thích OpenAI và cho phép tùy biến cách gọi.
- Có plugin và tích hợp Agent cho người muốn đi sâu.

**Giới hạn cần biết:**

- Bản thân ứng dụng không cung cấp mô hình AI, bạn phải có API riêng và tự chịu chi phí.
- Dự án đang phát triển, README cảnh báo định dạng lưu trữ có thể đổi và không đảm bảo tương thích dữ liệu cũ.
- README viết chủ yếu bằng tiếng Trung, tài liệu chi tiết (hướng dẫn node, phím tắt) cũng vậy, nên người không đọc được tiếng Trung sẽ phải dịch thêm.
- README yêu cầu bản fork hoặc PR giữ thông tin tác giả và dấu hiệu nhận diện ở giao diện, bạn nên đọc kỹ nếu định phát triển tiếp.
- README có phần tài trợ giới thiệu nhiều dịch vụ API. Đó là quảng cáo của bên thứ ba, bạn tự cân nhắc và kiểm tra trước khi đưa tiền hay dữ liệu cho bất kỳ bên nào.

Nếu bạn chỉ cần sửa nhanh một tấm ảnh, một công cụ chat tạo ảnh đơn giản có thể đủ. Còn nếu bạn hay làm ảnh theo nhiều vòng thử và muốn một nơi gom mọi thứ, infinite-canvas rất đáng cài thử bằng Docker, vì chỉ mất vài phút.

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

### infinite-canvas có miễn phí không?

Bản thân ứng dụng là mã nguồn mở, giấy phép MIT, nên dùng, sửa và dùng thương mại đều không mất phí. Nhưng ứng dụng gọi API tạo ảnh do bạn cấu hình, và phí của các API đó là chuyện riêng của nhà cung cấp mà bạn chọn.

### Cần GPU hoặc máy mạnh không?

README không nói cần GPU. Ứng dụng gọi API tương thích OpenAI mà bạn nhập vào để tạo ảnh, nên phần tính toán nặng do dịch vụ API đảm nhiệm. Yêu cầu cấu hình tối thiểu chưa có thông tin chính thức trong README.

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

README không liệt kê hệ điều hành hỗ trợ. Cách chạy bằng Docker (docker compose up -d) và bản dev bằng Bun đều là công cụ có thể dùng trên nhiều hệ điều hành, nhưng bạn nên tự thử và xem thêm tài liệu trong repo.

### Dữ liệu và API Key của tôi có an toàn không?

Theo README, API Key, Base URL, canvas, tư liệu và lịch sử tạo ảnh mặc định lưu trong trình duyệt của bạn, và trình duyệt gọi thẳng đến API bạn cấu hình. Tuy vậy ảnh và prompt vẫn được gửi đến nhà cung cấp API đó, nên hãy chọn dịch vụ bạn tin tưởng và đừng để lộ key.

### Dùng với dịch vụ API nào?

Ứng dụng dùng chuẩn tương thích OpenAI, và mô tả của tác giả nhắc đến các kênh như chatgpt2api, grok2api, flow2api, newapi. Nếu API của bạn gọi khác chuẩn, README cho biết bạn có thể tự tùy biến cách gọi tạo ảnh hoặc video.

### Cập nhật phiên bản mới có mất dữ liệu cũ không?

README 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 trữ cục bộ có thể bị thay đổi. Bạn nên xuất canvas quan trọng ra file để sao lưu trước khi nâng cấp.

### Có dùng được với Codex hoặc Claude Code không?

Có. README nói Canvas Agent cục bộ kết nối Codex hoặc Claude Code để các agent thao tác trên canvas qua MCP, và có plugin cho ứng dụng Codex. Lệnh cài chi tiết README chưa ghi, bạn xem thư mục canvas-agent, plugins và docs trong repo.
