# oh-my-hermes: chạy AI agent song song hiệu quả — hướng dẫn cài đặt và dùng

> oh-my-hermes là lớp điều phối không chính thức cho Hermes Agent, bổ sung workflow song song, định tuyến model, skill chuyên môn và kiểm chứng kết quả. Cài khá đơn giản bằng một lệnh trên macOS/Linux hoặc PowerShell trên Windows, nhưng bạn vẫn cần cấu hình Hermes và model phù hợp.

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

oh-my-hermes là lớp điều phối giúp Hermes Agent chạy nhiều tác vụ AI song song, mỗi tác vụ có model, skill và phạm vi chỉnh sửa riêng. Repo này không thay thế hay sửa Hermes Agent; nó đứng bên trên để quyết định việc gì cần làm, giao cho lane nào và kết quả đã được kiểm chứng đến đâu.

Công cụ phù hợp với lập trình viên, nhóm kỹ thuật, người làm sản phẩm và người muốn giao một việc lớn cho nhiều AI coworker. Điểm đáng giá nhất là OMH phân biệt rõ “đã lập kế hoạch”, “agent báo đã xong” và “đã được kiểm chứng”. Bạn cũng có thể xem video ngắn bên dưới để hình dung cách workflow vận hành.

Hiện repo có khoảng 5.575 sao và 454 fork, dùng Python, giấy phép MIT. Repo vẫn còn được cập nhật và có sẵn cả giao diện TUI, bộ skill chuyên môn, định tuyến nhiều model, bộ nhớ dài hạn cùng các workflow như `ulw-plan`, `ulw-work`, `ulw-loop` và `dag-ulw`.

