Hermes Agent
288 lines
12 KiB
Bash
Executable File
288 lines
12 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# ============================================================================
|
||
# BSN Hermes Onboarding — Lokale Installation vollständig einrichten
|
||
# ============================================================================
|
||
# Führt ALLE Schritte aus, damit dein lokaler Hermes Agent Zugang zu allen
|
||
# BSN-Projekten, Coding-Standards und Git-Repositories hat.
|
||
#
|
||
# Ausführung:
|
||
# chmod +x bsn-onboarding.sh
|
||
# ./bsn-onboarding.sh
|
||
# ============================================================================
|
||
set -euo pipefail
|
||
|
||
RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m'
|
||
info() { echo -e "${BLUE}ℹ${NC} $*"; }
|
||
ok() { echo -e "${GREEN}✅${NC} $*"; }
|
||
warn() { echo -e "${YELLOW}⚠️${NC} $*"; }
|
||
err() { echo -e "${RED}❌${NC} $*"; }
|
||
step() { echo -e "\n${BLUE}━━━${NC} $* ${BLUE}━━━${NC}"; }
|
||
|
||
echo -e "${BLUE}"
|
||
echo " ╔══════════════════════════════════════════════════╗"
|
||
echo " ║ BSN Hermes Agent — Onboarding ║"
|
||
echo " ║ Brettspiel-News Community Projekt ║"
|
||
echo " ╚══════════════════════════════════════════════════╝"
|
||
echo -e "${NC}"
|
||
|
||
# ── Schritt 0: Basis-Checks ──────────────────────────────────────────
|
||
step "Schritt 0/7: Basis-Checks"
|
||
|
||
# Python
|
||
if command -v python3 &>/dev/null; then
|
||
PY=$(python3 --version 2>&1)
|
||
ok "Python: $PY"
|
||
else
|
||
err "python3 nicht gefunden — bitte installieren"
|
||
exit 1
|
||
fi
|
||
|
||
# Hermes
|
||
if command -v hermes &>/dev/null; then
|
||
HERMES_VER=$(hermes --version 2>&1 | head -1)
|
||
ok "Hermes: $HERMES_VER"
|
||
elif [ -f "$HOME/venv/bin/hermes" ]; then
|
||
export PATH="$HOME/venv/bin:$PATH"
|
||
ok "Hermes gefunden unter ~/venv/bin/hermes"
|
||
elif [ -f "$HOME/hermes-agent/hermes" ]; then
|
||
warn "Hermes nur als Source-Repo gefunden — installiere..."
|
||
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
|
||
export PATH="$HOME/.local/bin:$PATH"
|
||
ok "Hermes installiert"
|
||
else
|
||
err "Hermes nicht gefunden — installiere von https://github.com/NousResearch/hermes-agent"
|
||
exit 1
|
||
fi
|
||
|
||
# Git
|
||
if command -v git &>/dev/null; then
|
||
ok "Git: $(git --version)"
|
||
else
|
||
err "git nicht gefunden"
|
||
exit 1
|
||
fi
|
||
|
||
# ── Schritt 1: Python-Abhängigkeiten ──────────────────────────────────
|
||
step "Schritt 1/7: Python-Toolchain installieren"
|
||
|
||
pip install --quiet ruff mypy pre-commit pytest pytest-cov 2>&1 | tail -1
|
||
ok "ruff $(ruff --version 2>&1 | head -1 | cut -d' ' -f2)"
|
||
ok "mypy $(mypy --version 2>&1 | head -1 | cut -d' ' -f2)"
|
||
ok "pre-commit $(pre-commit --version 2>&1)"
|
||
ok "pytest $(pytest --version 2>&1 | head -1 | cut -d' ' -f2)"
|
||
|
||
# ── Schritt 2: SSH-Key für Gitea ─────────────────────────────────────
|
||
step "Schritt 2/7: SSH-Zugang zu git.datenhimmel.work"
|
||
|
||
if [ -f "$HOME/.ssh/id_ed25519.pub" ]; then
|
||
ok "SSH-Key vorhanden: $(cat $HOME/.ssh/id_ed25519.pub | cut -d' ' -f1-2)..."
|
||
else
|
||
warn "Kein SSH-Key gefunden — erstelle einen..."
|
||
ssh-keygen -t ed25519 -C "hermes@bsn-local" -f "$HOME/.ssh/id_ed25519" -N "" >/dev/null 2>&1
|
||
ok "SSH-Key erstellt: $(cat $HOME/.ssh/id_ed25519.pub | cut -d' ' -f1-2)..."
|
||
echo -e "${YELLOW}"
|
||
echo " ╔══════════════════════════════════════════════════════════╗"
|
||
echo " ║ 🔑 DIESEN KEY in Gitea hinterlegen: ║"
|
||
echo " ║ https://git.datenhimmel.work/user/settings/keys ║"
|
||
echo " ║ ║"
|
||
cat "$HOME/.ssh/id_ed25519.pub"
|
||
echo " ║ ║"
|
||
echo " ╚══════════════════════════════════════════════════════════╝"
|
||
echo -e "${NC}"
|
||
fi
|
||
|
||
# ── Schritt 3: Git-Repositories klonen ───────────────────────────────
|
||
step "Schritt 3/7: BSN-Repositories klonen"
|
||
|
||
WORKSPACE="$HOME/workspace"
|
||
mkdir -p "$WORKSPACE"
|
||
|
||
clone_repo() {
|
||
local name=$1 repo=$2 dir="$WORKSPACE/$3"
|
||
if [ -d "$dir/.git" ]; then
|
||
ok "$name bereits vorhanden — pull..."
|
||
(cd "$dir" && git pull --ff-only 2>/dev/null) || warn "$name: pull fehlgeschlagen"
|
||
else
|
||
info "Klone $name..."
|
||
git clone "$repo" "$dir" 2>/dev/null && ok "$name geklont" || warn "$name: clone fehlgeschlagen (SSH-Key in Gitea hinterlegt?)"
|
||
fi
|
||
}
|
||
|
||
clone_repo "BSN-Chatsystem" "git@git.datenhimmel.work:danielkrause/BSN-Chatsystem.git" "bsn-chatbot"
|
||
|
||
# ── Schritt 4: Coding-Standards-Skill installieren ────────────────────
|
||
step "Schritt 4/7: BSN Coding Standards Skill einrichten"
|
||
|
||
PROFILE_DIR="$HOME/.hermes/profiles/cody"
|
||
SKILL_DIR="$PROFILE_DIR/skills/software-development/bsn-coding-standards"
|
||
|
||
if [ -d "$SKILL_DIR" ] && [ -f "$SKILL_DIR/SKILL.md" ]; then
|
||
ok "bsn-coding-standards Skill bereits installiert"
|
||
else
|
||
# Vom Server kopieren oder lokal aus dem Repo nehmen
|
||
if [ -f "$WORKSPACE/bsn-chatbot/docs/bsn-coding-standards.html" ]; then
|
||
info "Skill aus lokalem Repo erstellen..."
|
||
mkdir -p "$SKILL_DIR/references"
|
||
|
||
# Skill-MD aus dem Repo kopieren (falls vorhanden) oder neu erstellen
|
||
if [ -f "$WORKSPACE/bsn-chatbot/CODING_STANDARDS.md" ]; then
|
||
# Erstelle SKILL.md aus CODING_STANDARDS.md
|
||
cat > "$SKILL_DIR/SKILL.md" << 'SKILLEOF'
|
||
---
|
||
name: bsn-coding-standards
|
||
description: Verbindliche Coding-Regeln für ALLE BSN-Projekte
|
||
version: 1.0.0
|
||
category: software-development
|
||
---
|
||
# BSN Coding Standards
|
||
|
||
> Geltungsbereich: Sämtlicher Python-Code im Brettspiel-News-Community-Projekt.
|
||
> Durchsetzung: Gitea Actions (.gitea/workflows/quality.yml) + pre-commit.
|
||
> Vollständiges Dokument: docs/bsn-coding-standards.html
|
||
|
||
## 🔴 KRITISCHE REGELN
|
||
|
||
1. **Typ-Annotationen** — JEDE Funktion. `X | None`, nicht `Optional[X]`.
|
||
2. **Docstrings** — DEUTSCH, Google-Style.
|
||
3. **Secrets** — NIE im Code. `.env` + `.db` in `.gitignore`.
|
||
4. **Keine God-Files** — Max 500 Zeilen/Modul, max 50 Statements/Funktion.
|
||
|
||
## 🟡 CODE-STIL
|
||
- Zeilenlänge max 100, 4 Leerzeichen, double quotes
|
||
- Import-Reihenfolge: stdlib → third-party → projekt
|
||
- Trailing Commas bei mehrzeiligen Collections
|
||
|
||
## 🟡 NAMEN
|
||
- snake_case (Module, Funktionen, Variablen)
|
||
- PascalCase (Klassen), UPPER_SNAKE_CASE (Konstanten)
|
||
|
||
## 🟡 SICHERHEIT
|
||
- Keine asserts in Produktion, kein pickle, bcrypt/argon2
|
||
- Input-Validierung, parameterisierte Queries
|
||
|
||
## 🟡 FLASK
|
||
- methods=[...] explizit, get_json(silent=True) mit None-Check
|
||
- Response mit Statuscode, CSS immer inline, BSN-Blau #20228a
|
||
|
||
## 🟡 GIT
|
||
- Conventional Commits: feat, fix, docs, chore, security
|
||
- Vor jedem Commit: ruff check + mypy + pytest
|
||
|
||
## 🟢 TOOLS
|
||
- ruff check . --fix && ruff format .
|
||
- mypy . (im venv!)
|
||
- pytest --cov --cov-fail-under=80
|
||
- Gitea Actions CI: .gitea/workflows/quality.yml
|
||
SKILLEOF
|
||
ok "Skill aus CODING_STANDARDS.md erstellt"
|
||
else
|
||
warn "CODING_STANDARDS.md nicht gefunden — Skill muss manuell erstellt werden"
|
||
warn "Kopiere die SKILL.md vom Server: ~/.hermes/profiles/cody/skills/software-development/bsn-coding-standards/SKILL.md"
|
||
fi
|
||
fi
|
||
fi
|
||
|
||
# ── Schritt 5: Hermes-Profil konfigurieren ───────────────────────────
|
||
step "Schritt 5/7: Profil-Konfiguration"
|
||
|
||
# Prüfen ob das cody-Profil existiert
|
||
if [ -f "$PROFILE_DIR/config.yaml" ]; then
|
||
ok "Profil 'cody' existiert"
|
||
|
||
# Environment-Hint setzen
|
||
HINT="Befolge die BSN Coding Standards. Lade sie mit skill_view('bsn-coding-standards'). Durchsetzung: Gitea Actions (.gitea/workflows/quality.yml) + pre-commit. Volles Regelwerk: docs/bsn-coding-standards.html"
|
||
|
||
CURRENT=$(python3 -c "
|
||
import yaml
|
||
try:
|
||
with open('$PROFILE_DIR/config.yaml') as f:
|
||
c = yaml.safe_load(f)
|
||
print(c.get('agent',{}).get('environment_hint',''))
|
||
except: pass
|
||
" 2>/dev/null)
|
||
|
||
if [ "$CURRENT" = "$HINT" ]; then
|
||
ok "environment_hint bereits korrekt"
|
||
else
|
||
hermes config set agent.environment_hint "$HINT" 2>/dev/null && \
|
||
ok "environment_hint gesetzt" || \
|
||
warn "environment_hint konnte nicht gesetzt werden — manuell in $PROFILE_DIR/config.yaml eintragen"
|
||
fi
|
||
else
|
||
warn "Profil 'cody' existiert nicht — erstelle es mit: hermes profile create cody"
|
||
warn "Dann diesen Schritt wiederholen"
|
||
fi
|
||
|
||
# ── Schritt 6: .env-Variablen prüfen ──────────────────────────────────
|
||
step "Schritt 6/7: Umgebungsvariablen"
|
||
|
||
ENV_FILE="$HOME/.hermes/.env"
|
||
REQUIRED_VARS=("DEEPSEEK_API_KEY" "META_TOKEN" "TELEGRAM_TOKEN" "TAVILY_API_KEY")
|
||
|
||
if [ -f "$ENV_FILE" ]; then
|
||
ok ".env-Datei vorhanden: $ENV_FILE"
|
||
|
||
for var in "${REQUIRED_VARS[@]}"; do
|
||
if grep -q "^$var=" "$ENV_FILE" 2>/dev/null; then
|
||
ok "$var gesetzt"
|
||
else
|
||
warn "$var FEHLT in .env"
|
||
fi
|
||
done
|
||
else
|
||
warn "Keine .env-Datei gefunden. Erstelle $ENV_FILE mit:"
|
||
echo ""
|
||
for var in "${REQUIRED_VARS[@]}"; do
|
||
echo " $var=dein_key_hier"
|
||
done
|
||
echo ""
|
||
fi
|
||
|
||
# ── Schritt 7: Verifikation ──────────────────────────────────────────
|
||
step "Schritt 7/7: Verifikation — alles grün?"
|
||
|
||
FAILS=0
|
||
|
||
echo ""
|
||
info "Prüfe: Hermes erreichbar..."
|
||
hermes --version >/dev/null 2>&1 && ok "Hermes CLI" || { err "Hermes CLI"; FAILS=$((FAILS+1)); }
|
||
|
||
info "Prüfe: Git-Zugang zu Gitea..."
|
||
ssh -o StrictHostKeyChecking=no -o ConnectTimeout=5 -T git@git.datenhimmel.work 2>&1 | grep -q "successfully authenticated" && \
|
||
ok "SSH zu Gitea" || { warn "SSH zu Gitea — Key in Gitea hinterlegen: https://git.datenhimmel.work/user/settings/keys"; }
|
||
|
||
info "Prüfe: Python-Tools..."
|
||
ruff --version >/dev/null 2>&1 && ok "ruff" || { err "ruff"; FAILS=$((FAILS+1)); }
|
||
mypy --version >/dev/null 2>&1 && ok "mypy" || { err "mypy"; FAILS=$((FAILS+1)); }
|
||
pytest --version >/dev/null 2>&1 && ok "pytest" || { err "pytest"; FAILS=$((FAILS+1)); }
|
||
|
||
info "Prüfe: BSN-Skill..."
|
||
python3 -c "
|
||
import os, sys
|
||
skill_path = os.path.expanduser('$SKILL_DIR/SKILL.md')
|
||
if os.path.exists(skill_path):
|
||
sys.exit(0)
|
||
else:
|
||
sys.exit(1)
|
||
" 2>/dev/null && ok "bsn-coding-standards Skill" || { warn "Skill fehlt — Schritt 4 wiederholen"; }
|
||
|
||
echo ""
|
||
if [ $FAILS -eq 0 ]; then
|
||
echo -e "${GREEN} ✅✅✅ ALLE CHECKS BESTANDEN — Hermes ist BSN-bereit! ✅✅✅${NC}"
|
||
else
|
||
echo -e "${YELLOW} ⚠️ $FAILS Check(s) fehlgeschlagen — siehe oben.${NC}"
|
||
fi
|
||
|
||
echo ""
|
||
echo -e "${BLUE} 🚀 Nächster Schritt:${NC}"
|
||
echo " hermes # Interaktiver Chat"
|
||
echo " hermes chat -q \"Bearbeite Aufgabe X\""
|
||
echo " hermes -s bsn-coding-standards # Mit BSN-Regeln starten"
|
||
echo ""
|
||
|
||
echo -e "${BLUE} 📚 Referenzen:${NC}"
|
||
echo " Skill: skill_view('bsn-coding-standards')"
|
||
echo " Volles Regelwerk: docs/bsn-coding-standards.html"
|
||
echo " Testaufgabe: docs/bsn-agent-testaufgabe.md"
|
||
echo " CI-Workflow: .gitea/workflows/quality.yml"
|