Menu

Utiliser Nous Portal avec Hermes Agent

Utiliser Nous Portal avec Hermes Agent

Cette page fait partie du guide pratique francophone consacré à Hermes Agent. Elle répond à l'intention de recherche : configurer Nous Portal.

Le contenu s'appuie sur la documentation officielle Hermes Agent associée à cette page. L'objectif n'est pas de remplacer la documentation de Nous Research, mais de fournir une lecture claire en français, structurée pour aller vite, avec un maillage logique vers les pages complémentaires du même site.

À retenir

  • Sujet principal : hermes agent nous portal.
  • Type de page : spoke.
  • Cluster : providers.
  • Source canonique : documentation officielle Hermes Agent.
  • Aucun lien vers l'autre domaine n'est utilisé dans cette page.

Quand utiliser cette page

Utilisez cette page quand vous voulez configurer Nous Portal. Elle part du principe que Hermes Agent est déjà identifié comme l'outil à mettre en place ou à comprendre, puis détaille les points importants issus de la documentation officielle.

Si vous découvrez seulement l'outil, revenez d'abord au hub parent puis suivez les liens internes proposés en fin de page.

Base officielle

This page covers setting up inference providers for Hermes Agent — from cloud APIs like OpenRouter and Anthropic, to self-hosted endpoints like Ollama and vLLM, to advanced routing and fallback configurations. You need at least one provider configured to use Hermes.

Inference Providers

You need at least one way to connect to an LLM. Use hermes model to switch providers and models interactively, or configure directly:

  • Provider — Setup
  • Nous Portal — hermes model (OAuth, subscription-based)
  • OpenAI Codex — hermes model (ChatGPT OAuth, uses Codex models)
  • GitHub Copilot — hermes model (OAuth device code flow, COPILOT_GITHUB_TOKEN, GH_TOKEN, or gh auth token)
  • GitHub Copilot ACP — hermes model (spawns local copilot --acp --stdio)
  • Anthropic — hermes model (Claude Max + extra usage credits via OAuth; also supports Anthropic API key or manual setup-token — see note below)
  • OpenRouter — OPENROUTER_API_KEY in ~/.hermes/.env
  • NovitaAI — NOVITA_API_KEY in ~/.hermes/.env (provider: novita, 200+ models, Model API, Agent Sandbox, GPU Cloud)
  • z.ai / GLM — GLM_API_KEY in ~/.hermes/.env (provider: zai)
  • Kimi / Moonshot — KIMI_API_KEY in ~/.hermes/.env (provider: kimi-coding)
  • Kimi / Moonshot (China) — KIMI_CN_API_KEY in ~/.hermes/.env (provider: kimi-coding-cn; aliases: kimi-cn, moonshot-cn)
  • Arcee AI — ARCEEAI_API_KEY in ~/.hermes/.env (provider: arcee; aliases: arcee-ai, arceeai)
  • GMI Cloud — GMI_API_KEY in ~/.hermes/.env (provider: gmi; aliases: gmi-cloud, gmicloud)
  • MiniMax — MINIMAX_API_KEY in ~/.hermes/.env (provider: minimax)
  • MiniMax China — MINIMAX_CN_API_KEY in ~/.hermes/.env (provider: minimax-cn)
  • xAI (Grok) — Responses API — XAI_API_KEY in ~/.hermes/.env (provider: xai)
  • xAI Grok OAuth (SuperGrok) — hermes model → "xAI Grok OAuth (SuperGrok / Premium+)" — browser login, no API key. See guide
  • Qwen Cloud (Alibaba DashScope) — DASHSCOPE_API_KEY in ~/.hermes/.env (provider: alibaba)
  • Alibaba Cloud (Coding Plan) — DASHSCOPE_API_KEY (provider: alibaba-coding-plan, alias: alibaba_coding) — separate billing SKU, different endpoint
  • Kilo Code — KILOCODE_API_KEY in ~/.hermes/.env (provider: kilocode)
  • Xiaomi MiMo — XIAOMI_API_KEY in ~/.hermes/.env (provider: xiaomi, aliases: mimo, xiaomi-mimo)
  • Tencent TokenHub — TOKENHUB_API_KEY in ~/.hermes/.env (provider: tencent-tokenhub, aliases: tencent, tokenhub, tencentmaas)
  • OpenCode Zen — OPENCODE_ZEN_API_KEY in ~/.hermes/.env (provider: opencode-zen)
  • OpenCode Go — OPENCODE_GO_API_KEY in ~/.hermes/.env (provider: opencode-go)
  • DeepSeek — DEEPSEEK_API_KEY in ~/.hermes/.env (provider: deepseek)
  • Hugging Face — HF_TOKEN in ~/.hermes/.env (provider: huggingface, aliases: hf)
  • Google / Gemini — GOOGLE_API_KEY (or GEMINI_API_KEY) in ~/.hermes/.env (provider: gemini)
  • Google Vertex AI — hermes model → "Google Vertex AI" (provider: vertex; OAuth2 via service-account JSON or ADC, GCP billing)
  • OpenAI API (direct) — OPENAI_API_KEY in ~/.hermes/.env (provider: openai-api, optional OPENAI_BASE_URL)
  • Azure AI Foundry — hermes model → "Azure AI Foundry" (provider: azure-foundry; uses Azure OpenAI / Foundry endpoint and key)
  • AWS Bedrock — hermes model → "AWS Bedrock" (provider: bedrock; standard AWS credentials chain via boto3)
  • NVIDIA Build — NVIDIA_API_KEY in ~/.hermes/.env (provider: nvidia; NIM-hosted models on build.nvidia.com)
  • Ollama Cloud — hermes model → "Ollama Cloud" (provider: ollama-cloud; cloud-hosted Ollama API)
  • Qwen OAuth — hermes model → "Qwen OAuth" (provider: qwen-oauth; browser PKCE login)
  • MiniMax OAuth — hermes model → "MiniMax (OAuth)" (provider: minimax-oauth; browser PKCE login)
  • StepFun — STEPFUN_API_KEY in ~/.hermes/.env (provider: stepfun)
  • LM Studio — hermes model → "LM Studio" (provider: lmstudio, optional LM_API_KEY)
  • Custom Endpoint — hermes model → choose "Custom endpoint" (saved in config.yaml)