```repo
- repo | rlaope/oh-my-hermes
- kind | Agent
- desc | Lớp điều phối cho Hermes Agent, giúp chạy nhiều lane AI song song với model, skill và kiểm chứng riêng.
- 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ì

- **Chạy nhiều lane AI song song:** Một mục tiêu lớn được tách thành các node nhỏ. Những node đủ điều kiện có thể chạy cùng lúc, mỗi node dùng phạm vi ghi riêng để giảm nguy cơ nhiều agent sửa cùng một file.

- **Chọn model theo loại công việc:** Các lane được gắn nhóm như `ultrabrain`, `deep`, `visual-engineering` hoặc `quick`. Mỗi nhóm có chuỗi model và mức suy luận riêng. Khi một nhà cung cấp từ chối model, chuỗi có thể chuyển sang model kế tiếp thay vì âm thầm hạ cấp.

- **Điều phối skill chuyên môn:** OMH có hơn một trăm specialist dạng `omh-*`, chẳng hạn frontend, backend, Rust, security review và verification. Bạn chỉ mô tả việc cần làm; bộ định tuyến chọn skill phù hợp để đưa vào workflow.

- **Workflow từ làm rõ đến kiểm thử:** Bạn có thể bắt đầu bằng `ulw-interview` khi yêu cầu còn mơ hồ, dùng `ulw-plan` để lập kế hoạch, `ulw-work` để triển khai và `ulw-loop` để lặp lại cho đến khi một điều kiện hoàn thành được thỏa mãn.

- **DAG-ULW cho dự án lớn:** Lệnh `/dag-ulw` biến mục tiêu thành đồ thị các node nhỏ. Những node sẵn sàng sẽ chạy song song, một node riêng kiểm tra mục tiêu và các node lỗi có thể được sửa trước khi tạo báo cáo cuối.

- **Hiển thị trực tiếp trong TUI:** Chạy `omh` để mở giao diện dòng lệnh riêng của OMH trên gateway của Hermes. Bạn có thể thấy model, effort, token, cây lane, trạng thái công việc và chi phí trong một màn hình.

- **Hỗ trợ LSP:** Khi bật `lsp_tools` trong phần cài đặt plugin OMH, công cụ có thể dùng language server để tìm định nghĩa, tham chiếu và đổi tên theo ngữ nghĩa. Cách này hữu ích với alias, re-export và tên bị che khuất mà tìm kiếm văn bản dễ bỏ sót.

- **Bộ nhớ dài hạn có lý do rõ ràng:** OMH không âm thầm ghi nhớ mọi thứ. Mỗi thông tin được giữ lại, từ chối hoặc trì hoãn đều kèm lý do bằng văn bản. Phiên sau nhận được recall pack được xếp hạng theo tác vụ và giới hạn theo ngân sách token.

- **Theo dõi bằng chứng trước khi báo xong:** `Plan · not run` nghĩa là mới có kế hoạch. `Code · reported done` chỉ có nghĩa executor tự báo đã hoàn thành. Chỉ trạng thái như `Test · verified` mới cho biết test, review hoặc CI gate thực sự đã vượt qua.

- **Bảo vệ quyền sở hữu mã:** OMH tách quyết định chọn model khỏi quyết định ai được sửa mã. Các lane song song có phạm vi file riêng, giúp quy trình dễ kiểm soát hơn khi nhiều agent cùng tham gia.

- **Đo token và chi phí:** HUD và phần tổng kết hiển thị số token cùng chi phí theo bảng giá có nguồn. Nếu không thể tính giá, hệ thống hiển thị `unknown` thay vì giả vờ là không tốn tiền.

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

Bạn cần một máy chạy macOS, Linux hoặc Windows. README có hướng dẫn cài riêng cho macOS/Linux và Windows PowerShell 5.1 trở lên.

Gói Python yêu cầu Python từ phiên bản 3.11 trở lên. Nếu cài bằng Bun hoặc npm, README yêu cầu thêm Node 18 trở lên và Python 3.11 trở lên phải có trên `PATH`. Homebrew tự mang theo Python của nó.

OMH là lớp trên Hermes Agent, nên bạn cần có Hermes Agent và gateway phù hợp để sử dụng đầy đủ các workflow. Tư liệu được cung cấp không ghi rõ một quy trình cài Hermes Agent riêng trong phần README này.

README không nêu cụ thể tài khoản AI, API key, mức RAM, GPU hay model provider bắt buộc. Vì vậy, bạn không nên tự đoán rằng mọi model đều miễn phí hoặc mọi máy đều chạy được như nhau. Việc model nào hoạt động còn phụ thuộc cấu hình Hermes, provider và model chain của bạn.

Nếu cài trên Windows, nên mở PowerShell phiên bản 5.1 trở lên. Nếu dùng npm hoặc Bun, hãy kiểm tra Node và Python đã có trên `PATH` trước khi chạy trình cài.

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

```steps
- Chọn hệ điều hành | Dùng installer cho macOS/Linux hoặc Windows PowerShell
- Cài oh-my-hermes | Chạy lệnh cài đặt chính thức của README
- Thiết lập OMH | Chạy `omh setup` để kết nối và cấu hình
- Chọn model | Mở `omh model` để xem hoặc điều chỉnh model chain
- Kiểm tra hệ thống | Chạy `omh doctor` để tìm lỗi cấu hình
```

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

README cung cấp một installer chạy qua shell:

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

Lệnh `curl` tải nội dung installer từ địa chỉ của dự án. Tùy chọn `-f` làm lệnh báo lỗi khi máy chủ trả về lỗi HTTP, `-sS` giảm thông tin thừa nhưng vẫn hiện lỗi, còn `-L` cho phép theo chuyển hướng. Phần `| sh` đưa nội dung nhận được cho shell thực thi.

Sau khi installer hoàn tất, chạy bước thiết lập:

```bash
omh setup
```

Bạn nên mở Terminal rồi chạy từng lệnh một. Nếu lệnh `omh` không được tìm thấy, hãy kiểm tra installer đã hoàn tất và thư mục chứa CLI đã nằm trên `PATH`. README không cung cấp thêm thông báo lỗi cụ thể cho trường hợp này.

### Cài trên Windows

Mở PowerShell 5.1 trở lên rồi chạy:

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

`irm` là bí danh PowerShell để tải nội dung từ địa chỉ installer. `iex` thực thi nội dung vừa tải. Sau đó chạy thiết lập OMH:

```powershell
omh setup
```

Nếu PowerShell chặn script hoặc không nhận lệnh `omh`, hãy kiểm tra phiên bản PowerShell và `PATH`. README chỉ nêu installer dành cho PowerShell 5.1+, không nêu cách thay đổi chính sách bảo mật hoặc cách sửa từng thông báo lỗi, nên bạn không nên tự hạ mức bảo vệ nếu chưa hiểu tác động.

### Cài bằng Homebrew

Nếu bạn đã dùng Homebrew, README có phương án sau:

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

Sau đó vẫn phải chạy:

```bash
omh setup
```

Theo README, Homebrew mang theo Python riêng. Điều này giúp bạn không phải chuẩn bị Python theo cùng cách như khi dùng npm hoặc Bun, nhưng bạn vẫn cần hoàn thành bước thiết lập Hermes và OMH.

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

README cho phép cài CLI toàn cục bằng Bun:

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

Hoặc bằng npm:

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

Bun và npm cần Node 18+ cùng Python 3.11+ trên `PATH`. Sau khi cài xong, chạy:

```bash
omh setup
```

Tham số `-g` cài gói ở phạm vi toàn cục để lệnh `omh` có thể được gọi từ nhiều thư mục. Nếu terminal vẫn không nhận lệnh, hãy mở cửa sổ terminal mới để nạp lại `PATH`.

### Thêm skill vào Hermes theo cách thủ công

README có một đường dẫn skill tap cho Hermes:

```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 nguồn skill của dự án. Lệnh thứ hai cài skill `omh-routing` và dùng `--yes` để xác nhận tự động. Chỉ dùng cách này nếu bạn đã có lệnh `hermes` hoạt động và hiểu rằng đây là đường dẫn skill thủ công, không phải thay thế cho toàn bộ quy trình `omh setup`.

