front-dev/INSTALLATION.md

QognyX Installation - Environnement de Développement

Installation réalisée

✅ Node.js 20.20.0 installé ✅ npm 10.8.2 installé ✅ MongoDB 7.0.28 installé et démarré ✅ QognyX sources téléchargées et configurées ✅ Dépendances npm installées

Configuration

API Personnalisée

L'environnement est configuré pour utiliser votre API personnalisée :

• URL: https://cpu.lsbuchet.com/v1
• Format: Compatible OpenAI

Fichiers de configuration

• .env : Variables d'environnement
• librechat.yaml : Configuration de l'endpoint personnalisé

Base de données

MongoDB est configuré localement sur mongodb://127.0.0.1:27017/QognyX

Utilisation

Avant de démarrer

1. Éditer /opt/front-dev/.env et remplacer your_api_key_here par votre vraie clé API:

   nano /opt/front-dev/.env
   # Chercher CPU_API_KEY= et remplacer la valeur
   

Démarrer l'environnement de développement

cd /opt/front-dev
./start-dev.sh

ou

cd /opt/front-dev
npm run dev

L'application sera accessible sur: http://localhost:3080

Build pour la production

cd /opt/front-dev
./build-prod.sh

Démarrer en production

cd /opt/front-dev
npm run start

Commandes utiles

Vérifier le statut de MongoDB

systemctl status mongod

Arrêter MongoDB

systemctl stop mongod

Démarrer MongoDB

systemctl start mongod

Mettre à jour les sources

cd /opt/front-dev
curl -L https://github.com/danny-avila/QognyX/archive/refs/heads/main.tar.gz -o update.tar.gz
tar -xzf update.tar.gz --strip-components=1
rm update.tar.gz
npm ci

Installer de nouvelles dépendances

cd /opt/front-dev
npm install <package-name>

Développement

Structure du projet

• api/ : Code backend (Node.js/Express)
• client/ : Code frontend (React)
• packages/ : Packages partagés
• config/ : Fichiers de configuration

Variables d'environnement importantes

• CPU_API_KEY : Clé API pour cpu.lsbuchet.com
• MONGO_URI : URI de connexion MongoDB
• PORT : Port du serveur (défaut: 3080)
• DEBUG_LOGGING : Active les logs de debug

Logs et Debugging

Voir les logs MongoDB

tail -f /var/log/mongodb/mongod.log

Activer le mode debug

Dans .env, définir:

DEBUG_LOGGING=true
DEBUG_CONSOLE=true

Production vs Développement

Environnement de développement

• Hot-reload activé
• Logs verbeux
• Pas de minification

Environnement de production

• Build optimisé
• Minification
• Meilleure performance

Servir plusieurs instances

Vous pouvez configurer différentes instances sur différents ports:

• Développement: Port 3080
• Production: Port 3081 (par exemple)

Modifier PORT= dans .env pour changer le port.

Support

Pour plus d'informations sur QognyX:

• Documentation: https://www.librechat.ai/docs
• GitHub: https://github.com/danny-avila/QognyX

Prochaines étapes

1. ✏️ Éditer .env pour ajouter votre clé API
2. 🚀 Démarrer l'environnement de dev: ./start-dev.sh
3. 🌐 Ouvrir http://localhost:3080
4. 📝 Créer un compte utilisateur
5. 💬 Tester l'API personnalisée