# oh-my-hermes: Chạy agent AI song song — hướng dẫn cài đặt và dùng

> oh-my-hermes là lớp điều hành độc lập cho Hermes Agent, bổ sung điều phối nhiều agent AI, workflow song song, định tuyến model, kỹ năng chuyên môn và kiểm tra bằng bằng chứng. Repo dùng Python từ 3.11 trở lên; có trình cài đặt cho macOS, Linux và Windows nên người mới có thể bắt đầu khá nhanh.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-27 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/oh-my-hermes-chay-agent-ai-song-song

oh-my-hermes là một lớp điều phối cho Hermes Agent, giúp bạn giao một mục tiêu lớn cho nhiều agent AI cùng làm theo các làn công việc riêng. Mỗi làn có thể dùng model, mức suy luận và kỹ năng phù hợp với loại việc. Repo không thay thế hay vá Hermes Agent. Nó đứng bên trên để quyết định việc nào đi đâu, ai sở hữu phần mã nào và thế nào mới được xem là hoàn tất.

Công cụ này hợp với lập trình viên, nhóm phát triển sản phẩm và người thường xuyên xử lý công việc nhiều bước. Điểm đáng giá nhất là OMH phân biệt rõ kế hoạch, kết quả agent tự báo và kết quả đã được kiểm chứng. Bạn có thể xem video ngắn bên dưới để hình dung nhanh cách làm việc, sau đó dùng các lệnh trong bài để cài và kiểm tra trên máy của mình.

```repo
- repo | rlaope/oh-my-hermes
- kind | Agent
- desc | Lớp điều phối cho Hermes Agent, giúp chia việc cho nhiều agent AI chạy song song theo model, kỹ năng và phạm vi tệp.
- stars | 5.6k
- lang | Python
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/Bfp5XG7-5QA
- facebook | https://www.facebook.com/reel/1670444064787901
- title | Video giới thiệu oh-my-hermes
```

## oh-my-hermes làm được gì

### Chia mục tiêu lớn thành các làn chạy song song

Với `/dag-ulw`, OMH biến mục tiêu thành một đồ thị gồm nhiều nút nhỏ. Các nút đã sẵn sàng có thể chạy đồng thời, nhưng những nút đang chạy cùng lúc không dùng chung phạm vi ghi. Một nút riêng sẽ kiểm tra mục tiêu trước khi OMH trả báo cáo. Nếu có nút thất bại, hệ thống có thể sửa trước khi kết luận.

Điều này hữu ích khi bạn cần vừa phân tích mã, vừa viết kiểm thử, vừa kiểm tra tài liệu. Bạn không phải tự mở nhiều phiên agent rồi theo dõi thủ công từng phiên.

### Chọn model theo loại công việc

Mỗi làn được gắn một nhóm công việc như `ultrabrain`, `deep`, `visual-engineering` và `quick`. Nhóm này quyết định chuỗi model và mức suy luận dùng cho làn đó. Bạn có thể chỉnh lại chuỗi này bằng trình chọn mở từ `omh model`.

Nếu một nhà cung cấp từ chối model, chuỗi sẽ chuyển sang model tiếp theo thay vì âm thầm hạ cấp. Nhờ vậy, bạn biết làn đang chạy với lựa chọn nào và có thể cân bằng giữa chất lượng, tốc độ và chi phí.

### Tự nạp kỹ năng chuyên môn

OMH cung cấp hơn một trăm chuyên gia dạng `omh-*`, gồm frontend, backend, Rust, rà soát bảo mật và các cổng kiểm tra. Bạn không cần tự gọi từng kỹ năng. Bộ định tuyến sẽ chọn kỹ năng phù hợp rồi nạp vào lần chạy dưới dạng tool call.

Với người mới, đây là cách làm giảm số lượng câu lệnh cần nhớ. Với dev có kinh nghiệm, hệ thống kỹ năng giúp quy trình có thể lặp lại giữa nhiều dự án.

### Hỗ trợ LSP khi đọc và sửa mã

Khi bật `lsp_tools` trong phần cài đặt plugin OMH, hệ thống có thể lấy định nghĩa, tham chiếu và đổi tên từ language server thay vì chỉ tìm chuỗi văn bản. Alias, re-export và tên bị che khuất được xử lý theo ý nghĩa của mã.

Tính năng này phù hợp với refactor lớn. Tuy nhiên, README cho biết LSP đang tắt mặc định, nên bạn cần chủ động bật nếu muốn dùng.

### Ghi nhớ dài hạn có lý do rõ ràng

