MangoIDE

Guida Linux · MangoIDE 0.1.0

Documentazione MangoIDE

Installare, configurare e usare MangoIDE su Linux

Vai ai download
01

Compatibilità e requisiti

La versione Linux attuale è destinata ai computer a 64 bit.

  • Architettura x86_64 / amd64.
  • glibc (libc6) 2.39 o successiva.
  • Sessione grafica Linux X11 o Wayland.
  • Internet per agenti remoti e dipendenze.
Terminal 
dpkg --print-architecture
ldd --version

Ubuntu, Zorin OS e Debian sono compatibili solo se la versione installata include glibc 2.39 o successiva. Le distribuzioni meno recenti potrebbero non avviare il programma.

02

Installare il pacchetto Debian (.deb)

Metodo consigliato per versioni compatibili di Ubuntu, Zorin OS, Debian e derivate.

  • Apri la pagina di download nella tua lingua.
  • Scarica il pacchetto Debian amd64.
  • Aprilo con il gestore software oppure usa il comando seguente.
  • Avvia MangoIDE dal menu o con mangoide.
Terminal 
cd ~/Downloads
sudo apt install ./mangoide_0.1.0_amd64.deb
03

Usare l’archivio portatile

Non richiede installazione, ma mantiene gli stessi requisiti di architettura e glibc.

  • Scarica l’archivio x86_64.
  • Estrailo nella cartella desiderata.
  • Avvia il programma nella sottocartella bin.
  • Mantieni share accanto al binario.
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

Primo avvio e progetti

MangoIDE lavora sempre da una cartella di progetto selezionata.

  • Usa File > Nuovo progetto per creare o aprire un progetto.
  • L’icona della cartella consente di cambiare directory.
  • Al riavvio vengono ripristinati ultimo progetto e conversazione.
  • Ogni nuovo progetto riceve AGENTS.md, agent-text e obsidian-brain.
  • Le cartelle tecniche sono separate visivamente dal codice.
05

Configurare gli agenti IA

Apri Impostazioni e Agenti IA per usare un agente integrato o aggiungerne uno.

  • Seleziona Aggiungi agente.
  • Scegli nome, fornitore e modello.
  • Inserisci la chiave API solo se richiesta. Codex locale può usare la sessione Codex installata.
  • Attiva un modulo di visione esterno per i modelli solo testo.
  • Salva e seleziona agente e modello sotto la chat.
  • I modelli dipendono da fornitore, account e strumenti; puoi inserire manualmente l’identificatore.
06

Memoria Obsidian e AGENTS.md

Ogni progetto conserva una memoria tecnica locale.

  • ./obsidian-brain contiene bug, correzioni, decisioni, verifiche e idee.
  • AGENTS.md comunica regole, comandi e posizione della memoria.
  • Le note devono riguardare solo il progetto corrente.
  • Una vecchia memoria esterna è in sola lettura senza autorizzazione esplicita.
  • agent-text conserva conversazioni e allegati.

Versiona AGENTS.md e le note da condividere. Non salvare mai chiavi API o segreti in questi file.

07

Chat, terminale e autorizzazioni

Chat Agents riunisce modelli, allegati e avanzamento; il terminale opera nel progetto aperto.

  • Single usa un agente; Multi coordina in modo limitato gli agenti scelti.
  • Allega più file o incolla schermate.
  • Segui letture, modifiche, comandi, build e verifiche.
  • Usa il permesso minimo; Full solo quando servono rete o accesso esteso.
  • Node.js, npm, Java, Gradle e Android SDK devono essere installati sul computer.
  • Esegui e interrompi i comandi nel terminale integrato.
08

Risoluzione dei problemi

Questi controlli risolvono i problemi più comuni.

  • “GLIBC_x.xx not found”: aggiorna la distribuzione o attendi una build per glibc precedente.
  • Installazione fallita: verifica amd64 e usa apt per individuare la dipendenza.
  • Agente senza risposta: verifica fornitore, modello, chiave API o accesso locale.
  • npm, Gradle o altro comando assente: installalo e riavvia MangoIDE.
  • Build di rete fallita: verifica la connessione e usa Full solo se necessario.
  • Cartella errata: apri il progetto corretto prima della richiesta.

Serve aiuto?

Controlla prima le indicazioni sopra. Se il problema rimane, invia distribuzione, versione e messaggio di errore completo.

Segnala un bug