holaboss-ai/holaOS

Kết luận: partial · Công nghệ: ai-agent · mcp · electron · typescript · agent-runtime

holaOS là workspace AI agent all-in-one mã nguồn mở, cho phép chạy nhiều agent như Claude Code và Codex trên cùng một lớp tích hợp: app, browser, file, công cụ và hơn 100 integration qua MCP. Phù hợp như một lớp điều phối/desktop agent runtime có shared memory và hỗ trợ both built-in models lẫn BYOK, nhưng giá trị mạnh nhất nằm ở orchestration hơn là model lõi.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

holaboss-ai/holaOS là một workspace AI agent all-in-one mã nguồn mở: hiểu đơn giản là một “bàn làm việc” nơi bạn có thể chạy nhiều agent như Claude Code, Codex, hoặc agent built-in của holaOS trong cùng một chỗ.

Thay vì mỗi agent có bộ nhớ, công cụ và cách kết nối riêng, holaOS gom chúng lại thành một môi trường chung: file, app, browser, integrations, MCP, và shared memory.

🎯 Giải quyết vấn đề gì? Dành cho ai?

Khi dùng AI agent, người mới thường gặp vài vấn đề:

• Mỗi agent dùng một kiểu: Claude Code ở một nơi, Codex ở nơi khác, browser/app/file lại nằm riêng.
• Agent hay “quên ngữ cảnh”: hôm nay làm dở, mai mở lại phải giải thích từ đầu.
• Muốn agent thao tác với Gmail, Notion, Slack, GitHub, Linear, browser, file... thì phải tự nối từng thứ.
• Kết quả thường chỉ là đoạn chat, chưa phải file/app/kết quả thật có thể dùng ngay.

holaOS sinh ra để giải quyết chuyện đó bằng cách tạo một workspace chung cho người dùng và agent.

Dự án này phù hợp với:

• Developer muốn chạy Claude Code, Codex hoặc agent khác trong cùng một môi trường.
• Người làm sản phẩm, vận hành, marketing, nghiên cứu muốn AI thao tác qua app, browser, file và công cụ làm việc.
• Team muốn có một lớp điều phối agent: cùng memory, cùng integrations, cùng workflow.
• Người thích self-host/open-source và muốn tự kiểm soát môi trường chạy agent.

⚙️ Hoạt động ra sao?

• Một workspace chung: Bạn mở holaOS như một desktop app. Trong đó có agent, app, browser, file và marketplace để cài thêm công cụ.
• Chạy nhiều agent cạnh nhau: Có thể dùng Claude Code, Codex, hoặc agent built-in của holaOS mà không phải dựng lại môi trường từ đầu.
• Shared memory: Ngữ cảnh, sở thích, lịch sử dự án được lưu chung, local-first, dưới dạng file có thể đọc và chỉnh sửa. Agent sau vẫn có thể nhớ việc agent trước đã làm.
• Kết nối công cụ qua integrations và MCP: MCP là viết tắt của Model Context Protocol, hiểu đơn giản là “chuẩn cắm thêm công cụ cho AI agent”. Nhờ đó agent có thể dùng thêm Gmail, Notion, Slack, GitHub, Linear và nhiều dịch vụ khác.
• HolaApps: App thật được mở ngay cạnh agent, ví dụ Notion hoặc browser. Agent có thể thao tác trong app, còn bạn vẫn nhìn thấy và can thiệp được.
• Models linh hoạt: Có thể dùng model built-in của holaOS, hoặc BYOK. BYOK nghĩa là “Bring Your Own Keys”, tức bạn dùng API key của chính mình từ OpenAI, Anthropic hoặc endpoint tương thích.
• Tạo kết quả thật: Agent không chỉ trả lời bằng text, mà có thể tạo file .xlsx, .pptx, .docx, dùng browser, chạy automation hoặc gửi kết quả về Slack, Telegram, WeChat, Feishu.

🆚 Khi nào nên dùng / không nên

Nên dùng holaOS khi:

