mates
444191d16d
- docker-services: 14 generic compose templates (portainer, npm, vaultwarden, gitea, jotty, nextcloud-aio, rustdesk, audiobookshelf, calibre-web, plex, erugo, jswiki, speedtest, watchtower) - install-scripts: bash scripts for Ubuntu server bootstrap, docker, portainer, npm, backup, restore - ansible: 4 playbooks (bootstrap, deploy-services, update-services, security-hardening) + roles skeleton - hermes-install: Hermes CLI setup on macOS - macos-setup: Brewfile + osx-defaults + fish-config - home-nas-tools: metadata index for NAS projects (no binaries) - docs: architecture, security, contributing - README, LICENSE (MIT), .gitignore
🤖 Hermes Install
Instalace a konfigurace Hermes Agent (AI asistent) na macOS.
📦 Obsah
| Soubor | Účel |
|---|---|
install-hermes.sh |
Instaluje Hermes CLI |
configure-hermes.sh |
Nastaví API klíče, pracovní adresáře, profily |
hermes-config.example.yml |
Ukázková konfigurace |
README.md |
Tento soubor |
🤖 Co je Hermes?
Hermes je AI asistent (Claude/GPT) integrovaný v terminálu. Umí:
- Spravovat soubory, Git, Docker
- Spouštět skripty (sandbox)
- Plánovat a provádět multi-step úkoly
- Učit se z paměti
- Integrovat se schránkou, poštou, kalendářem
🚀 Quickstart
# 1. Instalace
curl -fsSL https://hermes-agent.dev/install.sh | bash
# Nebo:
bash install-hermes.sh
# 2. Konfigurace (API klíč)
bash configure-hermes.sh
# nebo ručně:
hermes config set api-key <tvuj-api-klic>
hermes config set model claude-sonnet-4.5
# 3. Test
hermes --version
hermes chat "Ahoj, kdo jsi?"
# 4. Přidání Fish aliasu (volitelně)
hermes config alias
⚙️ Konfigurace
hermes-config.example.yml obsahuje:
# API provider
provider: anthropic
model: claude-sonnet-4.5
api_key: ${HERMES_API_KEY}
# Pracovní adresáře
workspace: ~/Skripty
memory_dir: ~/.hermes/memory
# Sandbox: povolené příkazy
sandbox:
allow:
- "ls"
- "cat"
- "git"
- "docker"
- "kubectl"
deny:
- "rm -rf /"
- "dd if="
🔐 Bezpečnost
- Sandbox – Hermes ve výchozím stavu nesmaže
rm -rf /ani podobné destruktivní příkazy - API klíč – ulož do macOS keychainu, ne do konfiguráku
- Audit log –
hermes log showukáže historii příkazů - Permissions – nastav na minimum potřebné
🧠 Memory a kontext
Hermes si pamatuje:
- Tvoje preference a workflow
- Kontext projektů (~/Skripty, ~/git-repos, …)
- Dřívější konverzace
Reset:
hermes memory reset
hermes memory show
🔌 Integrace
- Gitea – push/pull, správa issues
- Docker – compose, logs, restart
- Git – všechny git operace
- Fish shell – aliasy
- macOS – clipboard, notifications
📚 Dokumentace
🆘 Support
- Issues: github.com/NousResearch/hermes-agent/issues
- Discord: discord.gg/hermes
- Email: support@hermes-agent.dev