# Tahi Media Studio — Autonomous AI Agent Guide (AGENT.md)

> **Specification & Autonomous Automation Guide for AI Coding Agents**  
> Targets: **Claude Code**, **Hermes Agent**, **OpenAI Codex**, **Cursor**, **Aider**  
> Version: `1.2.1` | Published: `10/11/2026` | Official URL: `https://tahistudio.dagbots.com/AGENT.md`

---

## 1. Tổng Quan Về Tahi Media Studio (Overview)

Tahi Media Studio là trạm làm việc sản xuất video và âm thanh AI thế hệ mới, hoạt động theo mô hình **Local-First Core & Plugin Sidecar Architecture**:
- **Core Go Engine:** Chạy trực tiếp trên máy khách (macOS Apple Silicon/Intel, Windows x64, Linux x64), an toàn tuyệt đối, hiệu năng cao, mức chiếm dụng RAM cực thấp (< 30 MB).
- **Hỗ trợ 2 phương thức điều khiển:**
  1. Giao diện trực quan Desktop Web UI (`http://127.0.0.1:8600`).
  2. **Giao thức MCP Server chuẩn (`stdio`):** Cho phép AI Agent tự động gọi công cụ (tool calling) để tạo video, ảnh, lồng tiếng và ghép clip tự hành 100%.

---

## 2. Cài Đặt 1-Chạm (1-Line Quickstart for AI Agents)

Để cài đặt phần mềm vào máy của người dùng, AI Agent chỉ cần thực thi lệnh sau:

```bash
curl -fsSL https://tahistudio.dagbots.com/install.sh | bash
```

### Các đường dẫn cài đặt:
- Thư mục cài đặt: `~/.tahi-media-studio/`
- Binary thực thi: `~/.local/bin/tahi-media` (đã tự động tạo symlink)
- Thư mục dữ liệu & bản quyền: `~/.tahi-media/`

Kiểm tra sau khi cài:
```bash
~/.local/bin/tahi-media version
# Output mong đợi: tahi-media 1.2.1
```

---

## 3. Cấu Hình MCP Server Cho AI Agent (.mcp.json)

Để tích hợp bộ công cụ của Tahi Media Studio vào workspace của dự án, AI Agent hãy thêm khối cấu hình sau vào `.mcp.json` (hoặc `claude.json` / Claude Desktop config):

```json
{
  "mcpServers": {
    "tahi-media": {
      "command": "tahi-media",
      "args": ["mcp"]
    }
  }
}
```

*Lưu ý: Đảm bảo `~/.local/bin` có trong biến môi trường `$PATH` của hệ thống, hoặc truyền đường dẫn tuyệt đối: `"$HOME/.local/bin/tahi-media"`.*

---

## 4. Quản Lý Bản Quyền & Định Danh Máy (Device Lock & License)

### 4.1. Lấy mã HWID của thiết bị:
Hệ thống sử dụng Hardware ID độc bản trích xuất trực tiếp từ phần cứng máy khách:
```bash
tahi-media license status
```
*Kết quả trả về JSON gồm: `hwid`, trạng thái `activated`, số dư ví và hạn sử dụng.*

### 4.2. Kích hoạt License Key:
Khi người dùng cung cấp mã bản quyền (dạng `tahi_kling_...` hoặc Core License):
```bash
tahi-media license activate <MÃ_LICENSE_KEY>
```
Core Go sẽ tự động phân luồng xác thực tới Central Brain tương ứng, lưu cấu hình vào máy và mở khóa gói tài nguyên ngay lập tức.

---

## 5. Danh Mục Plugin Chính Thức & Công Cụ Khả Dụng (Plugins Catalog)

Tahi Media Studio phân phối 5 plugin chính thức sẵn sàng tải trực tiếp qua Server Registry hoặc tải gói `.zip`:

| Plugin ID | Tên Plugin & Phiên bản | Năng lực cốt lõi (Capabilities) | Chi phí / Ghi chú |
| :--- | :--- | :--- | :--- |
| **`tahi-kling`** | Tahi Kling AI (v1.1.0) | `kling.video`<br>`kling.motion` | **Kling 4.0 Flagship (500đ):** Khóa ảnh đầu & ảnh cuối (Start/Tail Frame), tỉ lệ 21:9 Ultrawide, 9:16, 16:9.<br>**Nhại thao tác (800đ):** Chép cử động từ video mẫu sang ảnh nhân vật. |
| **`tahi-voice-capcut`**| Voice CapCut (v1.0.0) | `capcut.tts` | **Zero Token / Miễn phí 100%:** Giọng đọc tiếng Việt truyền cảm TikTok (`BV075_streaming` Thanh Niên, `BV074_streaming` Cô Gái, Review Phim...). |
| **`tahi-muse`** | Tahi Muse (v3.0.0) | `muse.image`<br>`muse.video`<br>`muse.merge` | **Go Native Driver:** Điều khiển Chrome ẩn qua CDP, hỗ trợ xoay vòng nhiều tài khoản (Multi-Account Rotation) và ghép video MP4. |
| **`tahi-grok`** | Tahi Grok AI (v1.0.0) | `grok.video`<br>`grok.image`<br>`grok.chat` | **Grok2API Go Native:** Tạo video xAI Aurora 1.5, tạo ảnh Grok Flux và AI Director chat bóc tách kịch bản phân cảnh tự động. |
| **`tahi-motioncut`** | Tahi MotionCut (v1.0.0) | `motioncut.video` | **Zero AI Credit:** Dựng video lập trình 100% bằng HTML5 + GSAP + Three.js 3D + CapCut Voice, chuyên trị video dọc TikTok/Reels tri thức. |

---

## 6. Lệnh Quản Trị Dòng Lệnh (CLI Command Reference)

AI Agent có thể tương tác với Studio qua Terminal bằng các câu lệnh súc tích:

```bash
# 1. Khởi động Web Studio giao diện đồ họa cục bộ
tahi-media --addr 127.0.0.1:8600

# 2. Khởi động ở chế độ MCP Server (dành cho Agent)
tahi-media mcp

# 3. Quản lý danh sách Plugin
tahi-media plugins list
tahi-media plugins add https://tahistudio.dagbots.com/downloads/plugins/tahi-kling.zip
tahi-media plugins remove <plugin-id>
tahi-media plugins restart <plugin-id>

# 4. Kiểm tra sức khỏe hệ thống (System Doctor)
tahi-media doctor

# 5. Quản lý bản quyền
tahi-media license status
tahi-media license activate <license_key>
tahi-media license deactivate
```

---

## 7. Kịch Bản Tự Hành Mẫu Cho AI Agent (Autonomous Workflows)

### Quy trình tạo 1 video TikTok hoàn chỉnh từ ý tưởng:
1. **Bước 1:** AI Agent nhận chủ đề từ người dùng (ví dụ: *"TVC 15s giới thiệu serum hoa hồng"*).
2. **Bước 2:** Gọi công cụ `kling.video` hoặc `grok.video` để sinh các đoạn video chất lượng cao theo từng phân cảnh (Scene Cards).
3. **Bước 3:** Gọi công cụ `capcut.tts` để sinh file âm thanh giọng đọc truyền cảm cho kịch bản.
4. **Bước 4:** Xuất file MP4 hoàn thiện vào thư mục đầu ra của người dùng và báo cáo kết quả kèm đường dẫn file `MEDIA:`.

---

*Tài liệu này được tối ưu hóa cho AI Context Windows. Để xem giao diện sản phẩm hoặc tải bản Desktop đóng gói sẵn, truy cập:* **https://tahistudio.dagbots.com**