Recherche Web Hermes sans clé API : 5 canaux gratuits + rotation round-robin zéro configuration, expliquée pas à pas


Vous avez déjà vécu ça : vous voulez que votre IA recherche une information en temps réel, et elle commence par vous faire créer un compte d’API de recherche, demander un quota gratuit puis coller une clé API dans un fichier de configuration — une demi-heure plus tard, la recherche n’a toujours pas eu lieu. Il y a deux jours (le 20 août), Hermes a rendu tout cela « fonctionnel dès l’installation » : une installation neuve effectue des recherches web sans aucune configuration, et cinq canaux gratuits sont disponibles au choix. Cet article passe en revue chacun d’eux et explique comment choisir.

L’essentiel : le keyless ring — une rotation automatique zéro configuration

Autrefois, une instance Hermes sans identifiants devait s’appuyer sur ddgs ou sur une instance SearXNG auto-hébergée. Le commit fusionné dans main le 20 août (4ea69d9d2) a fait évoluer le « niveau sans clé » vers un anneau round-robin à 5 fournisseurs :

exa → parallel → tavily → firecrawl → keenable

Comment ça marche : une instance Hermes neuve, sans identifiants web, parcourt cet ordre en alternant entre les niveaux gratuits des cinq fournisseurs (round-robin, un fournisseur par requête, départ initialisé par un identifiant aléatoire par processus) ; lorsque le fournisseur courant atteint sa limite de débit ou échoue, on bascule sur le suivant. Autrement dit — vous ne vous inscrivez nulle part, et web.keyless_fallback (activé par défaut) rend la recherche web immédiatement fonctionnelle.

Si vous avez configuré un backend avec clé et qu’il échoue, le compagnon web.keyless_rescue (également activé par défaut) récupère cette requête sur le keyless ring — jamais sticky (voir l’astuce 4 dans 4 astuces Hermes cachées).

Les cinq canaux gratuits, un par un

Canal 1 : Keenable — zéro clé, et il fait la recherche ET l’extraction

Le nouveau backend le plus intéressant de cette expansion de l’anneau (https://keenable.ai, un index web indépendant pour les applications IA) :

# Rien à configurer — il suffit de le désigner :
hermes config set web.backend keenable

# Optionnel : ajouter une clé pour des limites plus élevées
hermes config set env.KEENABLE_API_KEY "votre-clé"
  • Zéro clé : point d’accès public sans clé ; il n’envoie qu’un en-tête identifiant l’application (X-Keenable-Title: hermes-agent), aucun identifiant utilisateur
  • Prend en charge la recherche ET l’extraction (supports_extract() renvoie True) — la plupart des backends gratuits ne font que la recherche ; celui-ci peut aussi servir de backend web_extract
  • Le niveau gratuit est limité en débit ; KEENABLE_API_KEY relève les limites ; web.provider_tier.keenable: free|paid fige le niveau

Canal 2 : ddgs (DuckDuckGo) — zéro clé, le plus rapide à démarrer

hermes config set web.backend ddgs
# Première utilisation : hermes tools → choisir DuckDuckGo → pip install ddgs automatique
  • Zéro clé API ; récupère les résultats de DuckDuckGo
  • Recherche uniquement (pas d’extraction) ; DuckDuckGo impose des limites de débit côté serveur — un timeout signifie simplement « réessayez plus tard »

Canal 3 : SearXNG — zéro clé, meilleure confidentialité, couverture la plus large

docker run -d --name searxng -p 127.0.0.1:8080:8080 \
  -e BASE_URL=http://localhost:8080 --restart unless-stopped searxng/searxng
hermes config set env.SEARXNG_URL http://localhost:8080
hermes config set web.backend searxng
  • Méta-recherche auto-hébergée qui agrège Google, Bing, Brave, Wikipédia et plus de 70 sources — meilleure confidentialité (les requêtes passent par votre propre instance)
  • Recherche uniquement ; certains moteurs peuvent bloquer l’adresse IP de votre SearXNG — configurez des moteurs de repli

Canal 4 : Brave Search Free Tier — clé gratuite, haute qualité

hermes config set env.BRAVE_SEARCH_API_KEY "votre-clé"   # demande gratuite sur brave.com/search/api
hermes config set web.backend brave-free
  • Niveau gratuit : 2 000 requêtes/mois, 1 QPS ; résultats de haute qualité, peu de maintenance
  • Recherche uniquement ; plafonné à 20 résultats par appel

Canal 5 : xAI — réutilisez les identifiants Grok que vous possédez déjà, recherche côté serveur

hermes auth   # si vous êtes déjà connecté avec Grok OAuth, c'est terminé
hermes config set web.backend xai
  • Achemine via l’outil agentic Web Search de xAI : c’est Grok qui effectue la recherche et la navigation sur les pages côté serveur, et renvoie les meilleurs résultats sous forme de JSON structuré
  • L’authentification réutilise le Grok OAuth géré par Hermes (hermes auth), avec repli sur XAI_API_KEYaucune clé de recherche distincte à demander
  • Réglages optionnels : web.xai.model (par défaut grok-build-0.1), allowed_domains/excluded_domains (5 chacun au maximum), timeout (90 s par défaut)

Aide-mémoire de configuration

Canal Clé requise Recherche Extraction En une ligne
keyless ring (exa/parallel/tavily/firecrawl/keenable) Aucune ✓ (certains) Zéro configuration, fonctionne dès l’installation
Keenable Aucune (amélioration optionnelle) Nouveau backend, couteau suisse recherche + extraction
ddgs Aucune Le plus rapide à démarrer
SearXNG Aucune Meilleure confidentialité, couverture la plus large
Brave Free Clé gratuite Haute qualité, peu de maintenance
xAI Réutilise Grok Recherche côté serveur, aucune nouvelle clé

Les clés de configuration en un coup d’œil : web.backend (repli partagé), web.search_backend (recherche uniquement), web.extract_backend (extraction uniquement) — chacune peut pointer vers un backend différent.

Statut de la version

Élément Statut
Rotation keyless ring à 5 fournisseurs (4ea69d9d2) main (fusionné le 20 août), non publié — la dernière version officielle reste la v0.20.4
Plugins Keenable / xAI plugins intégrés, livrés avec les versions (xAI depuis mai ; Keenable avec l’expansion de l’anneau)
Essayez dès maintenant hermes update --branch main ou attendez la prochaine version

Pour conclure

De « trois options gratuites à configurer soi-même » à « cinq canaux gratuits plus une rotation zéro configuration », la recherche web de Hermes a franchi un grand pas le 20 août : une installation neuve recherche dès le premier lancement, et les utilisateurs existants peuvent passer à la version supérieure instantanément en pointant web.backend vers keenable ou xai. Vous voulez zéro contrainte — ne configurez rien (keyless ring) ; de la confidentialité — SearXNG ; de la commodité — Keenable ; de la qualité — Brave Free ; un compte Grok — essayez xAI. L’analyse approfondie des trois options précédentes se trouve dans Skill de recherche gratuite sans clé API, et les notes de la dernière version dans v0.20.4.