hermes-client-onboarding/README.md
domfelipe ee5e29e1fd Default bootstrap BASE to setup.domhubs.com.br/hermes
Production one-liner serves install.sh + skill from the DomHubs VPS.
2026-08-02 23:38:11 -03:00

3.7 KiB
Raw Blame History

Hermes Client Onboarding (DomHubs)

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

  • OpenRouter + deepseek/deepseek-v4-flash
  • Telegram (gateway como serviço)
  • Personalidade em SOUL.md
  • Setup guiado por LLM (Codex ou Hermes)

One-liner (produção)

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

Variantes:

# só instalar skill + Hermes, sem abrir agente
curl -fsSL https://setup.domhubs.com.br/hermes | bash -s -- --no-launch

# forçar condutor
curl -fsSL https://setup.domhubs.com.br/hermes | bash -s -- --conductor hermes
curl -fsSL https://setup.domhubs.com.br/hermes | bash -s -- --conductor codex

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:

  1. Instala Hermes se faltar (--skip-browser)
  2. Copia a skill para ~/.hermes/skills/hermes-client-onboarding/
  3. Copia também para ~/.codex/skills/ e ~/.agents/skills/ se existirem
  4. 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 + Lets 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 /hermesinstall.sh).

Opção C — Gist

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

Stack padrão (decisões)

Item Valor
Modelo deepseek/deepseek-v4-flash via OpenRouter
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
hermes chat -s hermes-client-onboarding
# completar fases 16 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 \
  --openrouter-key "$OPENROUTER_API_KEY" \
  --telegram-token "$TELEGRAM_BOT_TOKEN" \
  --allowed-users "123456789"

Não imprime secrets.

Licença

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