MangoIDE

Guía Linux · MangoIDE 0.1.0

Documentación de MangoIDE

Instalar, configurar y usar MangoIDE en Linux

Ir a las descargas
01

Compatibilidad y requisitos

La versión Linux publicada actualmente está destinada a equipos de 64 bits.

  • Arquitectura x86_64 / amd64.
  • glibc (libc6) 2.39 o posterior.
  • Sesión gráfica Linux X11 o Wayland.
  • Internet para agentes remotos y descargas de dependencias.
Terminal
dpkg --print-architecture
ldd --version

Ubuntu, Zorin OS y Debian son compatibles solo si la versión instalada incluye glibc 2.39 o posterior. Una distribución antigua puede no iniciar este binario.

02

Instalar el paquete Debian (.deb)

Método recomendado para versiones compatibles de Ubuntu, Zorin OS, Debian y derivados. Añade MangoIDE al menú de aplicaciones.

  • Abre la página de descarga en tu idioma.
  • Descarga el paquete Debian amd64.
  • Ábrelo con el gestor de software o usa el comando siguiente.
  • Inicia MangoIDE desde el menú o con el comando mangoide.
Terminal
cd ~/Downloads
sudo apt install ./mangoide_0.1.0_amd64.deb
03

Usar el archivo portátil

No requiere instalación, pero mantiene los mismos requisitos de arquitectura y glibc.

  • Descarga el archivo portátil x86_64.
  • Extráelo en la carpeta que prefieras.
  • Ejecuta el programa del subdirectorio bin.
  • Conserva share junto al binario para mantener el icono y el archivo de escritorio.
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

Primer inicio y proyectos

MangoIDE trabaja siempre desde una carpeta de proyecto seleccionada.

  • Usa Archivo > Nuevo proyecto para crear o abrir un proyecto.
  • El icono de carpeta cambia rápidamente de directorio.
  • MangoIDE restaura el último proyecto y conversación al reiniciar.
  • Cada proyecto nuevo recibe AGENTS.md, agent-text y obsidian-brain.
  • Las carpetas técnicas aparecen separadas del código.
05

Configurar agentes de IA

Abre Ajustes y después Agentes IA para usar un agente integrado o añadir otro.

  • Pulsa Añadir agente.
  • Elige nombre, proveedor y modelo.
  • Introduce una clave API solo si es necesaria. Codex local puede usar la sesión de Codex instalada.
  • Activa un módulo de visión externo para que un modelo de texto analice imágenes.
  • Guarda y selecciona agente y modelo bajo el cuadro de chat.
  • Los modelos dependen del proveedor, la cuenta y las herramientas instaladas; también puedes escribir su identificador.
06

Memoria Obsidian y AGENTS.md

Cada proyecto conserva su propia memoria técnica dentro de la carpeta del proyecto.

  • ./obsidian-brain guarda errores, correcciones, decisiones, validaciones e ideas.
  • AGENTS.md comunica reglas, comandos y ubicación de la memoria a los agentes.
  • Las notas deben pertenecer únicamente al proyecto actual.
  • Una memoria externa antigua es de solo lectura salvo autorización explícita.
  • agent-text guarda conversaciones y adjuntos.

Versiona AGENTS.md y las notas que quieras compartir. Nunca guardes claves API ni secretos en estos archivos.

07

Chat, terminal y permisos

Chat Agents reúne modelos, adjuntos y progreso; el terminal ejecuta comandos en el proyecto abierto.

  • Single usa un agente; Multi coordina de forma limitada los agentes elegidos.
  • Adjunta varios archivos o pega capturas.
  • Sigue lecturas, cambios, comandos, compilaciones y validaciones.
  • Usa el permiso mínimo; reserva Full para red o acceso ampliado realmente necesario.
  • Node.js, npm, Java, Gradle, Android SDK y demás herramientas deben estar instalados en el equipo.
  • Usa el terminal integrado para ejecutar e interrumpir comandos.
08

Solución de problemas

Estas comprobaciones resuelven la mayoría de incidencias.

  • “GLIBC_x.xx not found”: actualiza la distribución o espera una compilación para una glibc anterior.
  • El paquete no se instala: confirma amd64 y utiliza apt para ver la dependencia exacta.
  • El agente no responde: revisa proveedor, modelo, clave API o inicio de sesión local.
  • Falta npm, Gradle u otro comando: instálalo en el sistema y reinicia MangoIDE.
  • Falla una compilación con red: comprueba la conexión y usa Full solo si necesita descargas.
  • El agente abre otra carpeta: abre primero el proyecto correcto.

¿Necesitas ayuda?

Revisa primero las comprobaciones anteriores. Si el problema continúa, envía un informe con tu distribución, versión y mensaje de error completo.

Informar de un error