oh-my-hermes: chạy AI agent song song hiệu quả — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về rlaope/oh-my-hermes — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: oh-my-hermes: điều phối nhiều AI làm song song trên Hermes Agent — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
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.
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.
rlaope/oh-my-hermes
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.
I.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-engineeringhoặcquick. 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-interviewkhi yêu cầu còn mơ hồ, dùngulw-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-ulwbiế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_toolstrong 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 runnghĩa là mới có kế hoạch.Code · reported donechỉ có nghĩa executor tự báo đã hoàn thành. Chỉ trạng thái nhưTest · verifiedmớ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ị
unknownthay vì giả vờ là không tốn tiền.
II.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.
III.Cài đặt từng bước
- Chọn hệ điều hànhDùng installer cho macOS/Linux hoặc Windows PowerShell
- Cài oh-my-hermesChạy lệnh cài đặt chính thức của README
- Thiết lập OMHChạy `omh setup` để kết nối và cấu hình
- Chọn modelMở `omh model` để xem hoặc điều chỉnh model chain
- Kiểm tra hệ thốngChạy `omh doctor` để tìm lỗi cấu hình
A.Cài trên macOS hoặc Linux
README cung cấp một installer chạy qua shell:
curl -fsSL https://omher.app/install | shLệ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:
omh setupBạ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.
B.Cài trên Windows
Mở PowerShell 5.1 trở lên rồi chạy:
irm https://omher.app/install.ps1 | iexirm 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:
omh setupNế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.Cài bằng Homebrew
Nếu bạn đã dùng Homebrew, README có phương án sau:
brew install rlaope/tap/omhSau đó vẫn phải chạy:
omh setupTheo 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.
D.Cài bằng Bun hoặc npm
README cho phép cài CLI toàn cục bằng Bun:
bun install -g oh-my-hermesHoặc bằng npm:
npm install -g oh-my-hermesBun và npm cần Node 18+ cùng Python 3.11+ trên PATH. Sau khi cài xong, chạy:
omh setupTham 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.
E.Thêm skill vào Hermes theo cách thủ công
README có một đường dẫn skill tap cho Hermes:
hermes skills tap add rlaope/oh-my-hermes
hermes skills install rlaope/oh-my-hermes/skills/omh-routing --yesLệ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.
F.Chọn model và cập nhật cấu hình
Sau khi cài, mở bộ chọn model:
omh modelREADME 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:
/omh-model-setupĐể cập nhật CLI, skill được quản lý, plugin bundle và đăng ký Hermes, chạy:
omh updateLệ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.Gỡ cài đặt khi cần
Để xóa toàn bộ trạng thái OMH trước, chạy:
omh uninstall --allSau đó, nếu cài bằng Homebrew:
brew uninstall omhNếu cài bằng Bun:
bun remove -g oh-my-hermesNếu cài bằng npm:
npm uninstall -g oh-my-hermesREADME 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ý.
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.
IV.Kiểm tra đã chạy được chưa
Kiểm tra cơ bản bằng lệnh chẩn đoán:
omh doctorKế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:
omhTheo 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:
omh modelNế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.
V.Dùng vào việc thật
A.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:
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ànhKhi yêu cầu đã rõ, dùng:
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ànhSau khi duyệt kế hoạch:
ulw-work: run the accepted planOMH 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.
B.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:
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ànhSau đó có thể yêu cầu nghiên cứu:
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.
C.Dev mới muốn sửa một dự án có nhiều phần phụ thuộc
Dev có thể dùng:
ulw-plan: analyze this project's circular dependencies and plan the refactorKhi kế hoạch được chấp nhận:
ulw-work: run the accepted planOMH 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.
D.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:
ulw-loop: keep going until npm test passesWorkflow 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:
/dag-ulwSau đó 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
VI.Lỗi hay gặp và cách xử lý
A.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ò.
B.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ể.
C.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.
D.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.
E.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.
VII.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.


