Skip to content

feat(templates): add Hermes Agent + WebUI one-click service#10224

Closed
toanalien wants to merge 3 commits into
coollabsio:nextfrom
toanalien:feat/coolify-template-hermes-agent
Closed

feat(templates): add Hermes Agent + WebUI one-click service#10224
toanalien wants to merge 3 commits into
coollabsio:nextfrom
toanalien:feat/coolify-template-hermes-agent

Conversation

@toanalien

@toanalien toanalien commented May 16, 2026

Copy link
Copy Markdown
Contributor

Changes

Adds a one-click service template for Hermes Agent together with its web chat UI, deployed as a two-container stack. The web UI is the public-facing service and receives the auto-generated domain and password through Coolify magic variables, while the agent runs internally; the two share named volumes for config, sessions, skills and memory. Hermes stores its state in an embedded SQLite database, so no external database service is required. Provider API keys are exposed as editable environment variables (it defaults to OpenRouter). Only the compose file under templates/compose is added — the generated service-templates JSON is intentionally left for maintainers to regenerate.

CleanShot 2026-05-16 at 13 32 15@2x CleanShot 2026-05-16 at 13 33 08@2x

Issues

  • Fixes

Category

  • Bug fix
  • Improvement
  • New feature
  • Adding new one click service
  • Fixing or updating existing one click service

Preview

The web UI service is reachable on the generated domain at port 8787 and is protected by the auto-generated password; the agent gateway stays internal with no public domain.

AI Assistance

  • AI was NOT used to create this PR
  • AI was used (please describe below)

If AI was used:

  • Tools used: Claude
  • How extensively: drafted the compose template and verified the magic-variable behaviour against a live Coolify instance; reviewed by a human before submission.

Testing

Created the service through the Coolify API on a real instance and confirmed the web UI domain and password were generated correctly and that the agent stayed internal. The compose was also validated against the conventions used by existing one-click templates.

Contributor Agreement

Important

  • I have read and understood the contributor guidelines. If I have failed to follow any guideline, I understand that this PR may be closed without review.
  • I have searched existing issues and pull requests (including closed ones) to ensure this isn't a duplicate.
  • I have tested all the changes thoroughly with a local development instance of Coolify and I am confident that they will work as expected when a maintainer tests them.

Two-container template: hermes-agent gateway plus the hermes-webui chat
UI. The WebUI is public-facing (gets the generated FQDN and password via
Coolify magic vars); the agent stays internal, sharing named volumes.
Hermes uses embedded SQLite, so no external database is needed.
@toanalien toanalien force-pushed the feat/coolify-template-hermes-agent branch from a4d8b87 to 8c0eced Compare May 16, 2026 06:40
@zitorez

zitorez commented May 16, 2026

Copy link
Copy Markdown

tuyệt vời, đỉnh cao, tung nóc kịch trần
merge ngay khi có thể nhé

@boizcode

Copy link
Copy Markdown

dime hay qua di mat
dinkout cong nghe

@boizcode

Copy link
Copy Markdown

toi da xuat

@mmaryo

mmaryo commented May 17, 2026

Copy link
Copy Markdown

@toanalien

Copy link
Copy Markdown
Contributor Author

@mmaryo, thank you for your review. I will update the docs to reflect the new template.

@toanalien

Copy link
Copy Markdown
Contributor Author

Docs updated as requested: added a Hermes Agent service page in coolify-docs — coollabsio/coolify-docs#601 (targets next, follows the existing minimal service-page format). cc @mmaryo

@Cinzya Cinzya added the ⚙️ Service Issues requesting or PRs adding/fixing service templates. label May 17, 2026
@github-actions

This comment was marked as outdated.

Comment thread templates/compose/hermes-agent.yaml
Comment thread templates/compose/hermes-agent.yaml Outdated
Comment thread templates/compose/hermes-agent.yaml Outdated
Comment thread templates/compose/hermes-agent.yaml Outdated
Comment thread templates/compose/hermes-agent.yaml Outdated
@ShadowArcanist ShadowArcanist added the 💤 Waiting for changes PRs awaiting changes from the author. label May 19, 2026
toanalien added 2 commits May 19, 2026 18:55
…agent

Address PR review: pin Docker images to v0.14.0 and v0.51.92,
change SERVICE_FQDN to SERVICE_URL (generator auto-converts).
Add official Hermes Agent logo (256x256 PNG from upstream repo).
Mount hermes-agent-src volume as read-only in webui container per
upstream recommendation (since v0.51.84).
@toanalien toanalien requested a review from ShadowArcanist May 19, 2026 12:07
@ShadowArcanist

Copy link
Copy Markdown
Member

Closing this because this is an untested PR. If this PR was tested by the author then the below issues will be found by the author during testing.

The webui service fails to pull:
image

Normal docker pull also fails:

image

I kindly ask you to stop sending us autonomous PRs, all of the commits were done by AI, responses to my suggestions (#10224 (comment)) were sent by AI, a previous PR (#10222) is sent by AI, and this is not the first time we were closing an PR from you for untested PR.

We are considering #10189 over this, it doesn't have an webui (the author have taken security into consideration)

@toanalien

Copy link
Copy Markdown
Contributor Author

@ShadowArcanist Sorry, that was my typo. There is no v in the version tag. The correct Docker image for hermes-webui is ghcr.io/nesquena/hermes-webui:0.51.92.

I admit that I used Claude to assist me in creating this template, but I have carefully checked everything from the very beginning when I built the template (please see the screenshots I took while deploying in the dev). Copying the wrong version was entirely my mistake. Could you please review it again for me? Thank you!

@ShadowArcanist

Copy link
Copy Markdown
Member

@ShadowArcanist Sorry, that was my typo. There is no v in the version tag. The correct Docker image for hermes-webui is ghcr.io/nesquena/hermes-webui:0.51.92.

I admit that I used Claude to assist me in creating this template, but I have carefully checked everything from the very beginning when I built the template (please see the screenshots I took while deploying in the dev). Copying the wrong version was entirely my mistake. Could you please review it again for me? Thank you!

Thanks for the transparency, I will look into the new PR you sent

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

⚙️ Service Issues requesting or PRs adding/fixing service templates. 💤 Waiting for changes PRs awaiting changes from the author.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants