# locally-uncensored: studio AI cục bộ đa năng — hướng dẫn cài đặt và dùng

> locally-uncensored là ứng dụng desktop gom chat AI, tạo ảnh, tạo video, coding agent và agent tự động vào một cửa sổ. Bạn có thể chạy mô hình trên máy bằng GPU hoặc kết nối engine như Ollama, LM Studio; ứng dụng có trình cài sẵn cho Windows và Linux nên không cần Docker hay terminal khi dùng bản phát hành.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-04 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/locally-uncensored-studio-ai-cuc-bo

locally-uncensored là studio AI đa năng chạy trên máy tính, gom chat, tạo ảnh, tạo video và coding agent vào cùng một ứng dụng. Repo này hướng tới người muốn dùng AI cục bộ, không phải gửi mọi nội dung lên cloud và không muốn tự lắp nhiều công cụ rời rạc.

Bạn có thể dùng ứng dụng để hỏi đáp với mô hình ngôn ngữ, đọc tài liệu riêng, tạo hình ảnh, dựng video, sửa code và giao việc cho agent. Bản local không yêu cầu Docker, không cần terminal khi cài bản phát hành và không bắt buộc dùng cloud. Repo có giấy phép AGPL-3.0, hiện có khoảng 4119 sao và 654 fork.

Điểm đáng giá nhất là ứng dụng tự hỗ trợ nhiều phần khó của local AI. Model Manager giúp tìm model phù hợp phần cứng, ứng dụng có thể cài và quản lý ComfyUI, còn coding agent hiển thị diff trước khi sửa file. Nếu máy không đủ mạnh, bạn vẫn có thể bật LU Labs Cloud cho một số model lớn hơn.

```repo
- repo | PurpleDoubleD/locally-uncensored
- kind | Ứng dụng
- desc | Studio AI mã nguồn mở cho máy tính, hỗ trợ chat, tạo ảnh, video, lập trình và agent chạy cục bộ.
- stars | 4.1k
- lang | TypeScript
- license | AGPL-3.0
```

## locally-uncensored làm được gì

- **Chat với model cục bộ:** Bạn có thể trò chuyện với model chạy ngay trên máy. Ứng dụng hỗ trợ hiển thị quá trình suy nghĩ ở những model có tính năng này, điều chỉnh mức độ suy nghĩ, ghi nhớ giữa các cuộc trò chuyện và đổi persona.

- **Hỏi về ảnh và tài liệu riêng:** Bạn có thể tải ảnh lên để hỏi model có khả năng nhận ảnh. Với tài liệu, ứng dụng tạo chỉ mục cục bộ để bạn hỏi về nội dung riêng mà không phải lục từng file thủ công.

- **Nhập lịch sử trò chuyện:** Ứng dụng hỗ trợ nhập dữ liệu xuất từ ChatGPT, Claude hoặc Gemini. Điều này giúp bạn tiếp tục các luồng trao đổi cũ thay vì bắt đầu lại từ đầu.

- **Tạo ảnh và video:** Tab Create hỗ trợ text-to-image, image-to-image, chỉnh ảnh, inpainting bằng mask, xóa nền, tạo video, animate ảnh, kéo dài clip, motion control, talking character, music và Character Studio. Ứng dụng dùng ComfyUI phía sau nhưng che phần node graph, phù hợp với người không muốn tự nối workflow.

- **Quản lý LoRA và gallery:** LoRA picker đọc thư mục LoRA, cho phép xếp nhiều LoRA và chỉnh strength. Các sản phẩm tạo ra được đưa vào gallery để xem lại.

- **Coding agent:** Agent có thể lập bản đồ repo, sửa đúng các dòng bạn yêu cầu, hiển thị diff trước khi áp dụng, chạy test và đọc lỗi. Mỗi project có workspace, file explorer và quy tắc riêng trong file `.lurules`.

- **Agent đa công cụ:** Agent có thể tìm kiếm và đọc web, đọc hoặc ghi file, chạy shell, thực thi code, chụp màn hình, tạo ảnh, tạo video và kết nối MCP server của bạn. Công việc dài có thể chạy nền trong khi bạn tiếp tục làm việc khác.

- **Kiểm soát quyền:** Mỗi lần gọi công cụ đi qua permission gate. Bạn có thể giới hạn agent ở chế độ chỉ đọc hoặc cho phép truy cập workspace. Đây là lớp kiểm soát quan trọng khi agent có quyền đọc file, chạy lệnh hoặc sửa code.