### Chọn model và cập nhật cấu hình

Sau khi cài, mở bộ chọn model:

```bash
omh model
```

README mô tả bộ chọn này cho phép chọn category bằng phím mũi tên, chuyển model đầu bằng phím trái/phải và điều chỉnh effort bằng phím `-` hoặc `+`. Bạn cũng có thể mở bộ chọn tương tự bên trong TUI OMH bằng `/omh-model`.

Khi muốn thiết lập một họ model mới trong Hermes, dùng skill sau trong Hermes:

```text
/omh-model-setup
```

Để cập nhật CLI, skill được quản lý, plugin bundle và đăng ký Hermes, chạy:

```bash
omh update
```

Lệnh này tự phát hiện trình quản lý đã cài CLI rồi nâng cấp thông qua trình quản lý đó. Nếu `omh update` báo trình quản lý sở hữu CLI không khả dụng, README mới khuyến nghị chạy lệnh quản lý trực tiếp.

### Gỡ cài đặt khi cần

Để xóa toàn bộ trạng thái OMH trước, chạy:

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

Sau đó, nếu cài bằng Homebrew:

```bash
brew uninstall omh
```

Nếu cài bằng Bun:

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

Nếu cài bằng npm:

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

README lưu ý việc xóa gói CLI không xóa trạng thái OMH. Muốn gỡ đầy đủ, hãy chạy `omh uninstall --all` trước lệnh remove của trình quản lý.

```note
OMH có thể gọi nhiều model và hiển thị chi phí token. Hãy kiểm tra provider, model chain và quyền truy cập trước khi giao việc lớn. Không đặt API key trực tiếp vào prompt hoặc chia sẻ log có chứa thông tin bí mật.
```

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

Kiểm tra cơ bản bằng lệnh chẩn đoán:

```bash
omh doctor
```

Kết quả mong đợi là OMH thực hiện các kiểm tra và cho bạn biết vấn đề cấu hình nếu có. README không đưa ra một màn hình kết quả cụ thể, nên không nên dựa vào một dòng chữ cố định.

Bạn cũng có thể chạy:

```bash
omh
```

Theo README, lệnh `omh` mở TUI riêng của OMH trên gateway của Hermes. Trong TUI, bạn có thể đổi theme bằng `/theme`, xem danh sách agent, chạy một dòng shell bắt đầu bằng `!`, hoặc tua lại bằng `Esc Esc`.

Để kiểm tra model chain, chạy:

```bash
omh model
```

Nếu bộ chọn mở được, bạn có thể xem model đang gắn với từng category. Khi chạy workflow, hãy phân biệt các trạng thái: `Plan · not run` chưa phải là chạy thành công; `Code · reported done` mới chỉ là lời báo của executor; `Test · verified` mới là kết quả đã có test, review hoặc CI gate vượt qua.

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

