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
112 lines
2.6 KiB
Markdown
112 lines
2.6 KiB
Markdown
# 🤖 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
|