1. Primi passi
1.1 Benvenuto in Atollo
Che cos'è Atollo, che cosa trovi dentro e come è organizzata questa guida. Il punto da cui partire se è la prima volta.
In breve
- Atollo è un ambiente di sviluppo completo che vive in una sola cartella: su una chiavetta, un disco esterno o il disco del PC.
- Non si installa e non chiede diritti di amministratore: copi la cartella su un altro PC e ritrovi tutto, progetti compresi.
- Dentro trovi linguaggi in più versioni, database, server web, un editor, console, Git e GitHub, quattro agenti IA e i modelli linguistici locali.
- Questa guida va dalle cose più semplici a quelle più tecniche: puoi leggerla in ordine o saltare dove ti serve.
Che cos'è, in parole semplici
Immagina uno zaino da lavoro già pronto: dentro c'è tutto ciò che serve per scrivere programmi e siti, ordinato e funzionante. Lo porti con te, lo apri su qualsiasi computer e lavori, senza installare niente e senza lasciare disordine sul PC che ti ospita. Quando hai finito, lo chiudi e lo porti via.
Atollo è quello zaino. È un unico programma che sta in una cartella insieme a due sottocartelle: projects, dove vivono i tuoi progetti, e data, dove il kit tiene i suoi programmi, le impostazioni e i dati dei database. Funziona su Windows 10 e 11, macOS e Linux, con processori x64 e ARM64 (su ARM64 serve Windows 11).
Che cosa trovi dentro
| Che cosa | A che cosa serve | Dove si trova nell'app |
|---|---|---|
| Progetti | Le tue cartelle di lavoro, ognuna con le sue azioni, versioni, database e sito. | Progetti |
| Linguaggi e strumenti | Python, Node.js, PHP, Java, .NET, Go, Rust e molti altri, anche più versioni insieme. | Strumenti |
| Database | Un server MySQL e uno MongoDB, solo per questo PC, con le password già pronte. | Database |
| Server web | Caddy e Apache per vedere i tuoi siti su indirizzi come mio-sito.localhost. | Server Web |
| Editor | VSCodium, la versione libera di Visual Studio Code, in una finestra di Atollo. | Progetti › Editor |
| Console | PowerShell 7 con tutti gli strumenti del kit già pronti. | Terminali |
| Git e GitHub | Git e GitHub CLI con un solo accesso al tuo account per tutto il kit. | Impostazioni › Account GitHub |
| Agenti IA | Claude Code, Codex, Antigravity e Pi, con istruzioni, skill e server MCP condivisi. | AI › Agenti |
| Modelli locali | Modelli linguistici sul PC, senza rete e senza account, per Pi e per una chat nel browser. | AI › Modelli locali |
Tre idee da tenere a mente
Tutto in una cartella
Il kit pensa agli strumenti
Solo su questo PC
Come è fatta questa guida
La guida ha nove capitoli. I primi tre servono a tutti: come partire, come lavorare ai progetti, come usare database e siti. Poi agenti, strumenti e impostazioni. Il capitolo «Come funziona dentro» è per chi vuole capire i dettagli tecnici; l'ultimo raccoglie problemi comuni, domande frequenti e un glossario.
In ogni argomento trovi: un riquadro «In breve» all'inizio, i passaggi da seguire, consigli e avvertenze, e una parte ripiegata «Sotto il cofano» con i dettagli tecnici (file, cartelle, comandi). Sotto il titolo di ogni argomento c'è la pagina dell'app di cui parla. La casella di ricerca sopra i capitoli cerca nei titoli, nelle descrizioni e nelle parole chiave.