Mammouth pour n8n

Découvrir Mammouth AI

Node communautaire d'actions Chat / Image / Text pour une API compatible avec le protocole
OpenAI. Ce n'est pas un sous-node Chat Model pour AI Agent.

Open Source : https://github.com/mammouth-ai/n8n-integration

Installation du package publié

Le package npm est disponible sous le nom
n8n-nodes-mammouth.

Sur une instance n8n auto-hébergée autorisant les nodes communautaires :

1. Ouvrir Settings → Community Nodes → Install.
2. Saisir n8n-nodes-mammouth et confirmer l'installation.
3. Créer les credentials Mammouth API décrits ci-dessous.
4. Ajouter le node Mammouth à un workflow.

La compilation depuis les sources ci-dessous est une alternative pour le
développement ou le chargement comme extension personnalisée.

Compilation et vérification

Node.js 24 ou supérieur et npm sont nécessaires (une dépendance du SDK n8n
exige Node.js 24). Respecter également la version
Node.js requise par votre installation n8n. Le paquet est compilé et testé avec
n8n-workflow 2.42.1 ; la compatibilité avec votre version exacte de n8n reste
à vérifier sur votre instance.

Les exemples supposent que le projet se trouve dans $HOME/n8n-integration.
$HOME désigne le répertoire personnel de l'utilisateur courant ; adapter le
chemin à l'emplacement de votre copie du projet.

cd "$HOME/n8n-integration"
npm ci
npm test

La compilation produit $HOME/n8n-integration/dist,
avec le node, ses credentials, ses icônes et ses métadonnées.

Chargement dans n8n installé avec npm / Node.js

Sur la machine qui exécute n8n, après compilation, définir le répertoire
d'extensions personnalisées au démarrage :

export N8N_CUSTOM_EXTENSIONS="$HOME/n8n-integration/dist"
n8n start

Arrêter préalablement l'instance existante : ne pas lancer un deuxième processus
sur le même port. Si n8n est géré par systemd ou PM2, ajouter cette variable à
la configuration de ce service, puis le redémarrer avec son gestionnaire.
Un simple export dans un terminal ne modifie pas l'environnement d'un service.

• Exécuter n8n avec son utilisateur habituel pour conserver ses données.
• Le chemin ci-dessus est un exemple : l'adapter si n8n tourne ailleurs.
• Dans la configuration d'un service, utiliser le chemin absolu réel si $HOME
  n'est pas développé par le gestionnaire de services.
• Conserver les dépendances installées dans ce projet et rendre le projet lisible
  par l'utilisateur du service n8n.
• Si N8N_CUSTOM_EXTENSIONS contient déjà des chemins, ajouter ce répertoire en
  les séparant par ;, sans supprimer les extensions existantes.
• Recompiler puis redémarrer n8n après chaque modification.
• Recharger l'interface et chercher Mammouth dans le sélecteur de nodes.

Le chargement comme extension personnalisée ne nécessite pas de publication npm.
npm pack produit aussi une archive installable pour un déploiement en paquet
communautaire. Ne pas charger simultanément le même node comme extension
personnalisée et comme paquet communautaire ; leurs identifiants de workflow
diffèrent (CUSTOM.mammouth et n8n-nodes-mammouth.mammouth).

Configuration de l'API

Créer des credentials Mammouth API et renseigner :

• API Base URL : URL complète de la base API, avec /v1 si votre serveur
  l'exige. Par exemple, https://api.example.com/v1 est un exemple fictif, pas
  l'adresse de votre entreprise. Un préfixe tel que /proxy/v1 est conservé.
• API Key : clé envoyée dans Authorization: Bearer ….

Aucune URL d'API n'est préremplie et aucun repli vers OpenAI n'est effectué.
Utiliser HTTPS hors tests locaux. Le bouton de test des credentials appelle
GET /models ; il exige que cet endpoint soit disponible et autorisé.

Pour un premier essai : sélectionner Chat → Complete, choisir un modèle,
ajouter un message de rôle User, puis exécuter le node.

Endpoints et limites

Les chemins suivants sont ajoutés à l'URL de base :

La liste des modèles attend { "data": [{ "id": "identifiant-du-modele" }] }.
Elle n'applique aucun filtre de marque : choisir un modèle compatible avec
l'opération. L'édition et la modération demandent un identifiant saisi manuellement.

Les opérations et options sont héritées du node d'origine. Une compatibilité
Chat Completions ne garantit pas les endpoints historiques d'édition, de texte,
de modération, ni les paramètres image. Les options spécifiques DALL-E restent
conditionnées à ces modèles. Seules les fonctions effectivement exposées par
votre API pourront fonctionner ; aucun support supplémentaire n'est présumé.

Les tests vérifient la compilation, les exports, les assets, les expressions n8n,
l'authentification, les modèles et les erreurs HTTP. Un serveur HTTP local simule
les endpoints modèles et chat à partir de la configuration du node ; ce test
ne remplace pas une exécution du moteur de routage n8n ni un appel à votre API.

Licence et marques

Le package déclare la licence MIT. Vérifier également les obligations de licence
et d'attribution du code amont avant toute redistribution.

Le nom et le logo Mammouth appartiennent à leurs titulaires respectifs. Le lien
vers le site officiel ne constitue pas une certification de cette intégration.