Handbuch

Ancilo im Überblick

Ancilo bringt eine KI auf deinen Mac, die vollständig auf deinem Computer läuft. Du chattest mit ihr, lässt sie mit deinen Dateien arbeiten oder mit dir programmieren. Deine Fragen, Dokumente und Antworten verlassen den Computer nicht – außer dort, wo du es ausdrücklich erlaubst, etwa bei der Websuche.

Die KI ist ein Sprachmodell, das Ancilo einmal herunterlädt und dann lokal ausführt. Wie gut und wie schnell es antwortet, hängt vom Modell und von deinem Computer ab. Kleine Modelle laufen auch auf Rechnern mit 8 oder 16 GB Arbeitsspeicher, können sich aber eher irren. Prüfe wichtige Angaben.

• Voraussetzungen: ein Mac mit Apple-Chip (M1 oder neuer) und macOS 13 Ventura oder neuer.
• Speicherplatz: Ein Modell braucht je nach Größe etwa 1 bis 40 GB.
• Internet brauchst du für den Download von Modellen und Updates – und für die Websuche, wenn du sie einschaltest. Sonst arbeitet Ancilo offline.

Installieren, starten, aktualisieren

Öffne die heruntergeladene Datei Ancilo.dmg und zieh Ancilo in den Ordner „Programme“. Starte Ancilo von dort. Die App ist von Apple geprüft (notarisiert) und startet ohne Warnung.

Ancilo besteht aus dem Fenster und einem Hintergrunddienst, der bei der Anmeldung startet. Im Fenster arbeitest du; der Hintergrunddienst lädt die Modelle und erledigt die Arbeit. Schließt du das Fenster, bleibt Ancilo über sein Symbol in der Menüleiste erreichbar: „Open Ancilo“ öffnet das Fenster wieder, „Check for Updates…“ sucht nach einer neuen Version, „Quit“ beendet die App.

Updates installierst du mit einem Klick über die Menüleiste. Wenn du willst, sucht Ancilo selbst täglich nach Updates: Schalte dazu unter System „Automatisch nach Updates suchen“ ein. Ohne deine Zustimmung wird nie etwas installiert.

Ab Version 0.4.1 führt „Settings…“ (⌘,) im Menü „Ancilo“ direkt zu System, und unter „Help“ findest du dieses Handbuch.

Einrichten

Beim ersten Start führt dich „Einrichten“ in fünf Schritten durch alles Nötige. Jeden Schritt kannst du später über „Einrichten“ oben in der Kopfzeile ändern.

• Wofür möchtest du Ancilo nutzen? – „Chatten und Schreiben“, „Programmieren“ oder „Mit eigenen Dokumenten arbeiten“. Danach richtet sich die Empfehlung.
• Die KI für deinen Computer – Ancilo prüft Arbeitsspeicher und Chip und empfiehlt ein Modell, das gut darauf läuft, mit Download-Größe und Speicherbedarf. Ein Klick lädt und startet es.
• Rücksicht auf deinen Computer – wie viel Ancilo von deinem Computer nehmen darf (siehe „Rücksicht auf deinen Computer“ unten).
• Claude Code und Codex – nur, wenn du einen dieser Programmier-Assistenten nutzt. Sonst überspringen.
• Projekte und Dokumente – ein Projekt für etwas, das du bauen willst, und ein Ordner mit Dokumenten, zu dem du Fragen stellen willst. Beides geht auch später.

Aufbau der App

Links oben wählst du einen der drei Bereiche: „Chat“ (Sprechblase), „Aufgaben“ (Computer) und „Code“ (Klammern). Darunter stehen die Gespräche, Aufgaben oder Projekte des Bereichs. Die linke Spalte kannst du an ihrem Rand breiter oder schmaler ziehen.

