Démarrage rapide¶
Lancez Merlya en 5 minutes.
1. Premier lancement - Assistant de configuration¶
Au premier lancement, l'assistant de configuration de Merlya vous guide :
Sélection de la langue¶
╭─────────────────────────────────────────────────────────────────╮
│ Merlya Setup │
├─────────────────────────────────────────────────────────────────┤
│ Welcome to Merlya! / Bienvenue dans Merlya! │
│ │
│ Select your language / Choisissez votre langue: │
│ 1. English │
│ 2. Français │
╰─────────────────────────────────────────────────────────────────╯
Sélection du fournisseur LLM¶
╭───────────────────────────────────────────────────────────────────╮
│ Configuration LLM │
├───────────────────────────────────────────────────────────────────┤
│ 1. OpenRouter (recommandé - multi-modèles) │
│ 2. Anthropic (Claude direct) │
│ 3. OpenAI (modèles GPT) │
│ 4. Mistral (Mistral AI) │
│ 5. Groq (inférence rapide) │
│ 6. Ollama (modèles locaux) │
╰───────────────────────────────────────────────────────────────────╯
Sélectionner le provider [1]:
OpenRouter recommandé
OpenRouter offre des modèles gratuits et l'accès à plus de 100 LLMs. Obtenez votre clé API sur openrouter.ai/keys
Découverte des hôtes¶
L'assistant détecte automatiquement les hôtes depuis :
~/.ssh/config- Configuration SSH~/.ssh/known_hosts- Hôtes précédemment connectés/etc/hosts- Définitions d'hôtes locaux- Fichiers d'inventaire Ansible
Sources d'inventaire détectées :
• SSH Config: 12 hôtes
• Known Hosts: 45 hôtes
Importer tous les hôtes ? [O/n]:
2. Configuration manuelle (alternative)¶
Si vous sautez l'assistant ou voulez modifier les paramètres plus tard :
3. Démarrer le REPL¶
Utilisez /help pour lister les commandes disponibles, et /exit pour quitter.
Logiciel expérimental
Vérifiez toujours les commandes avant de les exécuter sur des systèmes de production.
4. Essayez quelques commandes¶
Langage naturel¶
Merlya > Qu'est-ce que tu peux m'aider à faire ?
Je peux vous aider avec :
- Gérer les connexions SSH aux serveurs
- Exécuter des commandes sur des machines distantes
- Vérifier l'état et les métriques système
- Automatiser les tâches DevOps routinières
Décrivez simplement ce dont vous avez besoin !
Connexion à un serveur¶
Merlya > Connecte-toi à mon-serveur.example.com et montre-moi l'uptime
Connexion à mon-serveur.example.com...
> ssh mon-serveur.example.com "uptime"
14:32:01 up 45 days, 3:21, 2 users, load average: 0.15, 0.10, 0.05
Le serveur fonctionne depuis 45 jours avec de faibles moyennes de charge.
Référencer les hôtes par leur nom¶
Merlya > Vérifie l'espace disque sur web-01 et web-02
> ssh web-01 "df -h /"
> ssh web-02 "df -h /"
Résumé :
- web-01: 45% utilisé (55Go libre)
- web-02: 62% utilisé (38Go libre)
Commandes slash¶
Merlya > /hosts
Nom | Hostname | User | Tags
---------|----------------------|--------|------------------
web-01 | web-01.example.com | deploy | ssh-config
web-02 | web-02.example.com | deploy | ssh-config
db-01 | 10.0.1.50 | admin | known-hosts
Commandes courantes¶
| Commande | Description |
|---|---|
merlya | Démarrer le REPL interactif |
merlya run "..." | Exécuter une commande de manière non-interactive |
merlya config list | Afficher la configuration actuelle |
merlya config set KEY VALUE | Définir une valeur de configuration |
/help | Afficher les commandes slash disponibles |
/hosts | Lister les hôtes configurés |
/new | Démarrer une nouvelle conversation |
/exit | Quitter le REPL |
Étapes suivantes¶
- Mode REPL - Plongée dans l'interface interactive
- Guide d'automatisation - Mode non-interactif, CI/CD, scripting
- Guide de configuration - Options de configuration avancées
- Gestion SSH - Fonctionnalités SSH et pool de connexions
- Fournisseurs LLM - Configurer différents fournisseurs LLM