OMH không âm thầm ghi nhớ mọi thứ. Mỗi đề xuất ghi nhớ được giữ lại, từ chối hoặc trì hoãn kèm lý do. Phiên sau nhận một gói hồi tưởng được xếp hạng theo công việc và cắt theo ngân sách token.

Bộ nhớ riêng của Hermes không bị đọc hoặc vá. Cách tách này giúp bạn biết phần ghi nhớ nào thuộc OMH và tránh nhầm rằng một kết quả cũ đã được kiểm chứng.

### Có giao diện TUI riêng

Chạy `omh` để mở TUI của OMH trên gateway của Hermes. Bạn có thể đổi giao diện bằng `/theme`, xem sơ đồ hộp của `/dag-ulw`, theo dõi cây làn chạy cùng model, mức suy luận và token, điều khiển hoặc ngắt agent từ danh sách agent, chạy một dòng shell bắt đầu bằng `!` và quay lại bằng `Esc Esc`.

OMH không sửa Hermes để tạo bề mặt này. Nó cung cấp một giao diện riêng để theo dõi công việc.

### Đặt bằng chứng lên trước tuyên bố hoàn tất

OMH phân biệt các trạng thái như `Plan · not run`, `Code · reported done` và `Test · verified`. Một agent tự nói đã xong chưa được xem là đã kiểm tra. Một lần chạy chỉ được xem là đã xác minh khi test, review hoặc cổng CI thực sự vượt qua.

Đây là điểm quan trọng khi dùng AI để sửa mã. Bạn vẫn cần nhìn vào bằng chứng thay vì chỉ tin dòng báo cáo cuối cùng.

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

- Máy macOS, Linux hoặc Windows. README có trình cài đặt cho macOS/Linux và Windows.
- Python từ 3.11 trở lên. Đây là yêu cầu được khai báo trong `pyproject.toml`.
- Nếu cài bằng Bun hoặc npm, cần Node 18 trở lên và Python 3.11 trở lên có trong `PATH`.
- Hermes Agent và gateway của Hermes, vì OMH là lớp điều hành chạy trên Hermes Agent.
- Với cách cài Windows bằng PowerShell, README yêu cầu PowerShell 5.1 trở lên.
- Một cách cài phù hợp: script cài đặt, Homebrew, Bun, npm hoặc đường dẫn skill của Hermes.

Tư liệu được cung cấp không nêu cụ thể tài khoản dịch vụ, API key, nhà cung cấp model hay cấu hình phần cứng GPU. Vì vậy, bạn không nên tự suy ra rằng mọi model đều chạy cục bộ hoặc rằng OMH đã tự cấp quyền truy cập model. Việc model nào dùng được phụ thuộc cấu hình Hermes và các provider của bạn.

```note
OMH có thể điều phối nhiều model và hiển thị token, chi phí trên HUD hoặc báo cáo. Hãy kiểm tra chuỗi model và quyền tool trước khi chạy việc lớn. Không đưa API key vào prompt hoặc tệp mã nguồn.
```

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

```steps
- Chọn cách cài | Dùng script cho macOS/Linux, PowerShell cho Windows hoặc trình quản lý gói
- Cài oh-my-hermes | Chạy đúng lệnh của hệ điều hành và cách cài đã chọn
- Thiết lập Hermes | Chạy omh setup để đăng ký và cấu hình OMH
- Kiểm tra hệ thống | Chạy omh doctor để tìm lỗi cấu hình
- Chọn model | Mở omh model và đặt model cho từng nhóm công việc
```

### Cài trên macOS hoặc Linux

README cung cấp script cài đặt chính thức cho macOS/Linux. Mở Terminal, dán lệnh sau rồi nhấn Enter:

```bash
curl -fsSL https://omher.app/install | sh
```

Lệnh này tải script cài đặt từ địa chỉ của dự án và chạy bằng shell. Sau khi cài xong, chạy thiết lập:

```bash
omh setup
```

`omh setup` thực hiện phần đăng ký và cấu hình OMH với Hermes. Nếu terminal báo không tìm thấy `omh`, hãy mở lại terminal để nạp lại `PATH`, sau đó thử lại. README không cung cấp màn hình tương tác cụ thể của trình thiết lập, nên hãy đọc từng câu hỏi và không chọn mặc định nếu bạn chưa biết model hoặc provider nào sẽ được dùng.

### Cài trên Windows

Mở PowerShell 5.1 trở lên. Bạn có thể mở Start, tìm PowerShell, rồi dán lệnh sau:

```powershell
irm https://omher.app/install.ps1 | iex
```

Lệnh `irm` lấy nội dung trình cài đặt PowerShell. Toán tử `| iex` chuyển nội dung đó cho PowerShell thực thi. Sau khi trình cài đặt hoàn tất, chạy:

