Giới thiệu & Mục đích

AionUi là một ứng dụng giao diện đồ họa (GUI) dành cho máy tính, được thiết kế để bao bọc và nâng cao trải nghiệm sử dụng các công cụ AI dòng lệnh (CLI) như Google Gemini CLI, Claude Code, Qwen Code, v.v. Thay vì phải thao tác qua các dòng lệnh khô khan, AionUi cung cấp một không gian làm việc trực quan (“Cowork workspace”), cho phép người dùng quản lý nhiều trợ lý AI cùng lúc, tự động hóa quy trình văn phòng, xử lý tệp tin và lưu trữ dữ liệu cục bộ để đảm bảo quyền riêng tư. Dự án này giải quyết vấn đề phân mảnh khi sử dụng nhiều công cụ AI và rào cản kỹ thuật của giao diện dòng lệnh.

Tính năng chính

Hỗ trợ đa tác nhân (Multi-Agent): Tích hợp và chuyển đổi linh hoạt giữa Gemini CLI, Claude Code, Codex, Qwen Code, và nhiều mô hình khác trong một giao diện duy nhất.
Làm việc cục bộ & Bảo mật: Toàn bộ lịch sử trò chuyện và tệp tin được lưu trữ trên máy người dùng (SQLite), đảm bảo dữ liệu không bị rò rỉ lên đám mây.
Truy cập từ xa (WebUI Mode): Biến máy tính thành máy chủ AI, cho phép truy cập giao diện làm việc từ trình duyệt trên điện thoại hoặc thiết bị khác.
Quản lý tệp tin thông minh: Hỗ trợ đổi tên hàng loạt, tự động sắp xếp thư mục và xem trước (preview) hơn 9 định dạng tệp (PDF, Excel, Code…) ngay trong ứng dụng.
Tạo & Chỉnh sửa ảnh: Tích hợp khả năng sinh ảnh và chỉnh sửa ảnh thông qua các mô hình AI như Gemini.
Đa nền tảng: Hỗ trợ đầy đủ macOS, Windows và Linux.

Hướng dẫn cài đặt Local (macOS)

Cách đơn giản nhất để cài đặt AionUi trên macOS là sử dụng Homebrew hoặc tải file DMG trực tiếp.

Cách 1: Sử dụng Homebrew (Khuyên dùng)

Mở Terminal.
Chạy lệnh sau để cài đặt tự động:
```
brew install aionui
```

Cách 2: Cài đặt thủ công

Truy cập trang Releases của repository.
Tải xuống file .dmg phù hợp với chip của máy (Apple Silicon hoặc Intel).
Mở file .dmg và kéo biểu tượng AionUi vào thư mục Applications.

Lưu ý sau khi cài đặt:

Khi khởi chạy lần đầu, bạn cần cung cấp API Key (ví dụ: Google Gemini API Key) trong phần Settings để bắt đầu sử dụng.

Hướng dẫn Docker

Hiện tại repository chưa cung cấp Dockerfile chính thức, nhưng bạn có thể tự xây dựng một image dựa trên bản cài đặt cho Linux (Ubuntu) để chạy chế độ WebUI. Dưới đây là gợi ý Dockerfile cơ bản:

Tạo file tên là Dockerfile: ```dockerfile FROM ubuntu:22.04

Cài đặt các thư viện phụ thuộc cần thiết cho Electron app

RUN apt-get update && apt-get install -y
wget
libgtk-3-0
libnss3
libasound2
libgbm1
libxshmfence1
ca-certificates
&& rm -rf /var/lib/apt/lists/*

Tải xuống file .deb (thay đổi phiên bản v1.5.2 nếu có bản mới hơn)

RUN wget https://github.com/iOfficeAI/AionUi/releases/download/v1.5.2/AionUi_1.5.2_amd64.deb -O aionui.deb

Cài đặt gói .deb

RUN apt-get install -y ./aionui.deb && rm aionui.deb

Thiết lập biến môi trường để chạy không cần sandbox (cần cho Docker)

ENV AIONUI_NO_SANDBOX=1

Mở port mặc định của WebUI

EXPOSE 25808

Lệnh chạy ứng dụng ở chế độ WebUI và cho phép truy cập từ xa

CMD [“AionUi”, “–webui”, “–remote”, “–no-sandbox”]

2. Build và chạy Docker container:
```bash
# Build image
docker build -t aionui .

# Run container (map port 25808)
docker run -d -p 25808:25808 --name aionui-instance aionui

Sau đó truy cập http://localhost:25808 trên trình duyệt.

Ví dụ Code (Example Code)

AionUi chủ yếu là ứng dụng GUI, nhưng nó cung cấp giao diện dòng lệnh (CLI) mạnh mẽ để khởi chạy các chế độ đặc biệt. Dưới đây là ví dụ về cách khởi chạy AionUi ở chế độ WebUI để truy cập từ xa và reset mật khẩu quản trị viên trên macOS:

# 1. Khởi chạy chế độ WebUI (cho phép truy cập qua trình duyệt)
# Sau khi chạy, truy cập vào đường dẫn http://localhost:25808
/Applications/AionUi.app/Contents/MacOS/AionUi --webui

# 2. Cho phép truy cập từ mạng LAN (Remote Access)
# Hữu ích khi bạn muốn dùng iPad/điện thoại để chat với AI trên máy tính
/Applications/AionUi.app/Contents/MacOS/AionUi --webui --remote

# 3. Reset mật khẩu tài khoản admin (nếu quên mật khẩu WebUI)
# Lưu ý: Cần tắt ứng dụng trước khi chạy lệnh này
/Applications/AionUi.app/Contents/MacOS/AionUi --resetpass admin

Sources

Tags: github