Aller au contenu principal

Installation de Chatbotaurus

Ce guide couvre l'installation complete de Chatbotaurus en mode developpement local.

Pre-requis​

OutilVersionInstallation
Node.js20.18.0nvm recommande
pnpm9.xnpm install -g pnpm
Git2.x+git-scm.com
Podman4.x+Podman Desktop recommande

Installation Rapide​

1. Cloner le repository​

git clone https://git.staging.chatbotaurus.eu/chatbotaurus-admin/chatbotaurus-mcp.git
cd chatbotaurus-mcp

2. Installer les dependances​

pnpm install

3. Configurer l'environnement​

cp .env.example packages/server/.env

Editez packages/server/.env avec vos parametres. Les variables essentielles :

NODE_ENV=development
PORT=3000
JWT_SECRET=votre_secret_jwt_minimum_32_caracteres

# Base de donnees
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_NAME=chatbotaurus

# Cache
REDIS_HOST=localhost
REDIS_PORT=6379

# Vecteurs
QDRANT_URL=http://localhost:6333

# Secrets
VAULT_ADDR=http://localhost:8200

# LLM (Ollama local)
OLLAMA_URL=http://localhost:11434

# SSO
KEYCLOAK_URL=http://localhost:8180

4. Initialiser la base de donnees​

cd packages/server
node reset-db.js

Lancement en Developpement​

Backend (port 3000)​

cd packages/server
pnpm build
node start-direct.js

Sur Windows avec nvm :

$env:PATH = "$env:APPDATA\nvm\v20.18.0;$env:PATH"
$env:CORS_ORIGINS = "*"
cd packages/server
pnpm build
node start-direct.js

Frontend (port 3001)​

cd packages/new-ui
pnpm dev --port 3001

Ouvrez http://localhost:3001 dans votre navigateur.

Infrastructure Podman (Optionnel)​

Pour lancer l'infrastructure EU complete avec tous les services :

# Creer les reseaux
podman network create --subnet 172.28.0.0/16 chatbotaurus-network
podman network create --subnet 172.29.0.0/16 mgaas-network

# Deployer les services core (PostgreSQL, Qdrant, Valkey, Ollama, Keycloak, Vault, etc.)
podman kube play --network chatbotaurus-network kubernetes/podman-local/00-core-pods.yaml

# Deployer les services MGaaS (Odoo, n8n, Matomo, etc.)
podman kube play --network mgaas-network kubernetes/podman-local/01-mgaas-pods.yaml

# Verifier les pods
podman pod ps

Modeles Ollama​

Apres le demarrage d'Ollama, telecharger les modeles :

podman exec chatbotaurus-ollama ollama pull qwen3:8b
podman exec chatbotaurus-ollama ollama pull tomng/nanbeige4.1:3b
podman exec chatbotaurus-ollama ollama pull qwen3-embedding:0.6b

Verification​

Verifiez que tout fonctionne :

# Health check backend
curl http://localhost:3000/healthz

# Catalogue MCP
curl http://localhost:3000/api/v1/mcp/catalog

# Tests
pnpm test

Prochaines Etapes​