feat: initial infra repo

- 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
2026-08-01 16:25:58 +02:00
commit 444191d16d
73 changed files with 4032 additions and 0 deletions
@@ -0,0 +1,111 @@
+# 🤖 Hermes Install
+
+> Instalace a konfigurace **Hermes Agent** (AI asistent) na macOS.
+
+## 📦 Obsah
+
+| Soubor | Účel |
+|---|---|
+| [`install-hermes.sh`](install-hermes.sh) | Instaluje Hermes CLI |
+| [`configure-hermes.sh`](configure-hermes.sh) | Nastaví API klíče, pracovní adresáře, profily |
+| [`hermes-config.example.yml`](hermes-config.example.yml) | Ukázková konfigurace |
+| [`README.md`](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
+
+```bash
+# 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:
+
+```yaml
+# 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 show` ukáž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:
+```bash
+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
+
+- [Hermes docs](https://hermes-agent.nousresearch.com/docs)
+- [Hermes GitHub](https://github.com/NousResearch/hermes-agent)
+
+## 🆘 Support
+
+- **Issues:** [github.com/NousResearch/hermes-agent/issues](https://github.com/NousResearch/hermes-agent/issues)
+- **Discord:** [discord.gg/hermes](https://discord.gg/hermes)
+- **Email:** support@hermes-agent.dev