- **Local API:** Settings có Local API để đưa model cục bộ ra một địa chỉ tương thích OpenAI, được bảo vệ bằng token. Nhờ vậy, các công cụ lập trình khác có thể dùng chung model trên máy của bạn.

- **Voice và computer control:** Voice cho phép nói chuyện bằng giọng nói với model local, có nhận dạng giọng nói, đọc câu trả lời và 15 giọng nói. Computer control cho phép model nhìn màn hình, dùng chuột và bàn phím trong ứng dụng bạn phê duyệt. Cả hai đều đang ở trạng thái Beta.

- **Dùng từ điện thoại:** Bạn có thể truy cập ứng dụng trên máy tính từ điện thoại qua mạng LAN hoặc Cloudflare tunnel. Thiết bị được ghép bằng QR code và passcode, đồng thời tính năng này mặc định tắt cho đến khi bạn chủ động bật.

- **Chạy model cloud khi cần:** LU Labs Cloud cung cấp các model lớn hơn khả năng của card đồ họa desktop, cùng một số tính năng Create nặng. Ứng dụng local vẫn có thể dùng miễn phí; cloud dùng tài khoản, gói dịch vụ hoặc credit pack riêng.

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

- Windows 10 hoặc 11, hoặc Linux. Repo cũng có bản macOS 14 trở lên cho máy Apple Silicon ở trạng thái Beta. Intel Mac không được hỗ trợ.
- Nếu cài bản Android, cần Android 7.0 trở lên trên điện thoại 64-bit arm64. Đây là APK cài ngoài, chưa nằm trong Google Play.
- Với bản desktop phát hành, README hướng dẫn tải bộ cài từ mục Releases. Bạn không cần Docker hoặc terminal để sử dụng bản này.
- Nếu build từ source, package.json yêu cầu Node.js từ phiên bản 22 trở lên. Bạn cũng cần Git và npm.
- Ứng dụng có thể dùng engine AI đã cài như Ollama hoặc LM Studio. Nếu chưa có engine, trình hướng dẫn lần đầu có thể cài một engine cho bạn.
- Tạo ảnh và video local cần GPU phù hợp. Model Manager đánh dấu model nào vừa với phần cứng. Một số model có thể chạy một phần trên CPU nhưng tốc độ sẽ thấp hơn.
- ComfyUI cần cho nhiều tính năng tạo ảnh và video. Ứng dụng có thể cài, khởi động, sửa và cập nhật ComfyUI.
- Voice chạy ở local mode và cần phần cứng đủ để nhận dạng, tổng hợp giọng nói. README không nêu cấu hình tối thiểu cụ thể.
- Nếu dùng LU Labs Cloud, bạn cần tài khoản LU Labs. Cloud có thể tính phí theo plan hoặc credit pack; README không nói rằng mọi tính năng cloud đều miễn phí.

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

```steps
- Chọn cách cài | Tải bản phát hành cho Windows, Linux, macOS hoặc Android
- Chạy trình cài | Mở installer và hoàn tất các bước như một ứng dụng thông thường
- Chạy trình hướng dẫn | Để ứng dụng tìm hoặc cài AI engine và ComfyUI
- Chọn model | Dùng Model Manager tải model phù hợp phần cứng
- Build từ source nếu cần | Clone repo, cài npm package và chạy bản phát triển
```

### Tải đúng bản cho thiết bị

Với Windows, README cung cấp installer NSIS `.exe` được khuyến nghị và file `.msi`. Windows 10 và 11 là hai phiên bản được hỗ trợ. Một số antivirus có thể cảnh báo installer NSIS chưa ký; README giải thích installer được build từ source công khai bằng GitHub Actions và có thể kiểm tra theo hướng dẫn trong `SECURITY.md`.

Với Linux, bạn có thể chọn AppImage, `.deb` hoặc `.rpm`. AppImage phù hợp khi bạn muốn chạy một file độc lập; `.deb` và `.rpm` phù hợp hơn với hệ thống dùng các định dạng gói tương ứng.

macOS chỉ hỗ trợ Apple Silicon từ macOS 14 trở lên và bản này là Beta. Intel Mac không được hỗ trợ. Android dùng APK arm64 và cần bật quyền cài ứng dụng từ trình duyệt hoặc ứng dụng quản lý file khi hệ thống hỏi.

### Cài bản phát hành

