# 🤖 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