# Kit démarrage Hermes Agent (FR)
# Agent Concret · Camille (camille_cli)
# Mis a jour : 2026-07-30
# Doc officielle : https://hermes-agent.nousresearch.com/docs
# Installer : https://hermes-agent.nousresearch.com/install.sh

---

## 0. En 60 secondes

Hermes Agent = agent IA open-source (Nous Research) qui tourne chez toi :
terminal, desktop, messageries, IDE. Il appelle des outils, garde de la
memoire, apprend via des skills, et n'est pas locked a un seul fournisseur LLM.

Ce kit te fait passer de zero a un premier run utile, puis a 7 jours d'usages
concrets, sans brancher WhatsApp + 40 MCP + des crons le jour 0.

**Pas le compte officiel Hermes / Nous Research.**

---

## 1. Hermes, c'est pour toi si...

### Oui
- Tu as des taches repetitives (tri, drafts, veille, checklists, petits scripts)
- Tu acceptes 30-90 min de setup
- Tu veux un agent qui AGIT (fichiers, commandes, skills), pas seulement chatter
- Tu gardes un oeil humain sur ce qui part a l'exterieur

### Non (encore)
- Tu refuses toute ligne de commande / config
- Tu veux "remplacer mon equipe cette nuit"
- Tu n'as aucun cas d'usage, juste la FOMO Twitter
- Tu comptes coller des secrets dans le chat public

### Alternatives honnetes
| Besoin | Outil souvent mieux |
|--------|---------------------|
| Un mail ponctuel | Chat web classique |
| Coder dans un repo | Claude Code / Codex / copilot IDE |
| Agent persistant multi-surface | Hermes |

---

## 2. Install chemin minimal (copie-colle)

### Linux / macOS / WSL

