Retour au blog

Premiers pas avec Lumena : installation et configuration

Guide pas à pas pour installer Lumena, configurer les outils essentiels et exécuter vos premiers agents autonomes.

Tutoriel 12 avril 2026 10 min de lecture

Bienvenue dans le monde de Lumena ! Ce guide complet vous accompagnera à travers les étapes essentielles pour installer Lumena sur votre machine, configurer les outils nécessaires et exécuter vos tout premiers agents autonomes. Que vous soyez un développeur expérimenté ou un novice curieux, nous avons conçu ce tutoriel pour être clair et accessible.

1. Prérequis système

Avant de commencer, assurez-vous que votre système répond aux exigences minimales :

  • Système d'exploitation : Windows 10/11, macOS (Intel ou Apple Silicon), ou Linux (Ubuntu, Debian, Fedora).
  • Python : Version 3.9 ou supérieure. Nous recommandons la dernière version stable de Python.
  • Docker : Docker Desktop (pour Windows/macOS) ou Docker Engine (pour Linux) doit être installé et en cours d'exécution. Lumena utilise Docker pour isoler et gérer ses environnements d'exécution.
    • Interface de terminal avec des commandes d'installation de Lumena
    Terminal montrant les commandes d'installation de Lumena.
  • Stockage : Au moins 50 Go d'espace disque libre.

Vous pouvez vérifier votre version de Python en ouvrant un terminal et en tapant :

python --version

Pour Docker, assurez-vous que le démon Docker est bien démarré.

2. Installation de Lumena

2.1. Téléchargement

La manière la plus simple d'obtenir Lumena est de cloner le dépôt GitHub officiel. Ouvrez votre terminal et exécutez la commande suivante :

git clone https://github.com/losskarr/lumena.git
cd lumena

Si vous n'avez pas Git installé, vous pouvez télécharger l'archive ZIP du dépôt directement depuis la page GitHub et l'extraire manuellement.

2.2. Installation des dépendances Python

Une fois dans le répertoire Lumena, installez les dépendances Python requises :

pip install -r requirements.txt

Si vous utilisez un environnement virtuel (recommandé), activez-le d'abord. Cette commande installera toutes les bibliothèques nécessaires, y compris les bibliothèques d'IA, les connecteurs d'API, etc.

2.3. Configuration des clés API

Lumena a besoin de certaines clés API pour fonctionner pleinement. Créez un fichier .env à la racine du projet et ajoutez-y les clés suivantes :

OPENAI_API_KEY=votre_clé_openai
ANTHROPIC_API_KEY=votre_clé_anthropic
GEMINI_API_KEY=votre_clé_gemini
TELEGRAM_BOT_TOKEN=votre_token_bot_telegram

Consultez notre documentation pour obtenir des guides détaillés sur la façon d'obtenir ces clés.

3. Premier lancement

Une fois les dépendances installées et les clés API configurées, vous pouvez lancer Lumena pour la première fois :

python lumena_ultime.py

L'interface en ligne de commande (CLI) devrait apparaître. Suivez les instructions à l'écran pour configurer votre premier agent autonome.

4. Configuration avancée (optionnel)

Pour les utilisateurs avancés, Lumena offre plusieurs options de configuration :

  • Mémoire persistante : Configurez une base de données SQLite ou PostgreSQL pour stocker les souvenirs de l'agent.
  • Plugins personnalisés : Ajoutez vos propres plugins pour étendre les capacités de Lumena.
  • Interface web : Lancez l'interface web intégrée pour une interaction plus visuelle.

5. Dépannage

Si vous rencontrez des problèmes, consultez notre documentation ou ouvrez une issue sur GitHub.