MangoIDE

Guide Linux · MangoIDE 0.1.0

Documentation MangoIDE

Installer, configurer et utiliser MangoIDE sous Linux

Accéder aux téléchargements
01

Compatibilité et prérequis

La version Linux actuellement publiée cible les ordinateurs 64 bits. Vérifiez votre système avant le téléchargement.

  • Architecture x86_64 / amd64.
  • glibc (libc6) version 2.39 ou plus récente.
  • Une session graphique Linux X11 ou Wayland.
  • Une connexion Internet pour les agents distants et les outils qui téléchargent des dépendances.
Terminal 
dpkg --print-architecture
ldd --version

Ubuntu, Zorin OS et Debian sont utilisables seulement si leur version fournit glibc 2.39 ou une version plus récente. Une distribution plus ancienne peut refuser de lancer ce binaire.

02

Installer le paquet Debian (.deb)

Cette méthode est recommandée sur Ubuntu, Zorin OS, Debian et leurs dérivés compatibles. Elle ajoute MangoIDE au menu des applications.

  • Ouvrez la page de téléchargement dans votre langue.
  • Téléchargez le paquet Debian amd64.
  • Ouvrez le fichier avec le gestionnaire de logiciels, ou installez-le dans un terminal avec la commande ci-dessous.
  • Lancez ensuite MangoIDE depuis le menu des applications ou avec la commande mangoide.
Terminal 
cd ~/Downloads
sudo apt install ./mangoide_0.1.0_amd64.deb
03

Utiliser l’archive portable

L’archive ne nécessite pas d’installation système. Elle conserve toutefois les mêmes exigences d’architecture et de glibc que le paquet Debian.

  • Téléchargez l’archive portable x86_64.
  • Extrayez-la dans le dossier de votre choix.
  • Lancez le binaire situé dans le sous-dossier bin.
  • Conservez le dossier share avec le binaire afin de garder l’icône et le fichier de bureau.
Terminal 
cd ~/Downloads
tar -xzf MangoIDE-linux-x86_64-0.1.0.tar.gz
cd MangoIDE-linux-x86_64-0.1.0
./bin/mangoide
04

Premier démarrage et projets

MangoIDE travaille toujours à partir d’un dossier de projet clairement défini.

  • Utilisez Fichier > Nouveau projet pour créer ou ouvrir un projet.
  • L’icône de dossier de l’explorateur permet de changer rapidement de répertoire.
  • MangoIDE restaure le dernier projet et sa dernière conversation au redémarrage.
  • Chaque nouveau projet reçoit un fichier AGENTS.md, un dossier agent-text et un dossier obsidian-brain.
  • Les dossiers techniques sont séparés visuellement dans l’explorateur pour éviter de les confondre avec le code de l’application.
05

Configurer les agents IA

Ouvrez Paramètres, puis la section Agents IA. Vous pouvez utiliser les agents intégrés ou en ajouter un adapté à votre fournisseur.

  • Cliquez sur Ajouter un agent.
  • Donnez un nom clair à l’agent, puis choisissez son fournisseur et son modèle.
  • Ajoutez une clé API seulement lorsque le fournisseur l’exige. Pour Codex local, utilisez la session de connexion Codex installée sur la machine.
  • Activez le module de vision externe pour un modèle texte qui doit analyser des images.
  • Enregistrez, puis choisissez l’agent et le modèle dans les sélecteurs sous la zone de conversation.
  • Les modèles disponibles dépendent du fournisseur, du compte et des outils installés. Un identifiant de modèle peut aussi être saisi manuellement.
06

Mémoire Obsidian et AGENTS.md

Chaque projet possède sa propre mémoire technique. Elle reste dans le projet et peut être ouverte avec Obsidian comme un coffre de notes ordinaire.

  • Le dossier ./obsidian-brain contient les bugs, corrections, décisions techniques, validations et idées propres au projet.
  • Le fichier AGENTS.md indique aux agents les règles du projet, les commandes utiles et l’emplacement de cette mémoire.
  • Les notes doivent concerner uniquement le projet courant.
  • Un ancien cerveau externe sert de référence en lecture seule, sauf autorisation explicite d’écriture.
  • Le dossier agent-text conserve les conversations et pièces jointes du projet.

Pensez à versionner AGENTS.md et les notes utiles si elles doivent être partagées avec votre équipe. Ne placez jamais de clé API ou de secret dans ces fichiers.

07

Conversation, terminal et autorisations

Le panneau Chat Agents réunit les modèles, les pièces jointes et le suivi des tâches, tandis que le terminal exécute les commandes dans le projet ouvert.

  • Single utilise un agent. Multi permet une collaboration bornée entre plusieurs agents sélectionnés.
  • Joignez plusieurs fichiers ou collez une capture d’écran depuis le presse-papiers.
  • Suivez les lectures, modifications, commandes, compilations et validations dans la chronologie d’activité.
  • Choisissez le niveau d’autorisation minimal nécessaire. Le mode Full est réservé aux tâches qui ont réellement besoin du réseau ou d’un accès système étendu.
  • Node.js, npm, Java, Gradle, Android SDK et les autres outils doivent être installés sur la machine hôte.
  • Utilisez le terminal intégré pour lancer, interrompre et vérifier les commandes du projet.
08

Résoudre les problèmes courants

Ces contrôles règlent la majorité des problèmes d’installation et de configuration.

  • « GLIBC_x.xx not found » : votre distribution est trop ancienne pour ce binaire. Mettez le système à niveau ou attendez une construction compatible avec une glibc plus ancienne.
  • Le paquet ne s’installe pas : vérifiez l’architecture amd64, puis utilisez apt afin qu’il signale précisément les dépendances manquantes.
  • Un agent ne répond pas : contrôlez le fournisseur, le modèle, la clé API ou la connexion de son outil local.
  • npm, Gradle ou une autre commande est introuvable : installez l’outil sur le système puis redémarrez MangoIDE.
  • Une compilation réseau échoue : vérifiez la connexion et sélectionnez Full uniquement si la tâche nécessite les téléchargements externes.
  • L’agent ouvre le mauvais dossier : ouvrez le bon projet depuis l’explorateur avant d’envoyer la demande.

Besoin d’aide ?

Consultez d’abord les vérifications ci-dessus. Si le problème persiste, envoyez un rapport avec votre distribution Linux, sa version et le message d’erreur complet.

Signaler un bug