Sau khi tải file phù hợp, mở file cài đặt như các chương trình thông thường. README không yêu cầu chạy lệnh terminal cho bước này. Trên Windows, bạn có thể mở file `.exe` hoặc `.msi`; trên Linux, mở AppImage hoặc cài gói `.deb`/`.rpm` theo cách hệ điều hành của bạn hỗ trợ.

Nếu dùng Android, mở file APK từ nơi bạn đã tải. Khi Android hỏi, cho phép trình duyệt hoặc ứng dụng quản lý file cài ứng dụng. README cung cấp mã SHA-256 cho APK để bạn đối chiếu trước khi cài:

```text
dbd515d81bbc8ab70f21b850424f9f8b57ae88ae24962225beefc4116d139d2f
```

### Chạy trình hướng dẫn lần đầu

Mở Locally Uncensored sau khi cài. Ở lần chạy đầu, wizard tìm AI engine đang có trên máy. Nếu chưa có, wizard có thể cài một engine bằng một lần bấm. Ứng dụng cũng làm tương tự với ComfyUI để các tính năng ảnh và video có thành phần cần thiết.

Nếu bạn đã dùng Ollama hoặc LM Studio, ứng dụng có thể làm việc với engine hiện có và liên kết tới model đang được lưu ở đó mà không cần chép lại. Khi model Ollama hoặc LM Studio đang được nạp, thao tác nạp có thể hủy được.

### Chọn và tải model

Mở Model Manager và chọn model được đánh dấu phù hợp với phần cứng. Ứng dụng tải model bằng một lần bấm. Với model từ Hugging Face, chức năng “Use this model” có thể mở luồng tải trong Locally Uncensored. Model tìm được cũng có thể được đưa về quant phù hợp với card đồ họa.

Nếu máy có GPU hạn chế, ưu tiên model nhỏ hơn. README có nhắc một số model Liquid cỡ 1.7B và 2B, dung lượng khoảng 1 đến 1.7 GB mỗi model, dành cho máy nhỏ hơn. Tuy nhiên khả năng chạy thực tế còn tùy RAM, VRAM và engine.

### Build từ source

Nếu bạn là dev hoặc muốn chạy bản phát triển, mở terminal tại thư mục bạn muốn lưu project rồi chạy đúng các lệnh trong README:

```bash
git clone https://github.com/PurpleDoubleD/locally-uncensored.git
cd locally-uncensored
npm install
npm run dev          # browser dev mode
npm run tauri build  # desktop binary
```

`git clone` tải source về máy. `cd locally-uncensored` chuyển terminal vào thư mục repo. `npm install` cài các dependency được khai báo trong package.json. `npm run dev` chạy chế độ phát triển trên trình duyệt. `npm run tauri build` build binary desktop.

Nếu dùng Windows hoặc Linux/macOS để phát triển, repo có thêm `setup.bat`, `setup.ps1` và `setup.sh`. README nói các script này bootstrap Node, Git và Ollama cho dev mode. Hãy chọn script đúng hệ điều hành và xem contributing guide nếu bạn chưa quen với quy trình build.

```note
Mô hình local giữ dữ liệu trên máy theo mô tả của README, nhưng agent vẫn có thể đọc file, chạy lệnh hoặc dùng công cụ nếu bạn cấp quyền. Hãy kiểm tra permission gate trước khi cho agent làm việc trên thư mục thật.
```

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

Cách kiểm tra đơn giản nhất là mở ứng dụng và xem wizard có nhận ra AI engine hay đề nghị cài engine hay không. Nếu Model Manager hiển thị danh sách model và đánh dấu model phù hợp phần cứng, phần quản lý model đã hoạt động.

Tải một model nhỏ, chọn model đó rồi gửi một câu hỏi trong tab Chat. Kết quả mong đợi là câu trả lời xuất hiện trong cùng cửa sổ. Nếu model có hiển thị thinking, phần suy nghĩ sẽ được trình bày theo khả năng của model.

Bạn cũng có thể thử tab Create bằng một prompt ảnh đơn giản. Nếu ComfyUI được cài và khởi động đúng, ảnh tạo ra sẽ xuất hiện trong gallery. Với video, thời gian xử lý dài hơn; bản xem trước thô có thể xuất hiện trong lúc render ở những luồng được README hỗ trợ.

Nếu build từ source, `npm run dev` phải mở chế độ browser dev. `npm run tauri build` phải tạo được desktop binary. README không đưa ra một output terminal cố định, nên không nên lấy một dòng log cụ thể làm tiêu chí duy nhất.

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