```powershell
omh setup
```

Nếu `omh` chưa được nhận diện, đóng rồi mở lại PowerShell để cập nhật `PATH`. Không dán API key hoặc thông tin bí mật vào cửa sổ chat khi trình thiết lập không yêu cầu. Nếu bạn muốn xem thêm lựa chọn cài đặt, README dẫn tới mục Windows và các tùy chọn khác của dự án.

### Cài bằng Homebrew

Nếu máy đã có Homebrew, chạy:

```bash
brew install rlaope/tap/omh
```

Sau đó vẫn phải thiết lập OMH:

```bash
omh setup
```

README cho biết Homebrew tự mang theo Python của nó. Khi muốn cập nhật qua Homebrew, dùng:

```bash
brew upgrade rlaope/tap/omh
```

Chỉ dùng lệnh cập nhật trực tiếp của Homebrew khi `omh update` báo trình quản lý sở hữu gói không khả dụng.

### Cài bằng Bun hoặc npm

Với Bun, chạy:

```bash
bun install -g oh-my-hermes
```

Với npm, chạy:

```bash
npm install -g oh-my-hermes
```

README yêu cầu Node 18+ và Python 3.11+ có trong `PATH` khi dùng Bun hoặc npm. Sau một trong hai lệnh trên, chạy:

```bash
omh setup
```

Nếu cài bằng npm nhưng PowerShell không tìm thấy `omh`, nguyên nhân thường là thư mục gói global chưa có trong `PATH`. Hãy kiểm tra cấu hình Node/npm của máy trước khi cài lại. Tư liệu được cung cấp không nêu lệnh sửa `PATH` cụ thể, nên không nên tự thêm một đường dẫn chưa xác định.

### Cài đường dẫn skill của Hermes

Nếu bạn muốn nạp OMH qua hệ thống skill của Hermes, chạy đúng hai lệnh sau:

```bash
hermes skills tap add rlaope/oh-my-hermes
hermes skills install rlaope/oh-my-hermes/skills/omh-routing --yes
```

Lệnh đầu thêm tap của repo vào Hermes. Lệnh thứ hai cài skill định tuyến `omh-routing` và tự xác nhận bằng `--yes`. README vẫn hướng dẫn chạy `omh setup` sau các cách cài bằng trình quản lý gói; với đường dẫn skill, hãy xem phần Installation trong repo nếu cấu hình của bạn cần thêm bước.

### Cập nhật hoặc gỡ cài đặt

Để cập nhật OMH theo trình cài đặt đã sở hữu nó, chạy:

```bash
omh update
```

Lệnh này nâng cấp CLI, làm mới skill được quản lý, plugin bundle và đăng ký Hermes. Để kiểm tra hoặc xử lý sự cố:

```bash
omh doctor
```

Nếu cần gỡ toàn bộ trạng thái OMH, README yêu cầu chạy trước:

```bash
omh uninstall --all
```

Sau đó mới dùng lệnh xóa của trình quản lý gói. Nếu chỉ xóa gói lệnh, trạng thái OMH vẫn được giữ lại. Với Homebrew:

```bash
brew uninstall omh
```

Với Bun:

```bash
bun remove -g oh-my-hermes
```

Với npm:

```bash
npm uninstall -g oh-my-hermes
```

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

Bước kiểm tra chính thức là chạy:

```bash
omh doctor
```

Kết quả mong đợi là lệnh có thể kiểm tra và báo trạng thái cấu hình thay vì báo `command not found` hoặc lỗi thiếu môi trường. Nếu muốn kiểm tra giao diện, chạy lệnh trần:

```bash
omh
```

OMH sẽ mở TUI riêng trên gateway của Hermes. Bạn có thể thử mở trình chọn model:

```bash
omh model
```

README mô tả trình chọn này có điều hướng bằng phím mũi tên: chọn nhóm công việc, dùng trái/phải để chọn model đầu, và `-/+` để chỉnh mức suy luận. Khi đã cấu hình xong, nhập một workflow như `/dag-ulw` trong Hermes. Màn hình cần hiển thị đồ thị hoặc cây làn chạy, cùng model, effort và token của từng làn.

Một dấu hiệu quan trọng khác là trạng thái phải phản ánh đúng bằng chứng. `Plan · not run` chỉ có nghĩa kế hoạch đã sẵn sàng, chưa có gì chạy. `Code · reported done` chỉ là agent tự báo đã xong. Chỉ `Test · verified` mới cho biết test, review hoặc CI gate đã thật sự vượt qua.

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

### Chủ shop cần làm trang bán hàng nhỏ