### Chủ shop muốn làm landing page nhanh hơn

Chủ shop có thể dùng Hermes để mô tả một trang giới thiệu sản phẩm, sau đó dùng workflow lập kế hoạch và triển khai. Bắt đầu bằng câu lệnh trong Hermes:

```text
ulw-interview: Tôi muốn làm landing page cho cửa hàng bán đồ gia dụng, hãy hỏi từng câu để xác định rõ nội dung, khách hàng và tiêu chí hoàn thành
```

Khi yêu cầu đã rõ, dùng:

```text
ulw-plan: lập kế hoạch xây landing page, nêu lựa chọn, rủi ro và tiêu chí hoàn thành
```

Sau khi duyệt kế hoạch:

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

OMH sẽ chia công việc thành các lane phù hợp, chẳng hạn phần giao diện, nội dung hoặc kiểm tra. Kết quả hữu ích nhất không chỉ là mã nguồn được tạo ra, mà còn là dấu hiệu cho biết phần nào đã chạy, phần nào chỉ được báo hoàn thành và phần nào đã được kiểm chứng.

### Nhân viên văn phòng cần nghiên cứu một yêu cầu phức tạp

Khi một yêu cầu còn thiếu thông tin, dùng:

```text
ulw-interview: Tôi cần xây một quy trình báo cáo doanh số hàng tuần, hãy hỏi từng câu một cho đến khi xác định rõ đầu vào, người nhận và điều kiện hoàn thành
```

Sau đó có thể yêu cầu nghiên cứu:

```text
ulw-research: nghiên cứu mã nguồn và thông tin web liên quan, giữ nguồn và kiểm tra những điểm còn nghi ngờ
```

Workflow này phù hợp khi bạn chưa muốn AI lập tức viết kết luận. Theo README, `ulw-research` đào qua code và web, giữ nguồn, đồng thời xác minh điểm đáng ngờ. Bạn vẫn cần tự xem lại thông tin trước khi dùng trong quyết định kinh doanh.

### Dev mới muốn sửa một dự án có nhiều phần phụ thuộc

Dev có thể dùng:

```text
ulw-plan: analyze this project's circular dependencies and plan the refactor
```

Khi kế hoạch được chấp nhận:

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

OMH phân công các lane song song với phạm vi file không chồng lên nhau. Nếu bật `lsp_tools` trong phần cài đặt plugin, LSP có thể hỗ trợ tìm định nghĩa, tham chiếu và đổi tên theo ngữ nghĩa thay vì chỉ tìm chuỗi.

### Nhóm kỹ thuật muốn lặp lại cho đến khi test vượt qua

Sau khi có thay đổi, dùng:

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

Workflow này tiếp tục chu kỳ lập kế hoạch, xây dựng và review cho đến khi điều kiện bạn nêu đạt được. Nếu mục tiêu lớn hơn, hãy dùng:

```text
/dag-ulw
```

Sau đó mô tả mục tiêu bằng ngôn ngữ tự nhiên. OMH tạo đồ thị node, chạy các node sẵn sàng song song và dùng một node riêng để kiểm tra mục tiêu trước khi báo cáo.

> Điều quan trọng không phải agent nói “đã xong”, mà là bạn nhìn thấy bằng chứng cho phần đã thực sự được kiểm tra.
>
> — Ông T

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

### Terminal không nhận lệnh `omh`

Nguyên nhân thường là installer chưa hoàn tất hoặc thư mục cài CLI chưa có trong `PATH`. Hãy kiểm tra lại lệnh cài theo đúng hệ điều hành, đóng rồi mở terminal mới và chạy lại `omh doctor`. README không nêu một lệnh sửa `PATH` riêng, nên không nên tự thêm đường dẫn đoán mò.

### Python hoặc Node không đúng phiên bản

Nếu cài bằng npm hoặc Bun, máy cần Node 18+ và Python 3.11+ trên `PATH`. Gói Python của repo yêu cầu Python >=3.11. Hãy kiểm tra các phiên bản đang có trước khi thử cài lại; README không cung cấp lệnh kiểm tra phiên bản cụ thể.

### `omh setup` chưa kết nối được Hermes