### Chủ shop cần viết nội dung sản phẩm

Chủ shop có thể dùng tab Chat với model local để biến thông tin thô thành mô tả sản phẩm. Ví dụ, nhập tên sản phẩm, chất liệu, kích thước, nhóm khách hàng và giọng văn mong muốn. Sau đó yêu cầu tạo ba phiên bản: mô tả ngắn, nội dung đăng mạng xã hội và câu trả lời cho câu hỏi thường gặp.

Kết quả là các bản nháp được tạo trên máy. Nếu thông tin sản phẩm nằm trong nhiều tài liệu, bạn có thể đưa tài liệu vào chỉ mục local rồi hỏi lại theo từng nhóm sản phẩm.

### Nhân viên văn phòng cần hỏi nhanh về tài liệu nội bộ

Nhân viên có thể dùng tính năng hỏi tài liệu riêng thay vì đọc thủ công toàn bộ file. Hãy nạp các tài liệu liên quan, yêu cầu model tóm tắt chính sách, tìm điều khoản hoặc lập danh sách việc cần làm. Có thể yêu cầu model chỉ trả lời dựa trên tài liệu đã nạp và nói rõ phần nào không tìm thấy.

Cách này phù hợp khi tài liệu không nên gửi lên dịch vụ cloud. Tuy vậy, bạn vẫn cần kiểm tra câu trả lời với tài liệu gốc trước khi dùng trong quyết định quan trọng.

### Dev mới muốn sửa một repo an toàn hơn

Dev mở tab Code, chọn workspace của project rồi yêu cầu agent tìm lỗi hoặc thêm một chức năng nhỏ. Có thể viết prompt như: “Đọc cấu trúc repo, tìm nơi xử lý lỗi này, lập kế hoạch ngắn rồi chỉ sửa các file cần thiết. Hiển thị diff trước khi áp dụng và chạy test liên quan.”

Agent sẽ lập bản đồ repo, đề xuất thay đổi, hiển thị diff và có thể chạy test để đọc lỗi. File `.lurules` giúp bạn đặt quy tắc theo project. Với code chưa quen, nên dùng Ask hoặc Plan trước, xem diff rồi mới cho phép áp dụng.

### Người làm nội dung cần tạo ảnh và video

Trong Create, nhập prompt mô tả chủ thể, phong cách, bố cục và tỷ lệ mong muốn. Nếu cần sửa ảnh có sẵn, dùng image-to-image hoặc Edit; nếu cần xóa nền, dùng Remove Background. Người dùng nâng cao có thể chọn LoRA trong thư mục được ứng dụng đọc trực tiếp và điều chỉnh strength.

Kết quả được lưu trong gallery. Với video, bạn có thể thử tạo video từ prompt, animate một ảnh, kéo dài clip hoặc dùng motion control. Tốc độ và model khả dụng phụ thuộc GPU; những tác vụ nặng hơn có thể chuyển sang LU Labs Cloud nếu bạn bật Cloud và chấp nhận điều kiện tài khoản.

> Hãy bắt đầu bằng một model nhỏ, một workspace giới hạn và một yêu cầu cụ thể; local AI hữu ích nhất khi bạn kiểm soát được dữ liệu, quyền và chi phí.
>
> — Ông T

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

### Model không vừa bộ nhớ GPU

Model Manager có thể đánh dấu model không phù hợp phần cứng hoặc quá trình tải/nạp bị lỗi. Hãy chọn model nhỏ hơn, quant khác hoặc model được đánh dấu phù hợp. Không nên cố chạy model lớn nếu hệ thống bắt đầu thiếu bộ nhớ hoặc treo ứng dụng.

### ComfyUI không tạo được ảnh hoặc video

Create phụ thuộc vào ComfyUI và các thành phần model liên quan. Kiểm tra wizard, để ứng dụng sửa hoặc cập nhật ComfyUI, rồi thử model đơn giản hơn. Nếu log nêu thiếu encoder hoặc VAE, README cho biết ứng dụng có thể chỉ rõ thành phần và đề nghị tải xuống.

### Ứng dụng không thấy model trong Ollama hoặc LM Studio

Kiểm tra engine đang chạy và model đã được lưu ở nơi engine quản lý. Locally Uncensored có thể dùng engine hiện có và liên kết model mà không cần chép lại, nhưng README không nói mọi cấu hình tùy biến đều được nhận diện. Nếu model đang nạp, hãy chờ hoặc hủy thao tác rồi thử lại.