Chủ shop có thể dùng một repo hiện có và yêu cầu Hermes lập kế hoạch thay đổi giao diện. Bắt đầu bằng workflow hỏi rõ yêu cầu nếu ý tưởng còn mơ hồ:

```text
❯ ulw-interview: Tôi muốn thêm trang giới thiệu sản phẩm và form nhận thông tin khách hàng vào website bán hàng này
```

Sau khi yêu cầu rõ hơn, dùng:

```text
❯ ulw-plan: phân tích dự án này, so sánh các phương án thêm trang sản phẩm và lập kế hoạch có tiêu chí hoàn tất
```

Khi đã chấp nhận kế hoạch, chạy:

```text
❯ ulw-work: run the accepted plan
```

Kết quả mong đợi là công việc được chia thành các làn phù hợp, chẳng hạn giao diện, xử lý form và kiểm thử. Các làn không cùng sửa một phạm vi tệp. Bạn vẫn cần xem trạng thái kiểm thử trước khi đưa trang lên dùng thật.

### Nhân viên văn phòng cần nghiên cứu một vấn đề kỹ thuật

Với một câu hỏi chưa rõ, dùng workflow nghiên cứu:

```text
❯ ulw-research: tìm trong mã nguồn và các nguồn trực tiếp để xác định vì sao quy trình xuất báo cáo bị chậm, giữ lại nguồn và kiểm tra các điểm còn nghi ngờ
```

Workflow này được mô tả là có thể đào qua mã nguồn và web, giữ nguồn, đồng thời xác minh điều chưa chắc chắn. Nó phù hợp khi bạn cần một bản phân tích có căn cứ thay vì câu trả lời đoán. Không nên xem phần kết luận là đúng chỉ vì agent đã trả lời; hãy kiểm tra nguồn và các bằng chứng mà workflow đưa ra.

### Lập trình viên cần sửa lỗi và đảm bảo test vượt qua

Nếu đã biết lỗi nhưng muốn quy trình sửa có kiểm soát, dùng:

```text
❯ ulw-plan: phân tích lỗi đăng nhập này, nêu rủi ro, phạm vi tệp và tiêu chí hoàn tất
```

Sau khi duyệt kế hoạch:

```text
❯ ulw-work: run the accepted plan
```

Cuối cùng yêu cầu vòng lặp tiếp tục cho tới khi cổng kiểm tra cụ thể vượt qua:

```text
❯ ulw-loop: keep going until npm test passes
```

Kết quả cần xem là bằng chứng test thật sự chạy và vượt qua. Nếu agent chỉ báo đã sửa xong nhưng chưa có `Test · verified`, việc vẫn chưa được xác minh.

### Nhóm dev muốn giao một việc lớn cho nhiều agent

Khi một mục tiêu có nhiều phần độc lập, dùng:

```text
❯ /dag-ulw
```

Sau đó nhập yêu cầu cụ thể, ví dụ:

```text
Tách module thanh toán thành các phần nhỏ, bổ sung kiểm thử cho các luồng thành công và thất bại, rà soát bảo mật, rồi xác minh toàn bộ mục tiêu trước khi báo cáo.
```

OMH sẽ dựng đồ thị các nút, chạy những nút sẵn sàng song song và hiển thị cây làn đang hoạt động. Mỗi node dùng nhóm model và effort của nó. Node xác minh riêng sẽ kiểm tra mục tiêu; node thất bại có thể được sửa trước báo cáo.

> Điều quan trọng không phải agent nói đã xong, mà là hệ thống có bằng chứng cho thấy việc đã được kiểm tra.
>
> — Ông T

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

### Terminal báo không tìm thấy `omh`

Thường là trình cài đặt đã chạy nhưng terminal hiện tại chưa nhận `PATH` mới. Hãy đóng và mở lại Terminal hoặc PowerShell, rồi chạy `omh doctor`. Nếu vẫn lỗi, kiểm tra lại cách cài đã chọn; README không cung cấp một lệnh sửa `PATH` chung cho mọi hệ điều hành.

### `omh setup` không hoàn tất vì Hermes chưa sẵn sàng

OMH là lớp chạy trên Hermes Agent, nên cấu hình Hermes hoặc gateway cần có trước. Kiểm tra phần cài đặt Hermes trong môi trường của bạn, sau đó chạy lại `omh setup`. Tư liệu được cung cấp không nêu một lệnh cài Hermes cụ thể, vì vậy không nên tự dùng tên gói chưa được README xác nhận.

### Bun hoặc npm báo thiếu runtime