Die Kopfzeile enthält „Einrichten“ und „System“, ab Version 0.4.1 auch „Handbuch“. Rechts wählst du die „Profi-Ansicht“ und die Sprache (DE/EN). Die Profi-Ansicht zeigt zusätzlich Modelle und Rollen, Vergleiche, Coding Tasks, Änderungen im Detail und ein Terminal – für den Alltag brauchst du sie nicht.

Die Leiste am unteren Rand zeigt, wie es deinem Computer geht („Alles ruhig“, Arbeitsspeicher, Prozessor) und ob Ancilo gerade arbeitet. Ein Klick darauf öffnet die Ressourcen-Einstellungen.

Chat

„Neuer Chat“ beginnt ein Gespräch. Enter sendet, Shift+Enter beginnt eine neue Zeile. Während Ancilo arbeitet, siehst du, was gerade passiert – „Lädt das Modell …“, „Sucht im Web …“, „Schreibt die Antwort …“ – und nach ein paar Sekunden eine Uhr.

Ist kein Modell geladen, lädt die erste Frage eines. Das dauert je nach Modell und Computer einige Sekunden bis wenige Minuten; danach antwortet Ancilo zügig. Nach einer Pause gibt Ancilo den Speicher wieder frei – wann, hängt von der Ressourcen-Einstellung ab.

Gespräche benennst oder löschst du in der linken Spalte. Ancilo antwortet in deiner Sprache.

Dokumente und Projekte im Chat

Über die Büroklammer am Eingabefeld – oder per Ziehen und Einfügen – gibst du einem Gespräch Dokumente mit: PDF, Word (.docx), Excel und andere Tabellen, CSV und Textdateien, auf dem Mac auch Fotos und Scans (JPEG, PNG, HEIC, TIFF, WebP). Ancilo liest sie in einem abgeschotteten Prozess auf deinem Computer und behält nur ihren Text. Antworten nennen die Fundstelle, etwa [Vertrag.pdf, Seite 3].

Bei Fotos und gescannten PDFs erkennt Ancilo den Text mit der Texterkennung von macOS. So erkannter Text ist mit „Text erkannt – kann Fehler enthalten“ markiert. Ein Gespräch mit Dokumenten bleibt dauerhaft bei der KI auf diesem Computer: Es geht an kein Cloud-Modell.

Für Ordner, zu denen du immer wieder Fragen hast – Verträge, Handbücher, Belege –, legst du unter „Projekte“ mit „Ordner hinzufügen“ ein Chat-Projekt an. Ancilo liest die Dokumente darin und hält den Stand aktuell; Chats im Projekt antworten aus diesen Dokumenten. Ancilo verändert im Ordner nichts. Die Projektseite zeigt, was gelesen wurde und was nicht – mit Grund.

Websuche

Für aktuelle Fakten kann Ancilo im Web nachsehen. Das ist aus, bis du es unter System bei „Websuche“ einschaltest. Du wählst, wo gesucht wird: „Wikipedia“ (ohne Konto) oder „Google (über Serper)“ mit einem eigenen, kostenlosen Schlüssel von serper.dev – die App erklärt die drei Schritte dazu.

Ob Ancilo vor einer Suche fragt, bestimmt der Schalter „Websuche“ neben dem Eingabefeld – für Chat, Aufgaben und Code gemeinsam. Ist er aus, zeigt Ancilo dir den Suchbegriff und sucht erst, wenn du zustimmst; du kannst den Begriff ändern. Ist er an, sucht Ancilo selbst, wenn es nötig ist.

Es geht nur ein kurzer Suchbegriff an den Anbieter, nie deine ganze Frage oder der Verlauf. Beachte: Bei Gesprächen mit Dokumenten und bei Aufgaben kann ein automatisch gewählter Suchbegriff Wörter aus deinen Dokumenten enthalten. Wer das nicht möchte, lässt den Schalter dort aus. Antworten mit Websuche nennen ihre Quellen.

Aufgaben