• Bạn muốn một nơi duy nhất để chạy nhiều agent như Claude Code và Codex.
• Bạn cần agent làm việc với app, browser, file và nhiều integration.
• Bạn muốn memory dùng chung giữa các agent và các phiên làm việc.
• Bạn thích hướng local-first, open-source, có thể self-host.
• Bạn cần một lớp điều phối agent hơn là chỉ một chatbot đơn lẻ.

Có thể không cần dùng holaOS khi:

• Bạn chỉ cần hỏi đáp đơn giản với một chatbot như ChatGPT/Claude.
• Bạn chỉ viết code trong một IDE và không cần agent thao tác với app/browser/integrations.
• Bạn không muốn cài desktop app hoặc không muốn quản lý môi trường local.
• Bạn cần một sản phẩm cực kỳ ổn định cho production ngay lập tức mà chưa muốn chấp nhận rủi ro của dự án open-source đang phát triển.

So sánh ngắn:

• Chatbot thông thường: tốt cho hỏi đáp, giải thích, viết nội dung nhanh.
• Agent riêng lẻ như Claude Code hoặc Codex: tốt cho một nhóm tác vụ cụ thể, nhất là coding.
• holaOS: tốt khi bạn muốn nhiều agent cùng dùng chung memory, tools, apps, browser, files và integrations trong một workspace.

🚀 Bắt đầu nhanh

Cách nhanh nhất là dùng script cài đặt một dòng cho macOS, Linux hoặc WSL:

curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch

Nếu muốn tự kiểm soát từng bước, bạn có thể cài thủ công:

git clone https://github.com/holaboss-ai/holaOS.git
cd holaOS

git --version
node --version
npm --version

npm run desktop:install
cp apps/desktop/.env.example apps/desktop/.env
npm run desktop:prepare-runtime:local
npm run desktop:typecheck
npm run desktop:dev

Ví dụ tối thiểu sau khi chạy được app:

Mở holaOS, chọn một agent như Codex hoặc Claude Code, rồi thử giao việc:

"Hãy đọc project hiện tại, tóm tắt cấu trúc thư mục, tìm file README, và đề xuất 3 việc nên làm tiếp theo."

Agent sẽ làm việc trong cùng workspace, có thể dùng file, memory và các công cụ đã được kết nối.

Nếu bạn dùng một coding agent để cài hộ, có thể đưa nguyên câu này:

Run the holaOS install script from https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh. It should install git and Node.js 24.14.1/npm if they are missing, clone or update the repo into ~/holaboss-ai unless I specify another --dir, run desktop:install, create apps/desktop/.env from apps/desktop/.env.example if needed, run desktop:prepare-runtime:local and desktop:typecheck, and only run desktop:dev if I ask for --launch. If Electron cannot open, stop after verification and tell me the next manual step.

✅ Điểm mạnh & ⚠️ Hạn chế

✅ Điểm mạnh:

• Chạy được nhiều agent trong cùng một workspace, ví dụ Claude Code, Codex, và agent built-in của holaOS.
• Shared memory giúp agent không phải bắt đầu lại từ đầu sau mỗi phiên làm việc.
• Local-first: memory nằm trên máy bạn, ở dạng file có thể đọc và chỉnh.
• Có integrations, MCP, skills và marketplace để mở rộng khả năng của agent.
• Hỗ trợ cả model built-in lẫn BYOK, linh hoạt giữa tiện lợi và tự kiểm soát.
• Có desktop app trên macOS, Windows và Linux.

⚠️ Hạn chế:

• Giá trị chính nằm ở orchestration, tức điều phối agent/công cụ/workspace, không phải tự nó là một model AI lõi mới.
• Người mới hoàn toàn có thể thấy nhiều khái niệm cùng lúc: agent, MCP, integrations, shared memory, BYOK.
• Cài thủ công cần biết cơ bản về git, node, npm và môi trường desktop.
• Vì agent có thể thao tác với app, file và browser, bạn nên kiểm tra quyền truy cập và không giao việc nhạy cảm khi chưa hiểu rõ cấu hình.
• Một số tính năng phụ thuộc vào model, API key, integration hoặc môi trường máy của bạn.