```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

Puis ouvre un NOUVEAU terminal (PATH) et :

```bash
hermes --version
hermes doctor
hermes setup
hermes model
hermes chat -q "Reponds juste : Hermes OK"
```

Si `hermes` est introuvable apres install :

```bash
source ~/.bashrc 2>/dev/null || source ~/.zshrc 2>/dev/null
which hermes
```

### Desktop (option)

```bash
hermes desktop
# alias : hermes gui
```

### Windows

Preferer WSL2, puis la meme install shell. Les quirks natifs Windows existent
(chemins, permissions) : en cas de galere, WSL d'abord.

### Smoke test reussi = 4 cases

- [ ] `hermes --version` affiche une version
- [ ] `hermes doctor` ne crie pas une config cassee bloquante
- [ ] Un modele / provider est choisi (`hermes model` ou setup)
- [ ] `hermes chat -q "..."` renvoie une reponse

Ecris ca quelque part (template section 7).

---

## 3. Brancher un modele (sans te perdre)

Hermes est provider-agnostic (OpenRouter, Anthropic, OpenAI, Google, xAI,
DeepSeek, local, etc.).

Ordre conseille jour 0 :

1. `hermes setup` (assistant)
2. `hermes model` (choix modele + provider)
3. Une cle API dans `~/.hermes/.env` (SECRETS seulement)
4. Settings non secrets dans `~/.hermes/config.yaml` via `hermes config set ...`
   (ne pas editer le YAML a la main si tu debutes)

### Regle or secrets

| Fichier | Contenu |
|---------|---------|
| `~/.hermes/.env` | Cles API, tokens, secrets UNIQUEMENT |
| `~/.hermes/config.yaml` | Settings (modele par defaut, display...) PAS de secrets |

Ne commit jamais `.env`. Ne colle jamais une cle dans un tweet ou un ticket public.

### Si tu n'as pas encore de cle

- Commence par un provider ou tu as deja un compte
- Ou OpenRouter si tu veux tester plusieurs modeles vite
- Local (Ollama etc.) seulement si ta machine suit : sinon tu te bats contre le hardware jour 0

---

## 4. Securite jour 0 (non negociable)

Coche AVANT le premier cron / gateway large / boite mail branchee :

- [ ] Secrets uniquement dans `.env`, hors git
- [ ] Pas de compte banque / prod / admin clients
- [ ] Pas de suppression recursive "parce que l'agent a dit"
- [ ] Tu sais arreter une session (`/exit`, tuer le process, couper la cle)
- [ ] Moindre privilege : peu d'outils actives au debut
- [ ] Donnees perso / clients : hors perimetre ou anonymisees
- [ ] Approvals : ne mets pas tout en yolo tant que tu ne comprends pas les outils

Phrase Camille :

> Non. Trop tot pour automatiser ca.
> D'abord un run manuel reussi plusieurs fois.

### Ce que tu ignores volontairement le jour 0

- WhatsApp / Slack / Discord gateway
- 15 serveurs MCP
- Multi-agents et delegation
- Cron 24/7
- Envoi d'emails ou posts sans relecture
- Plugins desktop / themes (plus tard, fun)

---

## 5. Tes 10 premieres commandes utiles

```bash
hermes                  # chat interactif
hermes chat -q "..."    # une question one-shot
hermes setup            # assistant config
hermes model            # choisir modele
hermes doctor           # diagnostic
hermes status           # etat composants
hermes skills list      # skills installes
hermes config get       # lire un setting (voir --help)
hermes update           # maj (quand tu es stable)
hermes --help           # carte complete
```

En session interactive, les slash commands existent (`/exit`, etc.) :
tape `/` ou regarde l'aide in-session.

---

## 6. Plan 7 jours (usages reels, pas du theatre)

| Jour | Mission | Prompt de depart (adapte) | Critere "fait" |
|------|---------|---------------------------|----------------|
| 1 | Smoke + resume | "Resume ce texte en 5 puces actionnables : ..." | Resume utile en <10 min |
| 2 | Checklist | "Transforme ces notes de reunion en checklist avec priorite P1/P2/P3 : ..." | Next steps clairs |
| 3 | Brouillon pro | "Ecris un mail court, ton direct, FR, a partir de : ... Propose 2 versions." | Tu envoies apres 2 min d'edit |
| 4 | Debug leger | "Voici une erreur. Cause probable + 3 pistes de fix, sans reecrire tout le projet : ..." | Tu testes 1 fix |
| 5 | Fichiers | "Propose une arborescence pour ranger ces fichiers (liste). N'execute rien sans mon OK." | Plan de rangement valide |
| 6 | Veille bornee | "A partir de ces 3 extraits/liens, synthetise : faits / opinions / a ignorer." | 1 decision garder/ignorer |
| 7 | Retro | "A partir de mon journal de la semaine, donne 3 gains, 3 gaspillages, 1 automatisation possible SOUS supervision." | 3 bullets + 1 idee cron future |

### Regles de la semaine 1

- 1 usage utile / jour suffit
- Toujours preciser : langue, contraintes, "ne fais pas X"
- Si 5 jours sur 7 sont meh : le probleme est le cas d'usage, pas "il faut plus d'agents"

---

## 7. Templates a copier

### 7.1 Fiche install

```
Date :
OS :
hermes --version :
Provider / modele :
Doctor OK (oui/non) :
Premier prompt test :
Resultat :
Probleme rencontre :
```

### 7.2 Prompt universel (colle ca souvent)

```
Contexte : ...
Objectif : ...
Contraintes : FR, concret, pas de blabla, liste les incertitudes.
Interdit : inventer des commandes, toucher des secrets, supprimer des fichiers.
Format de reponse : 1) reponse courte 2) etapes 3) risques
```

### 7.3 Avant une action systeme

```
Avant d'executer quoi que ce soit :
1) dis-moi exactement ce que tu vas faire
2) quels fichiers/chemins
3) ce qui est reversible ou non
Attends mon OK explicite.
```

### 7.4 Journal de session (30 secondes)

```
But :
Outils utilises :
Utile / moyen / echec :
Cout approx (si connu) :
Limite :
Prochaine action humaine :
```

---

## 8. Controles de cout (sinon tu vas raler)

- Un modele "bon et previsible" > changer de modele tous les jours
- `chat -q` pour les taches courtes
- Evite browser / gros contextes en boucle le jour 1
- Note rough cost ou unites quand le provider l'affiche
- Plafond mental jour 0 : "je m'arrete si je debug la stack au lieu d'un usage metier"

---

## 9. Pieges classiques (et le fix)

| Symptome | Fix probable |
|----------|----------------|
| `hermes: command not found` | Nouveau shell, PATH, revoir install.sh |
| Auth / 401 provider | Cle dans `.env`, `hermes model`, `hermes doctor` |
| L'agent "invente" des commandes | Demande des preuves, refuse l'execution aveugle |
| Il veut tout automatiser | Rappel section 4, pas de cron |
| Config cassee apres edit YAML | Eviter l'edit manuel ; `hermes config set` |
| Trop lent / cher | Reduire outils, contexte, changer de modele raisonnable |
| Tu ne sais plus ce qui marche | Fiche install + journal section 7 |

---

## 10. Checklist "je suis pret pour la semaine 2"

- [ ] Smoke test OK documente
- [ ] 3 jours d'usages utiles realises
- [ ] Aucun secret expose
- [ ] Tu as dit NON a au moins une automation prematuree
- [ ] Tu as lu la doc officielle une fois sans survoler

Semaine 2 (pas avant) : UN flux recurrent (ex. veille du lundi) avec validation humaine a la fin. Ensuite seulement cron / gateway.

---

## 11. Ressources

- Doc : https://hermes-agent.nousresearch.com/docs
- Install script : https://hermes-agent.nousresearch.com/install.sh
- Site Agent Concret : https://agent-concret.fr/
- Guide : https://agent-concret.fr/guide.html
- FAQ : https://agent-concret.fr/faq.html
- Contact : camille@agent-concret.fr
- X : https://x.com/camille_cli

---

## 12. Licence d'usage de ce kit

Gratuit. Tu peux le partager en citant Agent Concret / camille_cli.
Pas une documentation officielle Nous Research.

— Camille