### Agent sửa nhầm file hoặc chạy hành động ngoài ý muốn

Agent có quyền đọc, ghi file, chạy shell và dùng công cụ tùy permission. Hãy bắt đầu bằng chế độ chỉ đọc, giới hạn workspace vào bản sao project và xem diff trước khi áp dụng. Computer control cũng yêu cầu xác nhận trước hành động; hãy dừng phiên nếu model thao tác sai.

### Không build được từ source

Kiểm tra Node.js có đáp ứng yêu cầu từ phiên bản 22 trở lên, terminal đang ở đúng thư mục repo và `npm install` đã hoàn tất. Trên Windows hoặc Linux/macOS, xem các script setup có sẵn và contributing guide. README không cung cấp danh sách lỗi build đầy đủ nên cần xem log cụ thể trong repo.

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

Nên dùng nếu bạn muốn một studio local có nhiều chức năng trong cùng ứng dụng: chat, tài liệu, ảnh, video, code và agent. Việc có wizard, Model Manager, ComfyUI tích hợp, permission gate và Local API giúp người mới bắt đầu dễ hơn so với tự ghép nhiều công cụ.

Repo cũng hợp với dev muốn coding agent hiển thị diff, chạy test và giữ quy tắc theo project. Windows và Linux là hai nền tảng chính được README mô tả rõ. Android có ứng dụng riêng để chat với model trên điện thoại hoặc kết nối về máy tính.

Giới hạn là trải nghiệm phụ thuộc mạnh vào phần cứng và model. Tạo ảnh, video, voice và model lớn có thể cần nhiều GPU memory; README không đưa cấu hình tối thiểu chung cho mọi tính năng. Voice và computer control đang Beta, còn macOS mới có phạm vi hỗ trợ hạn chế. Cloud cần tài khoản và có thể phát sinh chi phí.

Bạn nên chọn công cụ khác nếu chỉ cần chat cloud đơn giản, không muốn quản lý model local, hoặc máy không đủ tài nguyên cho các tác vụ tạo ảnh và video. Nếu yêu cầu doanh nghiệp cần hỗ trợ thương mại, kiểm soát phát hành hoặc giấy phép đơn giản hơn AGPL-3.0, hãy xem xét kỹ giấy phép và quy trình triển khai trước khi đưa vào hệ thống chính thức.

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

### locally-uncensored có miễn phí không?

Ứng dụng local được README mô tả là miễn phí và mã nguồn mở. LU Labs Cloud dùng tài khoản, plan hoặc credit pack; README không nói mọi tính năng cloud đều miễn phí.

### Có cần GPU để chạy không?

README không nêu GPU là điều kiện bắt buộc cho mọi chức năng. Tuy nhiên tạo ảnh, video và model lớn phụ thuộc nhiều vào GPU; Model Manager đánh dấu model phù hợp phần cứng, còn một số model có thể chạy một phần trên CPU.

### Có chạy được trên Windows không?

Có. README hỗ trợ Windows 10 và 11, với installer `.exe` được khuyến nghị hoặc file `.msi`. Bản phát hành không yêu cầu Docker hay terminal khi sử dụng.

### Có chạy được trên macOS hoặc Android không?

macOS 14 trở lên trên Apple Silicon có bản Beta; Intel Mac không được hỗ trợ. Android cần phiên bản 7.0 trở lên và máy 64-bit arm64, cài bằng APK ngoài Google Play.

### Dữ liệu chat local có an toàn không?

README nói các cuộc chat với model chạy trên thiết bị được giữ trên máy, và local mode chạy trên máy của bạn. Tuy vậy, agent có thể đọc file, chạy lệnh hoặc dùng công cụ nếu bạn cấp quyền, nên cần kiểm tra permission gate.

### Có cần biết terminal để cài không?

Không cần nếu bạn dùng bản phát hành desktop: mở installer như ứng dụng thông thường và làm theo wizard. Nếu build từ source, bạn cần Git, Node.js từ phiên bản 22 trở lên, npm và các lệnh được ghi trong README.

### locally-uncensored khác gì việc dùng riêng Ollama hoặc LM Studio?

Ứng dụng có thể dùng engine và model đang có trong Ollama hoặc LM Studio mà không cần chép lại. Điểm khác là nó gom thêm chat, Create, Code, Agent, gallery, permission gate và Local API vào một giao diện; README không đưa bảng so sánh chi tiết với từng công cụ.