OMH là lớp trên Hermes Agent và cần gateway Hermes để hoạt động. Hãy xác nhận Hermes đã được cài và có thể chạy trước khi cấu hình OMH. Nếu vẫn lỗi, chạy `omh doctor` để lấy thông tin chẩn đoán; tư liệu được cung cấp không ghi chi tiết từng thông báo lỗi.

### Model bị provider từ chối

README cho biết model chain có thể chuyển sang model kế tiếp khi provider từ chối một model. Bạn có thể chạy `omh model` để xem category đang dùng model nào và điều chỉnh chain. Việc thay đổi model có thể ảnh hưởng chất lượng, tốc độ và chi phí, nên hãy thử với tác vụ nhỏ trước.

### Tưởng agent đã làm xong vì thấy trạng thái hoàn thành

`Code · reported done` chỉ là executor tự báo. Hãy chờ trạng thái kiểm chứng như `Test · verified`, hoặc tự chạy test, review hay CI gate phù hợp. Đây là lỗi quy trình thường gặp khi giao việc song song cho nhiều agent.

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

Bạn nên dùng oh-my-hermes nếu đã hoặc muốn dùng Hermes Agent và cần điều phối nhiều agent cho một công việc lớn. Repo có nhiều điểm mạnh: workflow rõ ràng, định tuyến model theo loại việc, hơn một trăm skill chuyên môn, TUI theo dõi trực tiếp, bộ nhớ có kiểm soát và cách báo trạng thái dựa trên bằng chứng.

Giấy phép MIT cũng thuận lợi cho việc nghiên cứu và sử dụng trong dự án. Repo hiện có khoảng 5.575 sao, 454 fork và vẫn được cập nhật, cho thấy công cụ đang được phát triển tích cực.

Giới hạn là OMH không phải một agent độc lập hoàn toàn. Nó phụ thuộc vào Hermes Agent, gateway, model provider và cấu hình truy cập của bạn. README cũng không nêu rõ chi phí model, phần cứng tối thiểu, danh sách API key bắt buộc hay kết quả chẩn đoán cho từng lỗi. Vì vậy, bạn cần tự kiểm tra provider và ngân sách trước khi chạy nhiều lane.

Nếu bạn chỉ cần một chatbot trả lời câu hỏi đơn giản, một script Python nhỏ hoặc một CLI đơn nhiệm, OMH có thể là quá nhiều. Nếu bạn cần phân rã dự án, chạy công việc song song, quản lý skill và yêu cầu bằng chứng trước khi kết luận, đây là một lựa chọn đáng thử.

## 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. Tuy nhiên README không xác nhận chi phí của Hermes, model provider hoặc gateway, nên việc dùng thực tế có thể vẫn phát sinh phí token.

### Có cần GPU không?

README không nêu yêu cầu GPU hoặc phần cứng tối thiểu. Tư liệu chỉ nêu yêu cầu hệ điều hành, Python và Node trong một số cách cài.

### Chạy trên Windows được không?

Có. README cung cấp installer cho Windows bằng PowerShell 5.1 trở lên: `irm https://omher.app/install.ps1 | iex`, sau đó chạy `omh setup`.

### Có cần Python phiên bản nào?

Gói Python yêu cầu Python >=3.11. Nếu cài bằng Bun hoặc npm, README cũng yêu cầu Python 3.11+ và Node 18+ có trên `PATH`.

### oh-my-hermes có thay thế Hermes Agent không?

Không. README nói rõ OMH là operating layer trên Hermes Agent, không patch hoặc thay thế Hermes. Bạn vẫn cần Hermes và gateway phù hợp để dùng đầy đủ.

### Dữ liệu và bộ nhớ có an toàn không?

README cho biết OMH không âm thầm ghi nhớ; mỗi thông tin được giữ, từ chối hoặc trì hoãn đều có lý do. Tư liệu không đưa ra cam kết bảo mật đầy đủ cho API key, dữ liệu gửi tới provider hoặc mọi loại log.

### Khác gì so với chỉ dùng một AI coding agent?

OMH thêm định tuyến model theo category, nhiều lane chạy song song, skill chuyên môn, workflow DAG và các trạng thái dựa trên bằng chứng. Nếu bạn chỉ cần một tác vụ nhỏ trong một agent, các tính năng này có thể không cần thiết.
