mirror of https://github.com/domfelipe/hermes-client-onboarding.git synced 2026-08-07 03:36:48 +00:00

domfelipe ff725338f3 Multi-tenant shared VPS: one client = one Hermes profile

Require --client SLUG on the one-liner; add hermes-client-provision for
isolated HERMES_HOME + hermes-gateway-<slug>. Document profile isolation
over per-VM/Docker for DomHubs fleet on a single host.

2026-08-04 20:40:23 -03:00

5.7 KiB

Raw Permalink Blame History

Hermes Client Onboarding (DomHubs)

One-liner + skill conversacional para deixar o Hermes Agent pronto no cliente em minutos:

DeepSeek nativo + deepseek-v4-flash (V4 Flash 0731)
Telegram (gateway como serviço)
Personalidade em SOUL.md
Setup guiado por LLM (Codex ou Hermes)

One-liner (produção) — VPS compartilhada multi-tenant

Uma VPS DomHubs, vários clientes. Isolamento = Hermes profile por cliente (não VM nova, não Docker por padrão).

Cliente	Home	Gateway unit
`flavia`	`~/.hermes/profiles/flavia/`	`hermes-gateway-flavia`
`acme`	`~/.hermes/profiles/acme/`	`hermes-gateway-acme`

Cada um: bot token, allowlist, SOUL, state.db próprios. Nunca reutilizar token entre profiles.

1) Entrar na VPS

ssh domhubs-vps
# → root@169.58.116.28

2) One-liner com slug do cliente (obrigatório)

curl -fsSL https://setup.domhubs.com.br/hermes | bash -s -- --client flavia

Isso: instala/atualiza Hermes + skill → provisiona profile isolado → abre onboarding só nesse profile.

Variantes:

# provisionar sem abrir o agente
curl -fsSL https://setup.domhubs.com.br/hermes | bash -s -- --client acme --no-launch

# reabrir onboarding de um cliente
hermes-client-onboarding --client flavia

# só criar/atualizar a instância
hermes-client-provision --client acme

3) Ops diário

ssh domhubs-vps
hermes profile list
hermes --profile flavia gateway status
journalctl --user -u hermes-gateway-flavia -n 50 --no-pager

Por que não container (ainda)

Profiles + HERMES_HOME + multi-gateway já isolam secrets/histórico/polling do Telegram com ~150 MB RAM/cliente. Docker entra depois se precisar sandbox de shell/tools por cliente.

Espelho GitHub (fallback):

curl -fsSL https://raw.githubusercontent.com/domfelipe/hermes-client-onboarding/main/install.sh | bash
# se usar o raw, force o BASE da skill se precisar:
# HERMES_ONBOARD_BASE=https://setup.domhubs.com.br/hermes bash

Repo: https://github.com/domfelipe/hermes-client-onboarding

Layout

install.sh                          # bootstrap
skill/hermes-client-onboarding/
  SKILL.md
  references/troubleshooting.md
  scripts/apply-core-config.sh

O bootstrap:

Instala Hermes se faltar (--skip-browser)
Copia a skill para ~/.hermes/skills/hermes-client-onboarding/
Copia também para ~/.codex/skills/ e ~/.agents/skills/ se existirem
Pergunta o condutor (Codex / Hermes / skip) e abre o chat com a skill

Uso local (dev)

cd hermes-client-onboarding
chmod +x install.sh skill/hermes-client-onboarding/scripts/apply-core-config.sh
./install.sh --no-launch          # instala skill local sem abrir TUI
./install.sh --conductor hermes   # abre Hermes com skill

Hospedagem do one-liner

O install.sh baixa a skill de HERMES_ONBOARD_BASE quando não está rodando a partir de um checkout com skill/.

Default atual: https://setup.domhubs.com.br/hermes (VPS 169.58.116.28, Caddy + Let’s Encrypt)

Opção A — GitHub raw (já no ar)

Funciona sem infra extra. URLs:

Path	Uso
`.../main/install.sh`	bootstrap
`.../main/skill/hermes-client-onboarding/SKILL.md`	skill
`.../main/skill/.../references/troubleshooting.md`	ref
`.../main/skill/.../scripts/apply-core-config.sh`	helper

Opção B — Domínio próprio (VPS / Coolify)

Proxy reverso para raw do GitHub ou serve o clone estático:

URL	Arquivo
`https://setup.domhubs.com.br/hermes`	`install.sh`
`https://setup.domhubs.com.br/hermes/skill/...`	skill tree

Nginx/Caddy: path /hermes → root do repo (rewrite /hermes → install.sh).

Opção C — Gist

Só se embutir a skill no script. Prefira GitHub raw.

Stack padrão (decisões)

Item	Valor
Provider	`deepseek` (API nativa)
Modelo	`deepseek-v4-flash` (V4 Flash 0731)
Secret	`DEEPSEEK_API_KEY`
Canal	Telegram
Gateway	`hermes gateway install` (systemd/launchd)
Soul	`~/.hermes/SOUL.md`
Alvo	Ubuntu/Debian VM limpa

Validação manual (VM limpa)

# 1. bootstrap
./install.sh --no-launch

# 2. skill presente
test -f ~/.hermes/skills/hermes-client-onboarding/SKILL.md && echo skill_ok

# 3. hermes ok
hermes --version
hermes doctor

# 4. onboarding interativo (agente fala primeiro — Phase 1)
hermes-client-onboarding
# ou: hermes chat --tui -s hermes-client-onboarding -q "Inicie AGORA o onboarding…"
# completar fases 1–6 com chaves reais de teste

# 5. smoke telegram
hermes gateway status
# enviar "oi" no bot

Helper de config

~/.hermes/skills/hermes-client-onboarding/scripts/apply-core-config.sh \
  --deepseek-key "$DEEPSEEK_API_KEY" \
  --telegram-token "$TELEGRAM_BOT_TOKEN" \
  --allowed-users "123456789"

Equivalente manual:

hermes config set DEEPSEEK_API_KEY "sk-..."
hermes config set model.provider deepseek
hermes config set model.default deepseek-v4-flash
hermes config set model.base_url "https://api.deepseek.com/v1"

Não imprime secrets.

Launcher (agente fala primeiro)

O bootstrap instala ~/.local/bin/hermes-client-onboarding:

hermes-client-onboarding

Por padrão usa tmux (Hermes em sessão dedicada + send-keys do kickoff). Isso evita o freeze do wrapper PTY com prompt_toolkit.

# se pedir tmux e não tiver:
# apt install -y tmux

hermes-client-onboarding
# detach: Ctrl-b d
# reattach: tmux ls && tmux attach -t hermes-onboard-<pid>

# TUI Ink (opcional, kickoff frágil)
HERMES_ONBOARD_USE_TUI=1 hermes-client-onboarding

Licença

MIT (skill + bootstrap DomHubs). Hermes Agent em si: licença do projeto Nous Research.

5.7 KiB Raw Permalink Blame History Unescape Escape