Im Bereich „Aufgaben“ arbeitet Ancilo mit deinen Dateien: aus Rechnungen eine Tabelle machen, Verträge zusammenfassen, Fotos nach Jahr sortieren. „Neue Aufgabe“ fragt zuerst nach dem Ordner („Ordner wählen“, der Dialog öffnet in Dokumente), dann „Was soll Ancilo tun?“ – mit Beispielen zum Anklicken. Weitere Dateien ziehst du einfach in das Eingabefeld.

Ancilo arbeitet nie direkt in deinem Ordner, sondern in einer Kopie, die nur das enthält, was die Aufgabe ändert. Deshalb startet eine Aufgabe sofort, auch bei großen Ordnern. Wenn Ancilo fertig ist, listet eine Karte jede Änderung: neu, geändert, gelöscht, verschoben.

Ancilo liest dabei Dokumente, sucht darin, schreibt Text-, Excel- und Word-Dateien und verschiebt, benennt und löscht Dateien – alles nur in der Kopie, ohne Befehle und ohne Zugriff außerhalb des Ordners. Text in Dokumenten gilt nie als Anweisung.

• „Behalten“ übernimmt die Änderungen in deinen Ordner. Hast du dort inzwischen etwas geändert, schreibt Ancilo nichts und sagt, welche Dateien betroffen sind.
• „Verwerfen“ lässt deinen Ordner, wie er ist.
• „Rückgängig“ nimmt übernommene Änderungen wieder zurück – solange sich die Dateien seitdem nicht geändert haben.
• Der Benutzerordner selbst, Library und Systemordner sind als Aufgabenordner gesperrt. Dateien, die nur in iCloud liegen, und versteckte Dateien nimmt Ancilo nicht mit.

Code

Im Bereich „Code“ programmierst du mit einem lokalen Agenten. Ein Projekt ist ein Ordner; „Projekt hinzufügen“ legt ein Projekt an. In einer Session beschreibst du, was entstehen oder sich ändern soll. Der Agent liest, ändert Dateien und führt Befehle aus – in einer Kopie des Projekts und Befehle in einer Sandbox ohne Netz und ohne Zugriff auf deine Schlüssel und persönlichen Daten.

Unter dem Eingabefeld wählst du den Zugriff: „Jeden Schritt bestätigen“ – der Agent fragt vor jeder Änderung und jedem Befehl – oder „Selbstständig arbeiten“ (Standard). Dein Projekt ändert sich in beiden Fällen erst, wenn du die Änderungen behältst; danach lassen sie sich rückgängig machen. Die Profi-Ansicht zeigt die Änderungen im Detail und ein Terminal.

Claude Code und Codex

Nutzt du die Programmier-Assistenten Claude Code oder Codex, können sie einfache Aufgaben – Tests, Umbenennungen, kleine Korrekturen – an die KI auf deinem Computer abgeben. Das spart Kosten und Nutzungslimits. Verbinde sie unter System bei „Claude Code & Codex“ mit „Verbinden“; der jeweilige Assistent muss dafür installiert sein.

Was abgegebene Aufgaben höchstens dürfen, legst du im Bereich Code unter „Coding Tasks“ fest (Profi-Ansicht); dort siehst du auch laufende Aufgaben. Codex fragt vor jedem Aufruf eines Ancilo-Werkzeugs nach. Was der Cloud-Assistent selbst verarbeitet, bestimmt weiterhin sein Anbieter.

Modelle

Unter System bei „Modelle“ siehst du deine Modelle und ihren Zustand. „Start“ lädt ein Modell, „Weiteres Modell finden“ führt zu Empfehlungen für deinen Computer – mit Qualität, Tempo, Download-Größe und Speicherbedarf. Modelle, die nicht auf deinen Computer passen, kennzeichnet Ancilo und lädt sie nicht.

