Help & FAQ
Quick answers, troubleshooting, and a way to reach the developer.
- For anything — bugs, questions, feedback — write to raccoon.dev@icloud.com.
- Replies usually come within a few working days. Capernicus is a one-person project.
Getting started
How do I import a document?
Open Capernicus, go to the Document tab, and pick a file with the macOS file picker. PDF, EPUB, DOCX, Markdown, and plain text all work. The first time you import a file the chapter outline gets extracted automatically — from PDF bookmarks, EPUB navigation, Markdown headings, or a text-pattern fallback when none of those exist.
What model ships with the app?
Capernicus comes with Llama 3.2 3B Instruct (4-bit MLX quantization) bundled inside the app. First launch works fully offline — there's no download, no sign-in, no first-run setup. The bundled model can't be deleted; it's marked with a "Bundled" badge in Settings → Models.
Can I use a different model?
Yes. Open Settings → Models and pick from the catalog (Qwen, Mistral, Phi, and others). Additional models are downloaded from huggingface.co over HTTPS. Capernicus shows a free-disk warning before any multi-GB download.
Does Capernicus work offline?
Yes — once the app is installed. The default model lives inside the app bundle. The only situation that needs the network is downloading an additional model from the catalog.
Using the app
How do I export a summary, exam, or flashcard set?
Each generated card has a context menu with Export as Markdown and Export as PDF. Files are written to your Downloads folder via the standard macOS save panel.
Are there keyboard shortcuts?
Yes. ⌘⇧] and ⌘⇧[ switch between tabs. Trackpad swipe navigates between flashcards. Most affordances are reachable from the keyboard.
Where does my data live, and how do I delete it?
All app data lives inside the macOS sandbox container at ~/Library/Containers/info.capernicus.capernicus/Data/.capernicus/. To delete everything, drag that folder to the Trash, or uninstall the app from Applications. See the Privacy Policy for the full breakdown.
System requirements
- macOS 15 (Sequoia) or later
- Apple Silicon (M-series chip)
- ~3 GB free disk for the bundled model; more if you install additional ones
- 8 GB RAM recommended for comfortable use; 16 GB+ for larger models
Troubleshooting
The model won't download
Check your network connection and free disk space. Capernicus shows the model file size before starting; macOS may also block the download if the disk is nearly full. If the download stalls, quit the app and try again — partial downloads resume from the last completed file.
EPUB images don't render
Capernicus uses Apple's WKWebView to render EPUB content. Some EPUBs reference images via paths the renderer can't resolve in a sandboxed context. If you hit this, opening the same book as a PDF (if you have one) typically works around it.
The app feels slow or uses a lot of RAM
Local LLM inference is memory-hungry. Settings → Models has an Unload model affordance that releases the weights without quitting the app. Capernicus also clears the MLX cache automatically after every generation; if you've been running it for hours, restarting the app gives you a clean slate.
I think I found a bug
Please tell us. Email raccoon.dev@icloud.com with what you did, what you expected, and what happened instead. A screenshot is gold; macOS version + chip (Apple menu → About This Mac) helps too.
Privacy & security
Capernicus runs entirely on your Mac. No accounts, no telemetry, no third-party SDKs. The full Privacy Policy covers exactly what stays on your device, what goes over the network (only model downloads, only when you ask for them), and what Apple's standard pipelines may forward if you've opted in.
- Para cualquier cosa — fallos, preguntas, comentarios — escribe a raccoon.dev@icloud.com.
- Las respuestas suelen llegar en pocos días laborables. Capernicus es un proyecto de una sola persona.
Primeros pasos
¿Cómo importo un documento?
Abre Capernicus, ve a la pestaña Documento y elige un archivo con el selector de archivos de macOS. Funcionan PDF, EPUB, DOCX, Markdown y texto plano. La primera vez que importas un archivo, el índice de capítulos se extrae automáticamente — de los marcadores del PDF, de la navegación del EPUB, de los encabezados Markdown o, si no hay nada de eso, mediante patrones de texto.
¿Qué modelo viene incluido?
Capernicus se distribuye con Llama 3.2 3B Instruct (cuantización MLX de 4 bits) dentro de la app. El primer arranque funciona totalmente sin conexión — sin descargas, sin inicios de sesión, sin configuración inicial. El modelo incluido no se puede borrar; aparece con la etiqueta «Incluido» en Ajustes → Modelos.
¿Puedo usar otro modelo?
Sí. Abre Ajustes → Modelos y elige del catálogo (Qwen, Mistral, Phi y otros). Los modelos adicionales se descargan desde huggingface.co mediante HTTPS. Capernicus avisa del espacio libre en disco antes de cualquier descarga de varios GB.
¿Funciona sin conexión?
Sí — una vez instalada. El modelo por defecto vive dentro del paquete de la app. La única situación que requiere red es descargar un modelo adicional del catálogo.
Uso de la app
¿Cómo exporto un resumen, examen o set de flashcards?
Cada tarjeta generada tiene un menú contextual con Exportar como Markdown y Exportar como PDF. Los archivos se guardan en la carpeta Descargas mediante el panel de guardar estándar de macOS.
¿Hay atajos de teclado?
Sí. ⌘⇧] y ⌘⇧[ cambian entre pestañas. Deslizar con el trackpad navega entre flashcards. Casi toda la app es accesible desde el teclado.
¿Dónde se guardan mis datos y cómo los elimino?
Todos los datos viven dentro del contenedor de sandbox de macOS, en ~/Library/Containers/info.capernicus.capernicus/Data/.capernicus/. Para borrarlo todo, arrastra esa carpeta a la Papelera o desinstala la app desde Aplicaciones. La Política de privacidad tiene el detalle completo.
Requisitos del sistema
- macOS 15 (Sequoia) o posterior
- Apple Silicon (chip de la serie M)
- ~3 GB libres en disco para el modelo incluido; más si instalas modelos adicionales
- 8 GB de RAM recomendados para un uso cómodo; 16 GB+ para modelos más grandes
Resolución de problemas
El modelo no se descarga
Comprueba tu conexión y el espacio libre en disco. Capernicus muestra el tamaño del modelo antes de empezar; macOS también puede bloquear la descarga si el disco está casi lleno. Si la descarga se bloquea, sal de la app y vuelve a intentarlo — las descargas parciales se reanudan desde el último archivo completado.
Las imágenes del EPUB no se ven
Capernicus usa WKWebView de Apple para renderizar EPUB. Algunos EPUBs referencian imágenes con rutas que el renderizador no puede resolver en un contexto sandbox. Si te pasa, abrir el mismo libro como PDF (si lo tienes) suele resolverlo.
La app va lenta o usa mucha RAM
La inferencia LLM local consume memoria. Ajustes → Modelos tiene una opción Descargar modelo que libera los pesos sin cerrar la app. Capernicus también limpia automáticamente la caché de MLX tras cada generación; si llevas horas con la app abierta, reiniciarla deja la memoria limpia.
Creo que he encontrado un fallo
Cuéntanoslo, por favor. Escribe a raccoon.dev@icloud.com con qué hiciste, qué esperabas y qué pasó en cambio. Una captura de pantalla es oro; la versión de macOS y el chip (menú Apple → Acerca de este Mac) también ayudan.
Privacidad y seguridad
Capernicus funciona íntegramente en tu Mac. Sin cuentas, sin telemetría, sin SDKs de terceros. La Política de privacidad completa explica exactamente qué se queda en tu dispositivo, qué viaja por la red (solo descargas de modelos, solo cuando las pides) y qué pueden reenviar los pipelines estándar de Apple si los has activado.
- Pour tout — bugs, questions, retours — écrivez à raccoon.dev@icloud.com.
- Les réponses arrivent en général sous quelques jours ouvrés. Capernicus est un projet à une seule personne.
Premiers pas
Comment importer un document ?
Ouvrez Capernicus, allez dans l'onglet Document et choisissez un fichier avec le sélecteur de fichiers macOS. PDF, EPUB, DOCX, Markdown et texte brut fonctionnent tous. À la première importation, le sommaire des chapitres est extrait automatiquement — depuis les signets PDF, la navigation EPUB, les titres Markdown, ou via une détection par motifs de texte si rien d'autre n'existe.
Quel modèle est inclus dans l'app ?
Capernicus est livré avec Llama 3.2 3B Instruct (quantization MLX 4 bits) à l'intérieur du paquet. Le premier lancement fonctionne entièrement hors ligne — pas de téléchargement, pas de connexion, pas de configuration initiale. Le modèle inclus ne peut pas être supprimé ; il porte un badge « Inclus » dans Réglages → Modèles.
Puis-je utiliser un autre modèle ?
Oui. Ouvrez Réglages → Modèles et choisissez dans le catalogue (Qwen, Mistral, Phi et d'autres). Les modèles supplémentaires sont téléchargés depuis huggingface.co via HTTPS. Capernicus affiche un avertissement d'espace disque libre avant tout téléchargement de plusieurs Go.
Capernicus fonctionne-t-il hors ligne ?
Oui — une fois l'app installée. Le modèle par défaut vit à l'intérieur du paquet de l'app. La seule situation qui requiert le réseau est le téléchargement d'un modèle supplémentaire depuis le catalogue.
Utilisation de l'app
Comment exporter un résumé, un examen ou un jeu de cartes ?
Chaque carte générée dispose d'un menu contextuel avec Exporter en Markdown et Exporter en PDF. Les fichiers sont écrits dans votre dossier Téléchargements via le panneau d'enregistrement standard de macOS.
Y a-t-il des raccourcis clavier ?
Oui. ⌘⇧] et ⌘⇧[ changent d'onglet. Le balayage trackpad navigue entre les cartes. La quasi-totalité de l'app est accessible au clavier.
Où sont mes données, et comment les supprimer ?
Toutes les données vivent dans le conteneur sandbox macOS à ~/Library/Containers/info.capernicus.capernicus/Data/.capernicus/. Pour tout effacer, glissez ce dossier vers la Corbeille, ou désinstallez l'app depuis Applications. Voir la Politique de confidentialité pour le détail complet.
Configuration requise
- macOS 15 (Sequoia) ou ultérieur
- Apple Silicon (puce série M)
- ~3 Go d'espace disque libre pour le modèle inclus ; plus si vous en installez d'autres
- 8 Go de RAM recommandés pour un usage confortable ; 16 Go+ pour les modèles plus grands
Dépannage
Le modèle ne se télécharge pas
Vérifiez votre connexion réseau et l'espace disque libre. Capernicus affiche la taille du modèle avant de commencer ; macOS peut aussi bloquer le téléchargement si le disque est presque plein. Si le téléchargement bloque, quittez l'app et réessayez — les téléchargements partiels reprennent depuis le dernier fichier terminé.
Les images de l'EPUB ne s'affichent pas
Capernicus utilise WKWebView d'Apple pour afficher les EPUB. Certains EPUBs référencent des images via des chemins que le moteur ne peut pas résoudre en sandbox. Si cela vous arrive, ouvrir le même livre en PDF (si vous en avez un) contourne en général le problème.
L'app est lente ou consomme beaucoup de RAM
L'inférence LLM locale consomme de la mémoire. Réglages → Modèles propose une commande Décharger le modèle qui libère les poids sans quitter l'app. Capernicus vide aussi automatiquement le cache MLX après chaque génération ; après plusieurs heures, redémarrer l'app remet la mémoire à zéro.
Je crois avoir trouvé un bug
Dites-nous. Écrivez à raccoon.dev@icloud.com avec ce que vous avez fait, ce que vous attendiez, et ce qui s'est passé à la place. Une capture d'écran est précieuse ; la version macOS + la puce (menu Pomme → À propos de ce Mac) aident aussi.
Confidentialité et sécurité
Capernicus s'exécute entièrement sur votre Mac. Pas de comptes, pas de télémétrie, pas de SDK tiers. La Politique de confidentialité complète détaille exactement ce qui reste sur votre appareil, ce qui passe sur le réseau (uniquement les téléchargements de modèles, uniquement à votre demande) et ce que les pipelines standard d'Apple peuvent transmettre si vous y avez consenti.
- Für alles — Bugs, Fragen, Feedback — schreib an raccoon.dev@icloud.com.
- Antworten kommen meistens innerhalb weniger Werktage. Capernicus ist ein Ein-Personen-Projekt.
Erste Schritte
Wie importiere ich ein Dokument?
Öffne Capernicus, geh zum Tab Dokument und wähl eine Datei mit dem macOS-Dateipicker. PDF, EPUB, DOCX, Markdown und Klartext funktionieren alle. Beim ersten Import wird das Kapitelverzeichnis automatisch extrahiert — aus PDF-Lesezeichen, EPUB-Navigation, Markdown-Überschriften oder, falls nichts davon vorhanden ist, per Textmuster-Erkennung.
Welches Modell ist mitgeliefert?
Capernicus liefert Llama 3.2 3B Instruct (4-Bit-MLX-Quantisierung) im App-Bundle mit. Der erste Start funktioniert vollständig offline — kein Download, keine Anmeldung, keine Ersteinrichtung. Das mitgelieferte Modell kann nicht gelöscht werden; es trägt das Etikett „Mitgeliefert" in Einstellungen → Modelle.
Kann ich ein anderes Modell verwenden?
Ja. Öffne Einstellungen → Modelle und wähl aus dem Katalog (Qwen, Mistral, Phi und andere). Zusätzliche Modelle werden von huggingface.co über HTTPS heruntergeladen. Capernicus zeigt vor jedem mehrere-GB-Download eine Warnung zum freien Speicher.
Funktioniert Capernicus offline?
Ja — sobald die App installiert ist. Das Standardmodell lebt im App-Bundle. Die einzige Situation, die das Netzwerk braucht, ist der Download eines zusätzlichen Modells aus dem Katalog.
Die App benutzen
Wie exportiere ich eine Zusammenfassung, Prüfung oder Karteikarten?
Jede generierte Karte hat ein Kontextmenü mit Als Markdown exportieren und Als PDF exportieren. Dateien werden über das Standard-macOS-Speichern-Panel in deinen Downloads-Ordner geschrieben.
Gibt es Tastaturkürzel?
Ja. ⌘⇧] und ⌘⇧[ wechseln zwischen Tabs. Trackpad-Wischen navigiert zwischen Karteikarten. Fast alles in der App ist mit der Tastatur erreichbar.
Wo liegen meine Daten und wie lösche ich sie?
Alle App-Daten leben im macOS-Sandbox-Container unter ~/Library/Containers/info.capernicus.capernicus/Data/.capernicus/. Um alles zu löschen, zieh diesen Ordner in den Papierkorb oder deinstalliere die App aus dem Programme-Ordner. Die Datenschutzrichtlinie hat die vollständige Übersicht.
Systemvoraussetzungen
- macOS 15 (Sequoia) oder neuer
- Apple Silicon (M-Serie-Chip)
- ~3 GB freier Speicher für das mitgelieferte Modell; mehr, wenn du weitere installierst
- 8 GB RAM für komfortables Arbeiten empfohlen; 16 GB+ für größere Modelle
Fehlerbehebung
Das Modell lädt nicht herunter
Prüf deine Netzwerkverbindung und den freien Speicher. Capernicus zeigt die Modellgröße vor dem Start an; macOS kann den Download auch blockieren, wenn die Festplatte fast voll ist. Wenn der Download hängt, beende die App und versuch es erneut — teilweise Downloads werden ab der letzten abgeschlossenen Datei fortgesetzt.
EPUB-Bilder werden nicht angezeigt
Capernicus verwendet Apples WKWebView, um EPUBs darzustellen. Manche EPUBs verweisen auf Bilder über Pfade, die der Renderer im Sandbox-Kontext nicht auflösen kann. Wenn du darauf stößt, hilft es meistens, dasselbe Buch als PDF zu öffnen (falls vorhanden).
Die App fühlt sich langsam an oder nutzt viel RAM
Lokale LLM-Inferenz braucht viel Speicher. Einstellungen → Modelle hat einen Punkt Modell entladen, der die Gewichte freigibt, ohne die App zu beenden. Capernicus leert auch nach jeder Generierung automatisch den MLX-Cache; wenn du sie stundenlang offen hattest, gibt ein Neustart der App einen sauberen Speicher.
Ich glaube, ich habe einen Bug gefunden
Bitte sag uns Bescheid. Schreib an raccoon.dev@icloud.com mit dem, was du gemacht hast, was du erwartet hast und was stattdessen passiert ist. Ein Screenshot ist Gold; macOS-Version + Chip (Apple-Menü → Über diesen Mac) helfen auch.
Datenschutz & Sicherheit
Capernicus läuft vollständig auf deinem Mac. Keine Konten, keine Telemetrie, keine Drittanbieter-SDKs. Die vollständige Datenschutzrichtlinie erklärt genau, was auf deinem Gerät bleibt, was übers Netzwerk geht (nur Modell-Downloads, nur wenn du sie anforderst) und was Apples Standard-Pipelines weiterleiten können, wenn du dem zugestimmt hast.