Hermes Agent | Documentation d'Inférence Nordique

Utilisez Inférence Nordique comme moteur d'arrière-plan de Hermes Agent sur des routes canadiennes souveraines exactes, avec registres de possession, pour les équipes gouvernementales, de défense et réglementées.

Inférence Nordique est une API d'IA souveraine canadienne pour les équipes du gouvernement, de la défense, de la santé et des secteurs réglementés, y compris les organisations relevant du Programme des marchandises contrôlées. Chaque route comporte une résidence des données au Canada conforme à la LPRPDE, un chemin exact vers les derniers modèles de pointe et à poids ouverts, ainsi qu'un registre de chaîne de possession par requête.

Avant de commencer

Créez une clé API. Dans le portail, ouvrez Clés API et cliquez sur Créer la clé. Votre clé commence par ni_live_.
Ajoutez des crédits. Les nouveaux comptes démarrent avec un solde de 0 $, et chaque requête est refusée tant que vous n'ajoutez pas de crédits. Ouvrez Facturation et cliquez sur Acheter des crédits.
Choisissez un modèle. Les noms de modèles d'Inférence Nordique se terminent par une étiquette de niveau, par exemple claude-sonnet-4-6-t4. Vous les trouverez tous sur la page Modèles.

Installer Hermes Agent

Mac, Linux et WSL2 :

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

Windows PowerShell :

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Des applications de bureau pour Mac et Windows sont aussi offertes sur le site de Hermes Agent. Le code source est sur GitHub.

Connecter Hermes à Inférence Nordique

Lancez la configuration du modèle :

hermes model

Choisissez Custom endpoint (self-hosted / VLLM / etc.) et saisissez :

Paramètre	Valeur
URL	`https://northerninference.ca/v1`
Clé API	votre clé `ni_live_`
Modèle	`claude-sonnet-4-6-t4`

Hermes l'enregistre au bon endroit selon votre système d'exploitation. Démarrez Hermes et envoyez un message. Il apparaît dans le portail sous Utilisation en quelques secondes.

Ou modifier le fichier de configuration

La configuration écrit ce bloc dans config.yaml, dans votre dossier Hermes : ~/.hermes/config.yaml sur Mac et Linux, et %LOCALAPPDATA%\hermes\config.yaml sous Windows. Vous pouvez aussi l'écrire vous-même. Si le fichier contient déjà un bloc model:, remplacez-le par celui-ci.

model:
  default: claude-sonnet-4-6-t4
  provider: custom
  base_url: https://northerninference.ca/v1
  api_key: ni_live_YOUR_KEY_HERE

Bons modèles pour commencer

Modèle	Notes
`claude-sonnet-4-6-t4`	Un bon choix général
`mistral-large-2402-t3`	Fonctionne au Canada (Niveau 3)

Utilisez le nom exact indiqué sur la page Modèles, y compris la casse.

Si un nom de modèle n'est pas reconnu

Inférence Nordique répond par un HTTP 404 et Model 'X' is not a route this key can call. Elle ne remplace jamais le modèle par un autre. Utilisez un nom de la page Modèles, ou tapez ni-models comme message pour lister les modèles que votre clé peut appeler. Si le nom est celui d'un modèle que votre clé peut appeler, sans son étiquette de niveau, comme claude-sonnet-4-6, la réponse demande aussi Did you mean claude-sonnet-4-6-t4?. Si le nom désigne le même modèle sur plus d'une route que votre clé peut appeler, la réponse est un HTTP 400 ambiguous_model_route qui nomme chaque route ; utilisez l'une d'elles.

Dépannage

Ce que vous voyez	Ce qu'il faut faire
401 ou "Invalid API key"	Vérifiez que la clé commence par `ni_live_` et ne contient pas d'espaces superflus. Au besoin, créez-en une nouvelle dans le portail sous Clés API.
402 `Insufficient credits. Add credits in the portal under Billing (https://northerninference.ca/portal/?page=billing) to continue.`	Ajoutez des crédits dans le portail, sous Facturation.
404 `Model 'X' is not a route this key can call.`	Utilisez un nom de la page Modèles, ou tapez `ni-models`.
Les requêtes n'apparaissent pas dans Utilisation	Hermes utilise un autre fournisseur. Relancez `hermes model` et choisissez le point de terminaison personnalisé, ou vérifiez que `provider` est `custom` et que `base_url` est exactement `https://northerninference.ca/v1`.

Limites de dépense

Pour plafonner les dépenses d'un projet, créez une clé distincte dans le portail sous Clés API avec une limite de Dépense maximale par jour, et utilisez cette clé dans Hermes.