1. Erste Schritte
1.2 Der erste Start
Wohin das Kit gehört, die Seite „Willkommen“, welche Komponenten du wählst und was passiert, während sie heruntergeladen werden.
In der App: «Werkzeuge»
Kurz gesagt
- Leg das Atollo-Programm in einen leeren Ordner, in dem du das Kit aufbewahren möchtest, und öffne es.
- Beim ersten Mal erscheint die Seite „Willkommen“: Wähle die Sprache und, falls nötig, Proxy und Zertifikate, dann Agenten und Sprachen, und klicke auf „Installieren“. Vor „Installieren“ wird nichts heruntergeladen.
- Die Komponenten werden im Hintergrund von den offiziellen Quellen heruntergeladen: Du kannst die App bereits nutzen, während sie ankommen.
- Nichts ist endgültig: Alles lässt sich später auf der Seite Werkzeuge hinzufügen oder entfernen.
1. Wohin das Kit gehört
Das Kit befindet sich dort, wo seine Programmdatei liegt: Der Ordner, der sie enthält, wird zum „Ordner des Kits“, und dort entstehen projects und data. Wähle also einen leeren Ordner mit einem einfachen Namen, zum Beispiel D:\Atollo auf einem USB-Stick oder einer externen Festplatte oder C:\Atollo auf der Festplatte des PCs.
- Unter Windows heißt die Programmdatei Atollo.exe oder Atollo-<Version>-win32-x64.exe, so wie du sie von der Release-Seite herunterlädst. Unter macOS ist es Atollo.app, unter Linux eine AppImage-Datei.
- Speicherplatz: Die beim ersten Start vorgeschlagene Auswahl belegt etwa 1,8 GB. Jede weitere Sprache oder Version braucht zusätzlichen Platz, und Projekte mit ihren Abhängigkeiten wachsen mit der Zeit: Auf einem USB-Stick sollten mindestens 16 GB frei sein.
- Geschwindigkeit: Eine externe SSD ist viel schneller als ein billiger USB-Stick. Das Kit funktioniert auf beiden, aber Pakete mit npm oder Composer auf einem langsamen USB-Stick zu installieren erfordert Geduld.
Welches Dateisystem du wählen solltest
Unter Windows ist NTFS das beste Format: Es ist das einzige, mit dem das Kit die Ordner mit Passwörtern (Datenbanken, Anmeldungen) so schützen kann, dass nur dein Benutzer sie lesen kann, und Verknüpfungen statt Kopien verwenden kann. Auf exFAT und FAT32 funktioniert das Kit, aber ohne diesen Schutz; FAT32 akzeptiert außerdem keine Dateien über 4 GB. Wenn du denselben USB-Stick unter Windows, macOS und Linux verwendest, ist exFAT das Format, das alle lesen und schreiben können: Denk in diesem Fall daran, dass Verknüpfungen zu Kopien werden.
Die Seite Einstellungen › „Das Kit“ zeigt die Festplatte, auf der sich das Kit befindet: Dateisystem und Typ (fest, Wechseldatenträger, Netzwerk).
2. Die Seite „Willkommen“
Beim ersten Start erscheint statt der üblichen Seiten der Tab „Willkommen“ mit dem Titel „Willkommen bei Atollo“. Er erklärt, dass Agenten und Sprachen von den offiziellen Quellen heruntergeladen, geprüft und im Ordner data des Kits abgelegt werden, ohne Installation und ohne Administratorrechte.
Oben stehen zwei Gruppen von Einstellungen, die sich beim Ändern von selbst speichern (wie auf der Seite Einstellungen, wo du sie wiederfindest): „Bevor du beginnst“ mit „Sprache“, „Design“ und „Automatisches Update“ und „Netzwerk“ mit Proxy, zusätzlichen Zertifikaten und lokalem Netzwerk. Fülle „Netzwerk“ nur aus, wenn dein Netzwerk über einen Proxy läuft oder den HTTPS-Verkehr untersucht: Da vor „Installieren“ nichts heruntergeladen wird, verwenden auch die ersten Downloads diese Werte.
Darunter steht die Liste der Komponenten, in acht Arten aufgeteilt (jede mit ihrer Beschreibung), mit einem Suchfeld und einem Index links. Jede Zeile hat ein Kontrollkästchen, das Logo, den Namen, eine Beschreibung, die Größe und Etiketten, die sagen, was sie braucht oder wozu sie dient.
| Typ | Was es enthält | Was du wählen solltest |
|---|---|---|
| System und Editor | Der Editor, PowerShell 7 (die Konsole des Kits), GitHub CLI und Git. Darunter die Anforderungen an den PC. | Der Editor, PowerShell 7 und GitHub CLI werden immer installiert, zusammen mit den anderen, wenn du auf „Installieren“ klickst: Ihre Kontrollkästchen sind gesperrt. Git wählst du selbst, und es kommt ohnehin mit Claude Code und Pi. |
| KI-Agenten | Claude Code, Codex, Antigravity und Pi. | Optional. Behalte die, für die du ein Konto hast; sie erfordern ein Abonnement oder einen API-Schlüssel des Anbieters. Pi ist nicht angekreuzt: Kreuze ihn an, wenn du einen Agenten mit den lokalen Modellen willst, ohne Konto. |
| Lokale Modelle | llama.cpp, der Server der Sprachmodelle auf dem PC. | Optional und nicht angekreuzt. Er installiert sich auch von selbst beim ersten Start des Servers, auf der Seite KI im Bereich Lokale Modelle, wo die Modelle heruntergeladen werden (viele GB). |
| Sprachen | Alle Sprachen und Laufzeiten: Python, Node.js, PHP, Java, Go, .NET, Rust, Ruby, der C/C++-Compiler und die anderen. Python, Node.js, PHP, Go und Java können mehrere Versionen haben; die anderen bleiben auf der neuesten. | Die, die du verwendest. Weitere kommen hinzu, wenn sie gebraucht werden. |
| Entwicklungswerkzeuge | uv, pnpm und yarn, CMake und Ninja, Android SDK, Typst, TinyTeX: eine einzige Version, immer die neueste. | Normalerweise nichts: Das Kit installiert sie selbst, wenn ein Projekt oder ein Agent sie anfordert. |
| Webserver | Apache und Caddy, für die Websites der Projekte und die gemeinsamen Webserver. | Den, den deine Projekte verwenden; Apache ist schon in der vorgeschlagenen Auswahl. |
| Datenbanken | MySQL, MongoDB, SQLite; im Browser phpMyAdmin und mongo-express. | Nur wenn du sie brauchst. MySQL wird auch beim ersten Start des Servers installiert. |
Die vorgeschlagene Auswahl umfasst Claude Code, Codex und Antigravity (weder Pi noch llama.cpp), Python, PHP mit Apache und die Komponenten von „System und Editor“, Git inklusive. Insgesamt etwa 1,8 GB. Wenn du eine Komponente ankreuzt, kreuzt das Kit auch die an, die sie braucht (zum Beispiel bringt Kotlin Java mit, phpMyAdmin bringt PHP und MySQL mit).
- Wähle unter „Bevor du beginnst“ die Sprache und, wenn du willst, das Design; wenn du hinter einem Firmen-Proxy bist, fülle auch „Netzwerk“ aus.
- Entferne das Häkchen bei allem, was dich nicht interessiert, und füge hinzu, was du verwendest.
- Klicke unten auf „Installieren“. Es gibt keine Bestätigung: Die Auswahl wird gespeichert und der Download beginnt sofort.
- Die App verlässt die Seite „Willkommen“ und zeigt die normalen Seiten. Der Download läuft im Hintergrund weiter: Du siehst ihn in der Statusleiste unten und im Bereich „Aktivität“.
3. Was beim Herunterladen passiert
- HerunterladenVon der offiziellen Quelle des Herstellers, über HTTPS.
- PrüfenVergleicht den Fingerabdruck der Datei mit dem veröffentlichten; stimmt er nicht überein, wird sie verworfen.
- EntpackenIn einen temporären Arbeitsordner.
- EinrichtenLegt das Programm in data\apps ab und prüft, ob es antwortet.
Jede Komponente durchläuft diese vier Schritte. Wenn ein Download fehlschlägt (kein Netzwerk, Firmen-Proxy, Website des Herstellers nicht erreichbar), versucht es das Kit dreimal; klappt es dann immer noch nicht, zeigt die Zeile den Fehler und, wenn möglich, einen Kasten, um die Datei mit dem Browser herunterzuladen und dem Kit zu übergeben.
Die Details zu Quellen und Prüfungen stehen in Woher die Werkzeuge stammen (8.4); wenn du hinter einem Firmen-Proxy bist, lies zuerst Firmennetzwerk: Proxy, Zertifikate, lokales Netzwerk (6.3).
Unter der Haube
- Die Auswahl der Komponenten wird in data\app\components.txt gespeichert, eine Zeile pro Komponente (id=1 gewählt, id=0 nicht).
- Beim ersten Start wird nichts heruntergeladen, nicht einmal die erforderlichen Komponenten, bis du auf „Installieren“ klickst: So gelten Proxy und Zertifikate, die du auf der Seite gewählt hast, schon für die ersten Downloads. Bei den folgenden Starts prüft das Kit, ob die erforderlichen Komponenten vorhanden sind, und installiert sie selbst neu, wenn sie fehlen, ohne zu fragen.
- Wird der erste Start unterbrochen, erscheint die Seite „Willkommen“ beim erneuten Öffnen nicht wieder, wenn die Auswahl bereits gespeichert ist: Du machst unter Werkzeuge weiter, wo nicht heruntergeladene Zeilen den Zustand „nicht vorhanden“ oder „Fehler“ zeigen.