gortium/compose
1
1
Fork 0
Code Issues Pull Requests 18 Actions Packages Projects Releases Wiki Activity

feat: add Paperclip agent orchestrator to AI compose stack #32

Open
Hermes wants to merge 4 commits from feat/add-paperclip into master
pull from: feat/add-paperclip
merge into: gortium:master
Conversation 0 Commits 4 Files Changed 1 +56
Hermes commented 2026-05-18 22:17:25 +00:00
Collaborator
Copy Link

Summary

Adds Paperclip — the open-source agent orchestration dashboard — to the AI compose stack. This enables managing a team of AI agents (Hermes, Claude Code, Codex, etc.) with goal assignment, budgeting, governance, and cost tracking from a single web UI.

Changes

New services in ai/compose.yml:

  • paperclip-db — Dedicated PostgreSQL 17 database for Paperclip state
  • paperclip — Paperclip server (ghcr.io/paperclipai/paperclip:v2026.517.0) on port 3100

Configuration:

  • Traefik reverse proxy on paperclip.lazyworkhorse.net (HTTP→HTTPS redirect)
  • Authenticated deployment mode, private exposure
  • Data volumes: /mnt/HoardingCow_docker_data/Paperclip/
  • Health-check dependency chain: paperclip → paperclip-db
  • Networks: ai_net (Traefik), ai_backend (internal)

New env vars required:

  • PAPERCLIP_DB_PASSWORD — PostgreSQL password
  • PAPERCLIP_AUTH_SECRET — Better Auth secret key

Related

  • Hermes-Paperclip adapter: NousResearch/hermes-paperclip-adapter — enables running Hermes as a managed agent inside Paperclip
## Summary Adds **Paperclip** — the open-source agent orchestration dashboard — to the AI compose stack. This enables managing a team of AI agents (Hermes, Claude Code, Codex, etc.) with goal assignment, budgeting, governance, and cost tracking from a single web UI. ## Changes **New services in `ai/compose.yml`:** - **`paperclip-db`** — Dedicated PostgreSQL 17 database for Paperclip state - **`paperclip`** — Paperclip server (`ghcr.io/paperclipai/paperclip:v2026.517.0`) on port 3100 **Configuration:** - Traefik reverse proxy on `paperclip.lazyworkhorse.net` (HTTP→HTTPS redirect) - Authenticated deployment mode, private exposure - Data volumes: `/mnt/HoardingCow_docker_data/Paperclip/` - Health-check dependency chain: paperclip → paperclip-db - Networks: `ai_net` (Traefik), `ai_backend` (internal) **New env vars required:** - `PAPERCLIP_DB_PASSWORD` — PostgreSQL password - `PAPERCLIP_AUTH_SECRET` — Better Auth secret key ## Related - Hermes-Paperclip adapter: `NousResearch/hermes-paperclip-adapter` — enables running Hermes as a managed agent inside Paperclip
Hermes added 1 commit 2026-05-18 22:17:26 +00:00
feat: add Paperclip agent orchestrator to AI compose stack
Some checks failed
Build Hermes agent / build (pull_request) Has been cancelled
Details
Build ollama (gfx906) / build (pull_request) Has been cancelled
Details
563ccc5632 
Paperclip (ghcr.io/paperclipai/paperclip:v2026.517.0) is an open-source
agent management dashboard. Adds paperclip-db (PostgreSQL 17) and
paperclip services with Traefik reverse proxy on
paperclip.lazyworkhorse.net.

Requires .env: PAPERCLIP_DB_PASSWORD, PAPERCLIP_AUTH_SECRET.
Hermes added 1 commit 2026-05-18 22:37:37 +00:00
feat: add custom Dockerfile with Hermes adapter baked in
Some checks failed
Build Hermes agent / build (pull_request) Has been cancelled
Details
Build ollama (gfx906) / build (pull_request) Has been cancelled
Details
37bf43c3ea 
Creates ai/paperclip/ with:
- Dockerfile: extends upstream paperclip image, pre-installs
  hermes-paperclip-adapter@0.3.0 npm package as seed data
- docker-entrypoint.sh: seeds the adapter plugin on first boot
  if the persistent volume is empty, then runs original startup

This ensures the Hermes adapter is available on first boot without
requiring network access — no npm install needed at runtime. The
adapter persists on the Docker volume across restarts.
Hermes added 1 commit 2026-05-18 22:38:23 +00:00
Revert custom Dockerfile - not needed, adapter installs on persistent volume
Some checks failed
Build Hermes agent / build (pull_request) Has been cancelled
Details
Build ollama (gfx906) / build (pull_request) Has been cancelled
Details
bce403232a 
The Hermes adapter can be installed once via Paperclip's adapter
management API and persists on the Docker volume across restarts.
No custom Dockerfile or build step required.
Hermes added 1 commit 2026-05-19 02:14:11 +00:00
fix(paperclip): force Traefik to use ai_net network for routing
Some checks failed
Build Hermes agent / build (pull_request) Has been cancelled
Details
Build ollama (gfx906) / build (pull_request) Has been cancelled
Details
1eacc3cd8e
Some checks failed
Build Hermes agent / build (pull_request) Has been cancelled
Details
Build ollama (gfx906) / build (pull_request) Has been cancelled
Details
This pull request has changes conflicting with the target branch.
  • ai/compose.yml
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feat/add-paperclip:feat/add-paperclip
git checkout feat/add-paperclip
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Hermes gortium
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: gortium/compose#32
No description provided.
Delete Branch "feat/add-paperclip"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?