README yêu cầu Node 18+ và Python 3.11+ có trong `PATH` cho Bun và npm. Hãy kiểm tra hai runtime này trong môi trường hệ điều hành rồi chạy lại lệnh cài. Không đổi sang một phiên bản Python thấp hơn yêu cầu `pyproject.toml`.

### Agent báo xong nhưng kết quả chưa được kiểm tra

Đây không hẳn là lỗi cài đặt. `Code · reported done` chỉ là báo cáo của executor. Hãy yêu cầu chạy test, review hoặc CI gate; chỉ coi việc hoàn tất khi trạng thái chuyển thành `Test · verified` hoặc có bằng chứng tương đương.

### Chi phí hoặc model không như mong đợi

Mở `omh model` để xem model đang chạy cho từng nhóm công việc và chỉnh lại chain nếu cần. HUD và bản tóm tắt có thể hiển thị token cùng con số chi phí; một lần chạy không định giá được sẽ hiện `unknown`, không phải `$0`. Hãy kiểm tra provider và chain trước khi chạy một đồ thị lớn.

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

Nên dùng nếu bạn đã dùng hoặc muốn dùng Hermes Agent cho các công việc nhiều bước, cần chia việc song song, muốn có skill chuyên môn và coi trọng kiểm chứng. Repo có nhiều lớp hữu ích: định tuyến model theo nhóm công việc, TUI riêng, bộ nhớ có lý do, skill tự nạp, LSP tùy chọn và cơ chế tách trạng thái kế hoạch với bằng chứng thực thi. Giấy phép của repo là MIT, và hiện có khoảng 5.575 sao cùng 454 fork.

Giới hạn là OMH không phải một agent độc lập thay thế Hermes. Bạn vẫn cần Hermes Agent, gateway, model provider và cấu hình môi trường phù hợp. README không nói rõ chi phí từng provider, yêu cầu GPU, tài khoản bắt buộc hay chính sách lưu dữ liệu của các dịch vụ model. Những điểm đó cần được kiểm tra riêng trước khi đưa vào quy trình có dữ liệu nhạy cảm.

Nếu bạn chỉ cần hỏi đáp đơn giản, chạy một script nhỏ hoặc thực hiện một lệnh duy nhất, OMH có thể nhiều lớp hơn mức cần thiết. Nếu bạn cần nhiều agent phối hợp, muốn biết model nào đang chạy, muốn giới hạn phạm vi ghi và cần cổng xác minh trước khi kết luận, đây là một lựa chọn đáng thử. Hãy bắt đầu bằng `omh doctor`, cấu hình một chain nhỏ, rồi mở rộng sang `/dag-ulw` sau khi đã hiểu rõ quyền tool và chi phí.

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

### oh-my-hermes có miễn phí không?

Repo dùng giấy phép MIT. README không nêu bảng giá của các model hoặc provider, nên việc sử dụng thực tế có thể vẫn phát sinh chi phí từ dịch vụ model bạn cấu hình.

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

Tư liệu được cung cấp không nêu yêu cầu GPU. OMH là lớp trên Hermes Agent và dùng các model theo chain đã cấu hình, nên chưa thể kết luận rằng GPU là bắt buộc hoặc không cần.

### oh-my-hermes chạy được trên Windows không?

Có. README cung cấp trình cài đặt PowerShell cho Windows và yêu cầu PowerShell 5.1 trở lên. Nếu cài bằng Bun hoặc npm, bạn còn cần Node 18+ và Python 3.11+ trong PATH.

### Có cần cài Hermes Agent trước không?

Có. README mô tả oh-my-hermes là lớp điều hành cho Hermes Agent và chạy trên gateway của Hermes. Tuy nhiên, tư liệu được cung cấp không có lệnh cài Hermes cụ thể.

### oh-my-hermes có tự sửa hoặc thay thế Hermes không?

Không. README nói rõ OMH không vá hay thay thế Hermes. Nó bổ sung lớp điều phối, định tuyến model, kỹ năng, giao diện và quy tắc bằng chứng ở bên trên Hermes.

### Dữ liệu và bộ nhớ của Hermes có bị OMH đọc không?

README nói bộ nhớ riêng của Hermes không bị OMH đọc hoặc vá. Tư liệu không mô tả đầy đủ chính sách dữ liệu của các model provider, vì vậy bạn vẫn cần kiểm tra provider trước khi gửi dữ liệu nhạy cảm.

### Làm sao biết agent thật sự đã hoàn thành việc?

Không nên chỉ dựa vào trạng thái agent tự báo. `Code · reported done` chỉ là executor nói đã xong; `Test · verified` mới cho biết test, review hoặc CI gate đã thực sự vượt qua.
