mirror of
https://github.com/domfelipe/hermes-client-onboarding.git
synced 2026-08-07 11:36:47 +00:00
Initial release: Hermes client onboarding bootstrap + skill
One-liner install.sh, conversational skill for OpenRouter/DeepSeek V4 Flash + Telegram gateway, and DomHubs client demo flow.
This commit is contained in:
domfelipe
commit
4c33662ead
6 changed files with 807 additions and 0 deletions
257
install.sh
Executable file
257
install.sh
Executable file
|
|
@ -0,0 +1,257 @@
|
|||
#!/usr/bin/env bash
|
||||
# DomHubs — Hermes Client Onboarding bootstrap
|
||||
# One-liner: curl -fsSL https://setup.domhubs.com.br/hermes | bash
|
||||
# Local: ./install.sh [--conductor codex|hermes|skip] [--no-launch]
|
||||
set -euo pipefail
|
||||
|
||||
SKILL_NAME="hermes-client-onboarding"
|
||||
DEFAULT_BASE="${HERMES_ONBOARD_BASE:-https://setup.domhubs.com.br/hermes}"
|
||||
HERMES_INSTALL_URL="${HERMES_INSTALL_URL:-https://hermes-agent.nousresearch.com/install.sh}"
|
||||
KICKOFF_MSG="${HERMES_ONBOARD_KICKOFF:-Inicie agora o onboarding de cliente Hermes. Siga a skill hermes-client-onboarding fase a fase (Phase 1 primeiro). Fale em português brasileiro.}"
|
||||
|
||||
CONDUCTOR="${HERMES_ONBOARD_CONDUCTOR:-}"
|
||||
NO_LAUNCH=0
|
||||
NONINTERACTIVE=0
|
||||
|
||||
log() { printf '==> %s\n' "$*"; }
|
||||
warn() { printf 'warn: %s\n' "$*" >&2; }
|
||||
die() { printf 'error: %s\n' "$*" >&2; exit 1; }
|
||||
|
||||
usage() {
|
||||
cat <<'EOF'
|
||||
Usage: install.sh [options]
|
||||
|
||||
--conductor codex|hermes|skip Who runs the guided onboarding (default: prompt)
|
||||
--no-launch Install only; do not start the conductor
|
||||
--base URL Asset base for skill files (or HERMES_ONBOARD_BASE)
|
||||
--non-interactive No prompts; default conductor=hermes if unset
|
||||
-h, --help Show help
|
||||
|
||||
Env:
|
||||
HERMES_ONBOARD_BASE, HERMES_ONBOARD_CONDUCTOR, HERMES_ONBOARD_KICKOFF
|
||||
HERMES_INSTALL_URL, HERMES_ONBOARD_NO_LAUNCH=1
|
||||
EOF
|
||||
}
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--conductor) CONDUCTOR="${2:-}"; shift 2 ;;
|
||||
--no-launch) NO_LAUNCH=1; shift ;;
|
||||
--base) DEFAULT_BASE="${2:-}"; shift 2 ;;
|
||||
--non-interactive) NONINTERACTIVE=1; shift ;;
|
||||
-h|--help) usage; exit 0 ;;
|
||||
*) die "unknown arg: $1" ;;
|
||||
esac
|
||||
done
|
||||
|
||||
[[ "${HERMES_ONBOARD_NO_LAUNCH:-0}" == "1" ]] && NO_LAUNCH=1
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Resolve skill source: local checkout vs remote base URL
|
||||
# ---------------------------------------------------------------------------
|
||||
SCRIPT_PATH="${BASH_SOURCE[0]:-}"
|
||||
SCRIPT_DIR=""
|
||||
if [[ -n "$SCRIPT_PATH" && -f "$SCRIPT_PATH" ]]; then
|
||||
SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
|
||||
fi
|
||||
|
||||
LOCAL_SKILL=""
|
||||
if [[ -n "$SCRIPT_DIR" && -f "$SCRIPT_DIR/skill/${SKILL_NAME}/SKILL.md" ]]; then
|
||||
LOCAL_SKILL="$SCRIPT_DIR/skill/${SKILL_NAME}"
|
||||
fi
|
||||
|
||||
need_cmd() { command -v "$1" >/dev/null 2>&1; }
|
||||
|
||||
os_name="$(uname -s 2>/dev/null || echo unknown)"
|
||||
case "$os_name" in
|
||||
Linux|Darwin) ;;
|
||||
*) warn "untested OS: $os_name (expected Linux Ubuntu/Debian for production demos)" ;;
|
||||
esac
|
||||
|
||||
if [[ "$os_name" == "Darwin" ]]; then
|
||||
warn "macOS detected — gateway uses launchd; production clients should be Ubuntu/Debian VMs"
|
||||
fi
|
||||
|
||||
export PATH="${HOME}/.local/bin:${PATH}"
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Ensure Hermes
|
||||
# ---------------------------------------------------------------------------
|
||||
ensure_hermes() {
|
||||
if need_cmd hermes; then
|
||||
log "Hermes already installed: $(hermes --version 2>/dev/null | head -1 || echo ok)"
|
||||
return 0
|
||||
fi
|
||||
log "Installing Hermes (--skip-browser)..."
|
||||
need_cmd curl || die "curl is required"
|
||||
curl -fsSL "$HERMES_INSTALL_URL" | bash -s -- --skip-browser
|
||||
export PATH="${HOME}/.local/bin:${PATH}"
|
||||
# shellcheck disable=SC1090
|
||||
source "${HOME}/.bashrc" 2>/dev/null || true
|
||||
need_cmd hermes || die "Hermes install finished but 'hermes' not on PATH. Open a new shell or: export PATH=\"\$HOME/.local/bin:\$PATH\""
|
||||
log "Hermes installed: $(hermes --version 2>/dev/null | head -1 || echo ok)"
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Install skill into Hermes (+ Codex/agents if present)
|
||||
# ---------------------------------------------------------------------------
|
||||
copy_tree() {
|
||||
local src="$1" dest="$2"
|
||||
mkdir -p "$dest"
|
||||
# portable: prefer cp -R then fix modes
|
||||
rm -rf "${dest:?}/"*
|
||||
cp -R "$src"/. "$dest"/
|
||||
if [[ -f "$dest/scripts/apply-core-config.sh" ]]; then
|
||||
chmod +x "$dest/scripts/apply-core-config.sh"
|
||||
fi
|
||||
}
|
||||
|
||||
fetch_skill_to() {
|
||||
local dest="$1"
|
||||
local base="$DEFAULT_BASE"
|
||||
need_cmd curl || die "curl is required to download skill assets"
|
||||
mkdir -p "$dest/references" "$dest/scripts"
|
||||
log "Downloading skill from ${base}/skill/${SKILL_NAME}/ ..."
|
||||
curl -fsSL "${base}/skill/${SKILL_NAME}/SKILL.md" -o "$dest/SKILL.md"
|
||||
curl -fsSL "${base}/skill/${SKILL_NAME}/references/troubleshooting.md" -o "$dest/references/troubleshooting.md"
|
||||
curl -fsSL "${base}/skill/${SKILL_NAME}/scripts/apply-core-config.sh" -o "$dest/scripts/apply-core-config.sh"
|
||||
chmod +x "$dest/scripts/apply-core-config.sh"
|
||||
[[ -s "$dest/SKILL.md" ]] || die "failed to download SKILL.md from $base"
|
||||
}
|
||||
|
||||
install_skill() {
|
||||
local staging
|
||||
staging="$(mktemp -d)"
|
||||
# shellcheck disable=SC2064
|
||||
trap "rm -rf '$staging'" RETURN
|
||||
|
||||
if [[ -n "$LOCAL_SKILL" ]]; then
|
||||
log "Using local skill: $LOCAL_SKILL"
|
||||
copy_tree "$LOCAL_SKILL" "$staging"
|
||||
else
|
||||
fetch_skill_to "$staging"
|
||||
fi
|
||||
|
||||
local hermes_dest="${HOME}/.hermes/skills/${SKILL_NAME}"
|
||||
mkdir -p "${HOME}/.hermes/skills"
|
||||
copy_tree "$staging" "$hermes_dest"
|
||||
log "Skill installed for Hermes → $hermes_dest"
|
||||
|
||||
# Codex / agents (optional)
|
||||
if [[ -d "${HOME}/.codex" ]] || need_cmd codex; then
|
||||
mkdir -p "${HOME}/.codex/skills"
|
||||
copy_tree "$staging" "${HOME}/.codex/skills/${SKILL_NAME}"
|
||||
log "Skill installed for Codex → ~/.codex/skills/${SKILL_NAME}"
|
||||
fi
|
||||
if [[ -d "${HOME}/.agents/skills" ]]; then
|
||||
copy_tree "$staging" "${HOME}/.agents/skills/${SKILL_NAME}"
|
||||
log "Skill installed for agents → ~/.agents/skills/${SKILL_NAME}"
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Conductor selection + launch
|
||||
# ---------------------------------------------------------------------------
|
||||
pick_conductor() {
|
||||
if [[ -n "$CONDUCTOR" ]]; then
|
||||
echo "$CONDUCTOR"
|
||||
return
|
||||
fi
|
||||
if [[ "$NONINTERACTIVE" -eq 1 ]]; then
|
||||
if need_cmd codex; then echo codex; else echo hermes; fi
|
||||
return
|
||||
fi
|
||||
# curl|bash: stdin is the script pipe — read prompts from the real TTY when possible
|
||||
local tty_in="/dev/tty"
|
||||
if [[ ! -r "$tty_in" ]]; then
|
||||
if need_cmd codex; then echo codex; else echo hermes; fi
|
||||
return
|
||||
fi
|
||||
|
||||
local has_codex=0
|
||||
need_cmd codex && has_codex=1
|
||||
|
||||
echo "" >&2
|
||||
echo "Quem deve conduzir o onboarding conversacional?" >&2
|
||||
if [[ "$has_codex" -eq 1 ]]; then
|
||||
echo " 1) Codex (recomendado se disponível)" >&2
|
||||
echo " 2) Hermes (modelos baratos / já instalado)" >&2
|
||||
echo " 3) Só instalar skill — não abrir agente" >&2
|
||||
printf "Escolha [1]: " >&2
|
||||
read -r ans <"$tty_in" || ans=1
|
||||
case "${ans:-1}" in
|
||||
2|hermes|h) echo hermes ;;
|
||||
3|skip|s) echo skip ;;
|
||||
*) echo codex ;;
|
||||
esac
|
||||
else
|
||||
echo " 1) Hermes" >&2
|
||||
echo " 2) Só instalar skill — não abrir agente" >&2
|
||||
printf "Escolha [1]: " >&2
|
||||
read -r ans <"$tty_in" || ans=1
|
||||
case "${ans:-1}" in
|
||||
2|skip|s) echo skip ;;
|
||||
*) echo hermes ;;
|
||||
esac
|
||||
fi
|
||||
}
|
||||
|
||||
launch_conductor() {
|
||||
local c="$1"
|
||||
case "$c" in
|
||||
skip)
|
||||
log "Skill pronta. Rode depois:"
|
||||
echo " hermes chat -s ${SKILL_NAME}"
|
||||
need_cmd codex && echo " codex \"${KICKOFF_MSG}\""
|
||||
return 0
|
||||
;;
|
||||
hermes)
|
||||
need_cmd hermes || die "hermes missing"
|
||||
log "Abrindo Hermes com skill ${SKILL_NAME}..."
|
||||
echo ""
|
||||
echo "────────────────────────────────────────"
|
||||
echo "Quando o chat abrir, envie (ou já use):"
|
||||
echo " ${KICKOFF_MSG}"
|
||||
echo "────────────────────────────────────────"
|
||||
echo ""
|
||||
# Reattach stdin to TTY after curl|bash so the chat is interactive
|
||||
if [[ -r /dev/tty ]]; then
|
||||
exec hermes chat -s "$SKILL_NAME" </dev/tty
|
||||
else
|
||||
exec hermes chat -s "$SKILL_NAME"
|
||||
fi
|
||||
;;
|
||||
codex)
|
||||
need_cmd codex || die "codex not found — install Codex or use --conductor hermes"
|
||||
log "Abrindo Codex com kickoff de onboarding..."
|
||||
if [[ -r /dev/tty ]]; then
|
||||
exec codex --sandbox danger-full-access "$KICKOFF_MSG" </dev/tty
|
||||
else
|
||||
exec codex --sandbox danger-full-access "$KICKOFF_MSG"
|
||||
fi
|
||||
;;
|
||||
*)
|
||||
die "unknown conductor: $c"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
main() {
|
||||
log "DomHubs Hermes Client Onboarding"
|
||||
ensure_hermes
|
||||
install_skill
|
||||
|
||||
if [[ "$NO_LAUNCH" -eq 1 ]]; then
|
||||
log "Done (--no-launch). Start with:"
|
||||
echo " hermes chat -s ${SKILL_NAME}"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
local c
|
||||
c="$(pick_conductor)"
|
||||
log "Conductor: $c"
|
||||
launch_conductor "$c"
|
||||
}
|
||||
|
||||
main "$@"
|
||||
Loading…
Add table
Add a link
Reference in a new issue