Hat Ancilo mehrere Modelle, verteilt es die Arbeit auf sie: etwa ein Allrounder für den Chat und ein Spezialist fürs Programmieren. Die Profi-Ansicht zeigt diese Rollen und erlaubt Vergleiche.

Dokumente, Aufgaben und Code bleiben immer bei Modellen auf diesem Computer. Cloud-Modelle nutzt Ancilo nur, wenn du selbst eines hinzufügst – und auch dann nie für deine Dokumente oder deinen Code.

Rücksicht auf deinen Computer

Eine KI braucht beim Arbeiten viel Arbeitsspeicher. Unter System bei „Wie viel darf Ancilo von deinem Computer nehmen?“ stellst du ein, wie viel Ancilo nehmen darf. Ancilo lädt nie ein Modell, für das dein Computer gerade keinen Platz hat, und gibt Speicher frei, wenn er knapp wird.

„Jetzt gerade“ zeigt, was Ancilo, andere Programme und der freie Speicher belegen, welches Modell geladen ist und wann es wieder entladen wird. „Jetzt alles entladen“ gibt sofort allen Speicher frei.

• Sparsam – kleine Modellvarianten, Speicher nach 5 Minuten frei, deine anderen Programme haben immer Vorrang.
• Ausgewogen (empfohlen) – antwortet zügig und gibt den Speicher nach 15 Minuten Pause frei.
• Leistung – bleibt eine Stunde bereit und nimmt genauere Varianten, wenn Platz ist.
• Maximum – Modelle bleiben geladen; Ancilo nimmt keine Rücksicht mehr auf andere Programme, sie können langsamer werden.

Was deinen Computer verlässt

Fragen, Antworten, Dokumente, Aufgaben und Code bleiben auf deinem Computer. Ancilo sammelt keine Nutzungsdaten. Zugangsschlüssel – etwa für Serper – liegen im Schlüsselbund von macOS.

Ins Internet geht Ancilo nur für Folgendes: die Modellliste und Modell-Downloads von Hugging Face, die Websuche, wenn du sie einschaltest, und die Suche nach Updates. Mehr dazu auf der Seite zur Privatsphäre in der App.

• Privatsphäre in der App

Wenn etwas nicht klappt

Hilft das nicht, schick uns eine kurze Beschreibung. Hilfreich sind Ancilo-Version, Mac-Modell, Arbeitsspeicher, das Modell und die Logdateien aus ~/Library/Application Support/ancilo/logs/ (sie können Suchbegriffe enthalten, aber keine Schlüssel).

Ancilo entfernen: Beende Ancilo über das Symbol in der Menüleiste („Quit“), zieh die App aus „Programme“ in den Papierkorb und lösche bei Bedarf deine Daten im Ordner ~/Library/Application Support/ancilo sowie den Hintergrunddienst ~/Library/LaunchAgents/app.ancilo.daemon.plist.

• „Dieses Modell braucht etwa … Arbeitsspeicher, frei sind gerade nur …“ – schließe Programme, die viel Speicher brauchen, oder wähle ein kleineres Modell. Unter System zeigt „Jetzt gerade“, wer wie viel belegt.
• Die Antwort dauert lange – sieh nach, was der Chat anzeigt: Das erste Laden eines Modells dauert am längsten. Auf Rechnern mit wenig Speicher hilft ein kleineres Modell.
• „Verbinden mit Claude Code fehlgeschlagen“ – ist Claude Code oder Codex installiert und im Terminal aufrufbar? Ancilo nennt in der Meldung, wo es den Assistenten gesucht hat.
• Ein Dokument lässt sich nicht lesen – sehr große Dateien (über 50 MB), passwortgeschützte PDFs und Dateien nur in iCloud liest Ancilo nicht; die Meldung nennt den Grund.
• „Ancilo läuft nicht“ – öffne Ancilo aus „Programme“ oder über das Symbol in der Menüleiste; der Hintergrunddienst startet dann wieder.

• Fehler melden oder Ideen schicken