# Giới thiệu

> What Kazuo AI and Kazuo Hub are, who they are for, and what the ecosystem contains.

# Giới thiệu / Overview

## Tiếng Việt

**Kazuo AI** là ứng dụng desktop dạng **overlay trong suốt, click-through, luôn nổi trên màn hình** (giống Rainmeter). Người dùng thả các **widget dạng plugin** lên desktop: AI chat với agent Claude Code hoặc Codex thật, terminal, ghi chú, đồng hồ, quản trị server (Docker, Kubernetes, NGINX, database), quản lý Cloudflare, ghi màn hình, lập lịch công việc... Widget kéo thả, thu nhỏ, đổi kích thước hoặc tách thành cửa sổ riêng.

**Kazuo Hub** là ứng dụng launcher riêng (giống Steam/Discord updater): tải về từ `kazuo.kaiitech.net`, đăng nhập Google (tuỳ chọn), rồi cài đặt, cập nhật và khởi chạy Kazuo AI bằng một cú bấm trên Windows, macOS và Linux.

Hệ sinh thái gồm:

- **Web Dashboard**: cùng bộ widget như overlay nhưng mở trong trình duyệt, kể cả từ máy khác hoặc trên Linux/WSL không có giao diện đồ hoạ. Đăng nhập tại `dash.kaiitech.net` để chọn và điều khiển nhiều máy của cùng tài khoản.
- **Plugin Store, Skills Store, MCP Store**: cài plugin mới, cài "Skill" cho AI agent, và cài MCP server remote vào Claude Code / Codex / Hermes / ai-chat trực tiếp từ trong ứng dụng, không cần build lại.
- **Điều phối nhiều agent AI**: định nghĩa vai trò agent (agent-role), giao việc cho agent trên máy khác (orchestrator, task-manager), chạy agent theo lịch (cron-job), gọi agent từ plugin khác theo kiểu lập trình (run-agent).
- **Bridge + MCP server cục bộ**: cho AI agent điều khiển chính ứng dụng như người dùng thật, hữu ích khi tự phát triển và kiểm thử plugin bằng AI.
- **Ứng dụng di động** (Android/iOS) để xem Web Dashboard và nhận thông báo đẩy.
- **Dịch vụ đám mây**: đăng nhập, quản lý thiết bị từ xa, giấy phép theo tổ chức/gói, và relay giữa trình duyệt với từng máy.

Dành cho ai: lập trình viên và người vận hành hệ thống muốn một "bàn làm việc" trên desktop nơi AI agent và công cụ vận hành đứng cạnh nhau; đội nhỏ muốn quản lý nhiều máy từ một tài khoản.

Công nghệ: Electron 33 + Svelte 5 + Vite + TypeScript; dịch vụ đám mây chạy trên Cloudflare Workers.

## English

**Kazuo AI** is a **transparent, click-through, always-on-top desktop overlay** (in the spirit of Rainmeter). Users drop **plugin widgets** onto the desktop: AI chat backed by a real Claude Code or Codex agent, a terminal, notes, a clock, server administration (Docker, Kubernetes, NGINX, databases), Cloudflare management, screen recording, scheduled jobs and more. Widgets can be dragged, minimised, resized or popped out into their own window.

**Kazuo Hub** is a separate launcher (think Steam or the Discord updater): download it from `kazuo.kaiitech.net`, optionally sign in with Google, and install, update and launch Kazuo AI with one click on Windows, macOS and Linux.

The ecosystem includes:

- **Web Dashboard**: the same widgets as the overlay, opened in a browser, including from another machine or on Linux/WSL without a graphical desktop. Sign in at `dash.kaiitech.net` to pick and control any of your machines.
- **Plugin Store, Skills Store, MCP Store**: install new plugins, install "Skills" for AI agents, and register remote MCP servers into Claude Code / Codex / Hermes / ai-chat from inside the app, without rebuilding anything.
- **Multi-agent orchestration**: define agent roles (agent-role), delegate work to agents on other machines (orchestrator, task-manager), run agents on a schedule (cron-job), and call an agent programmatically from another plugin (run-agent).
- **Local bridge + MCP server**: lets an AI agent drive the application itself like a user would, which is how plugins are developed and tested with AI.
- **Mobile app** (Android/iOS) for the Web Dashboard and push notifications.
- **Cloud services**: sign-in, remote device management, per-organisation licensing, and the relay between a browser and each machine.

Who it is for: developers and operators who want a desktop "workbench" where AI agents and operations tooling sit side by side; small teams that want to manage several machines from one account.

Stack: Electron 33 + Svelte 5 + Vite + TypeScript; cloud services run on Cloudflare Workers.