For the official API-key path, see the dedicated Google Gemini guide.

In the model: config section, you can use either default: or model: as the key name for your model ID. Both model: { default: my-model } and model: { model: my-model } work identically.

Nous Portal

Nous Portal is Nous Research's unified subscription gateway and the recommended way to run Hermes Agent. One OAuth login covers 300+ frontier agentic models (Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok, ...) plus the Tool Gateway (web search, image generation, TTS, browser automation) plus Nous Chat — billed against your Nous subscription instead of separate per-provider accounts.

hermes setup --portal     # fresh install — OAuth + provider + gateway in one command
hermes model              # existing install — pick "Nous Portal" from the list
hermes portal info        # inspect login + routing at any time

Don't have a subscription yet? Get one at portal.nousresearch.com/manage-subscription.

For full details: see the dedicated Nous Portal integration page (what's in the subscription, model catalog, troubleshooting) and the step-by-step Run Hermes Agent with Nous Portal guide.

Client identification. Every Portal request from Hermes Agent carries a client=hermes-client-v<version> tag (e.g. client=hermes-client-v0.13.0) auto-aligned to your installed release. This is sent on all Portal pathways — main chat loop, auxiliary calls, compression summarizer, web extraction — and lets Portal-side telemetry distinguish Hermes traffic from other clients. No config required; the tag updates automatically when you hermes update.

JWT auth (automatic). Hermes prefers scoped inference:invoke JWTs for Portal requests with the legacy opaque session-key path as a fallback. No configuration is required — credentials are managed by the OAuth flow and rotate transparently. Revoked refresh tokens are quarantined to avoid replay loops.

The OpenAI Codex provider authenticates via device code (open a URL, enter a code). Hermes stores the resulting credentials in its own auth store under ~/.hermes/auth.json and can import existing Codex CLI credentials from ~/.codex/auth.json when present. No Codex CLI installation is required.

If a token refresh fails with a terminal error (HTTP 4xx, invalid_grant, revoked grant, etc.), Hermes marks the refresh token as dead and stops replaying it so you don't see a flood of identical auth failures. The next request surfaces a typed re-auth message instead. Run hermes auth add codex-oauth (or hermes model → OpenAI Codex) to start a fresh device-code login; the quarantine clears on the next successful exchange.

Even when using Nous Portal, Codex, or a custom endpoint, some tools (vision, web summarization, MoA) use a separate "auxiliary" model. By default (auxiliary.*.provider: "auto"), Hermes routes these tasks to your main chat model — the same model you picked in hermes model. You can override each task individually to route it to a cheaper/faster model (e.g. Gemini Flash on OpenRouter) — see Auxiliary Models.

Paid Nous Portal subscribers also get access to the Tool Gateway — web search, image generation, TTS, and browser automation routed through your subscription. No extra API keys needed. On a fresh install, hermes setup --portal logs you in, sets Nous as your provider, and turns the gateway on in one command. Existing users can enable it from hermes model or per-tool from hermes tools. Inspect routing at any time with hermes portal info.

Two Commands for Model Management

Hermes has two model commands that serve different purposes:

  • Command — Where to run — What it does
  • hermes model — Your terminal (outside any session) — Full setup wizard — add providers, run OAuth, enter API keys, configure endpoints
  • /model — Inside a Hermes chat session — Quick switch between already-configured providers and models

If you're trying to switch to a provider you haven't set up yet (e.g. you only have OpenRouter configured and want to use Anthropic), you need hermes model, not /model. Exit your session first (Ctrl+C or /quit), run hermes model, complete the provider setup, then start a new session.

Anthropic (Native)

Use Claude models directly through the Anthropic API — no O

Points de vigilance

  • Vérifiez toujours la version active de Hermes Agent avant d'appliquer une commande ou une configuration.
  • Ne collez pas de clé API dans un chat public ou dans une page visible.
  • Gardez les secrets dans les fichiers ou gestionnaires prévus pour cela.
  • Si une fonctionnalité dépend d'un provider, d'un plugin ou d'une plateforme de messagerie, vérifiez que le composant est bien activé dans votre profil.
  • Pour une installation de production, testez d'abord le flux complet sur une machine ou un profil isolé.

Exemple de parcours logique

  1. Lire la page courante pour comprendre hermes agent nous portal.
  2. Ouvrir le hub parent du cluster providers.
  3. Passer ensuite aux pages complémentaires proposées dans « À lire ensuite ».
  4. Revenir à la documentation officielle si vous avez besoin du détail exact ou d'une commande récemment modifiée.

FAQ rapide

Cette page remplace-t-elle la documentation officielle ?

Non. Elle sert de guide francophone structuré. Le lien vers la source officielle est disponible en bas de page.

Les commandes sont-elles garanties à jour ?

Elles sont basées sur la documentation officielle récupérée au moment de la génération. Pour un usage critique, vérifiez toujours la page officielle liée en bas.

Pourquoi autant de liens internes ?

Hermes Agent est un système modulaire. L'installation, les providers, les outils, la mémoire, les skills, la sécurité et les plateformes se répondent. Le maillage interne aide à suivre ce chemin sans tomber sur des pages orphelines.

À lire ensuite