# Verbinal for macOS: user manual > The manual of Verbinal for macOS, the Mac app for the Canadian Astronomy Data Centre (CADC) and the CANFAR science platform: archive search, FITS and cube viewers, VOSpace storage, sessions, batch jobs, Remote Compute, and working with an AI assistant over MCP. In English and French, for Verbinal 1.4. Verbinal for Windows (https://github.com/szautkin/CanfarDesktop) and for Linux (https://github.com/szautkin/CanfarDesktopUbuntu) are separate apps; their manuals will come later. Each chapter below links its Markdown. The same page as HTML is at the same address, without `.md`. To connect an AI agent to Verbinal itself, read [AGENTS.md](https://github.com/szautkin/canfar-macos/blob/main/AGENTS.md). ## English - [Verbinal user manual](https://docs.verbinal.com/en/00-contents.md): Verbinal is a Mac app for astronomers who work with the Canadian Astronomy Data Centre (CADC) and the CANFAR science platform. It searches the archive, keeps your observations and notes, shows FITS images, spectra and data cubes, manages your VOSpace storage, and runs sessions, batch jobs and code on CANFAR, all in one window. An AI assistant can work in it with you, on terms you set. - [Getting started](https://docs.verbinal.com/en/01-getting-started.md): Verbinal is a Mac app for astronomers who use the Canadian Astronomy Data Centre (CADC) and the CANFAR science platform. In one window you can search the archive, keep and read your observations, look at FITS images and data cubes, manage your VOSpace storage, and run sessions, batch jobs and code on CANFAR. This chapter installs it, walks through the first launch, and shows you around the window. - [Search the CADC archive](https://docs.verbinal.com/en/02-search.md): Search finds observations in the CADC archive: by target or position, by date, by wavelength, by collection and instrument, or with your own ADQL query. It works without signing in; sign in to see proprietary data you have access to. Open it from its Home tile, or Go ▸ Search (⌘1). - [Research: your observations](https://docs.verbinal.com/en/03-research.md): Research is where the observations you keep live, on this Mac: those you downloaded, those you saved without their file, and your cutouts, each with your notes, tags and rating. It works without signing in. Open it from its Home tile, or Go ▸ Research (⌘2). - [FITS Viewer](https://docs.verbinal.com/en/04-fits-viewer.md): The FITS Viewer shows FITS images and spectra, fast, with the world coordinates (WCS) of every pixel. It reads single images, multi-extension files, compressed files (`.fz`) and tables that hold a spectrum. It works without signing in. Open it from its Home tile, or Go ▸ FITS Viewer (⌘3). - [Cube Viewer](https://docs.verbinal.com/en/05-cube-viewer.md): The Cube Viewer explores FITS spectral cubes, such as radio data cubes or the cubes of an integral field unit: as true-valued slices, one channel at a time, and as a 3D volume rendered on the GPU. It works without signing in. Open it from its Home tile, or Go ▸ Cube Viewer (⌘4). - [Portal: sessions](https://docs.verbinal.com/en/06-portal-sessions.md): Portal is your desk on the CANFAR science platform: the platform's load, your storage, your sessions (Jupyter notebooks, desktops, CARTA, Firefly, and contributed applications), the images they run, and your batch jobs. It needs you to be signed in. Open it from its Home tile, or Go ▸ Portal (⌘5). - [Portal: batch jobs](https://docs.verbinal.com/en/07-batch-jobs.md): A batch job (a *headless* session) runs one command in a container on CANFAR, with no window, and ends: reducing a night of data, running a pipeline, many copies of a script in parallel. You start it, leave, and read what it printed when it is done. Batch jobs need you to be signed in, and use your CANFAR allocation. - [Image Discovery and the registry](https://docs.verbinal.com/en/08-image-discovery.md): CANFAR runs your sessions and jobs in container images, and an image does not say from outside what it has installed. Image Discovery looks inside: it runs a small probe job in an image, lists its Python, R, system and OS packages, and keeps the list on your Mac, so you can find the image that has what you need before you launch it. The registry search adds images the platform's catalogue does not list. Both need you to be signed in. - [Storage (VOSpace)](https://docs.verbinal.com/en/09-storage.md): Storage is your CANFAR storage (VOSpace), the same space your sessions and batch jobs see at `/arc/home/`. Browse it, upload and download files, make folders, and keep your private files private. It needs you to be signed in. Open it from its Home tile, or Go ▸ Storage (⌘6). - [Remote Compute](https://docs.verbinal.com/en/10-remote-compute.md): Remote Compute runs Python or Bash on CANFAR, in one session on your own account named `verbinal-compute`, and keeps every run with its output. You run code there from this screen, and your AI assistant runs its code there with its `run_code` tool. The session uses your cores, has no shell and no inbound network, and writes its results to your storage. It needs you to be signed in; open it from its Home tile. - [Workflows](https://docs.verbinal.com/en/11-workflows.md): A workflow is a research protocol as a checklist: the steps of a piece of work, in order, each with what to do and the part of Verbinal that does it. Verbinal comes with templates for common work; copy one to follow it, or write your own. Workflows are kept on this Mac and work without signing in. Open them from their Home tile, or Go ▸ Workflows. - [Working with an AI assistant](https://docs.verbinal.com/en/12-ai-assistant.md): An AI assistant, such as Claude, can work in Verbinal with you: search the archive, download and open observations, read your sessions and storage, run code on CANFAR, and show you around the window. It does this through the Model Context Protocol (MCP), which Verbinal speaks. You decide whether an assistant may connect, what it may do without asking, and you can read everything it did. - [AI Guide](https://docs.verbinal.com/en/13-ai-guide.md): The AI Guide is what every AI assistant is told when it connects to Verbinal: your own standing rules, and the description of each of Verbinal's tools. It is yours to shape. Open it from its Home tile, or Go ▸ AI Guide (⌘7). - [Settings](https://docs.verbinal.com/en/14-settings.md): Open Settings with ⌘, or the gear button in the toolbar. It has eight sections; each is described here with every setting in it. Settings are yours alone: an AI assistant can read some of them, never change them. - [Privacy and your data](https://docs.verbinal.com/en/15-privacy.md): Verbinal has no server of its own. It collects nothing about you, sends nothing to its developer, and has no analytics, tracking or advertising. Your data stays on your Mac, or goes to the CADC and CANFAR services you use, over HTTPS. - [Troubleshooting](https://docs.verbinal.com/en/16-troubleshooting.md): When something does not work, the activity bar at the bottom of the window is the first place to look: it says what Verbinal is doing, and what failed and why. Click it for the Activity list. - [Keyboard shortcuts and menus](https://docs.verbinal.com/en/a-shortcuts-and-menus.md): Every menu of Verbinal, and every keyboard shortcut, by where it works. The menus Verbinal shares with every Mac app (Edit, Window) work as usual. - [Glossary](https://docs.verbinal.com/en/b-glossary.md): ## Français - [Manuel de l’utilisateur de Verbinal](https://docs.verbinal.com/fr/00-contents.md): Verbinal est une app Mac pour les astronomes qui travaillent avec le Centre canadien de données astronomiques (CADC) et la plateforme scientifique CANFAR. Elle cherche dans l’archive, garde vos observations et vos notes, affiche les images FITS, les spectres et les cubes de données, gère votre stockage VOSpace, et lance sessions, tâches en lot et code sur CANFAR, le tout dans une seule fenêtre. Un assistant IA peut y travailler avec vous, selon vos conditions. - [Premiers pas](https://docs.verbinal.com/fr/01-getting-started.md): Verbinal est une app Mac pour les astronomes qui travaillent avec le Centre canadien de données astronomiques (CADC) et la plateforme scientifique CANFAR. Dans une seule fenêtre, vous cherchez dans l’archive, gardez et lisez vos observations, examinez des images FITS et des cubes de données, gérez votre stockage VOSpace, et lancez sessions, tâches en lot et code sur CANFAR. Ce chapitre installe l’app, suit le premier lancement et fait le tour de la fenêtre. - [Rechercher dans l’archive du CADC](https://docs.verbinal.com/fr/02-search.md): Rechercher trouve des observations dans l’archive du CADC : par cible ou par position, par date, par longueur d’onde, par collection et par instrument, ou avec votre propre requête ADQL. Cela fonctionne sans connexion ; connectez-vous pour voir les données propriétaires auxquelles vous avez accès. Ouvrez-le depuis sa tuile de l’accueil, ou par Aller ▸ Rechercher (⌘1). - [Recherche : vos observations](https://docs.verbinal.com/fr/03-research.md): Recherche est l’endroit où vivent, sur ce Mac, les observations que vous gardez : celles que vous avez téléchargées, celles que vous avez enregistrées sans leur fichier, et vos découpes, chacune avec vos notes, vos étiquettes et votre note de qualité. Cela fonctionne sans connexion. Ouvrez-la depuis sa tuile de l’accueil, ou par Aller ▸ Recherche (⌘2). - [Visionneuse FITS](https://docs.verbinal.com/fr/04-fits-viewer.md): La Visionneuse FITS affiche les images et les spectres FITS, rapidement, avec les coordonnées célestes (WCS) de chaque pixel. Elle lit les images simples, les fichiers à plusieurs extensions, les fichiers compressés (`.fz`) et les tables qui contiennent un spectre. Elle fonctionne sans connexion. Ouvrez-la depuis sa tuile de l’accueil, ou par Aller ▸ Visionneuse FITS (⌘3). - [Visionneuse Cube](https://docs.verbinal.com/fr/05-cube-viewer.md): La Visionneuse Cube explore les cubes spectraux FITS, comme les cubes radio ou ceux d’une unité de champ intégral : en tranches aux vraies valeurs, un canal à la fois, et en volume 3D rendu par le GPU. Elle fonctionne sans connexion. Ouvrez-la depuis sa tuile de l’accueil, ou par Aller ▸ Visionneuse Cube (⌘4). - [Portail : les sessions](https://docs.verbinal.com/fr/06-portal-sessions.md): Portail est votre bureau sur la plateforme scientifique CANFAR : la charge de la plateforme, votre stockage, vos sessions (calepins Jupyter, bureaux, CARTA, Firefly et applications contribuées), les images qu’elles exécutent, et vos tâches en lot. Il faut être connecté. Ouvrez-le depuis sa tuile de l’accueil, ou par Aller ▸ Portail (⌘5). - [Portail : les tâches en lot](https://docs.verbinal.com/fr/07-batch-jobs.md): Une tâche en lot (une session *headless*, sans interface) exécute une seule commande dans un conteneur sur CANFAR, sans fenêtre, puis se termine : réduire une nuit de données, faire tourner un pipeline, lancer plusieurs copies d’un script en parallèle. Vous la lancez, vous partez, et vous lisez ce qu’elle a écrit une fois finie. Les tâches en lot demandent d’être connecté et utilisent votre allocation CANFAR. - [Découverte d’images et registre](https://docs.verbinal.com/fr/08-image-discovery.md): CANFAR exécute vos sessions et vos tâches dans des images de conteneur, et une image ne dit pas, de l’extérieur, ce qu’elle contient. La Découverte d’images regarde à l’intérieur : elle lance une petite tâche de sonde dans une image, liste ses paquets Python, R, système et du SE, et garde la liste sur votre Mac ; vous trouvez ainsi l’image qui a ce qu’il vous faut avant de la lancer. La recherche dans le registre ajoute des images que le catalogue de la plateforme ne liste pas. Il faut être connecté pour l’une et l’autre. - [Stockage (VOSpace)](https://docs.verbinal.com/fr/09-storage.md): Stockage est votre espace de stockage CANFAR (VOSpace), le même que vos sessions et vos tâches en lot voient sous `/arc/home/`. Parcourez-le, téléversez et téléchargez des fichiers, créez des dossiers, et gardez privés vos fichiers privés. Il faut être connecté. Ouvrez-le depuis sa tuile de l’accueil, ou par Aller ▸ Stockage (⌘6). - [Calcul à distance](https://docs.verbinal.com/fr/10-remote-compute.md): Le Calcul à distance exécute du Python ou du Bash sur CANFAR, dans une seule session de votre propre compte nommée `verbinal-compute`, et garde chaque exécution avec sa sortie. Vous y exécutez du code depuis cet écran, et votre assistant IA y exécute le sien avec son outil `run_code`. La session utilise vos cœurs, n’a ni shell ni réseau entrant, et écrit ses résultats dans votre stockage. Il faut être connecté ; ouvrez-le depuis sa tuile de l’accueil. - [Flux de travail](https://docs.verbinal.com/fr/11-workflows.md): Un flux de travail est un protocole de recherche sous forme de liste de contrôle : les étapes d’un travail, dans l’ordre, chacune avec ce qu’il faut faire et la partie de Verbinal qui le fait. Verbinal fournit des modèles pour les travaux courants ; copiez-en un pour le suivre, ou écrivez le vôtre. Les flux de travail sont gardés sur ce Mac et fonctionnent sans connexion. Ouvrez-les depuis leur tuile de l’accueil, ou par Aller ▸ Flux de travail. - [Travailler avec un assistant IA](https://docs.verbinal.com/fr/12-ai-assistant.md): Un assistant IA, comme Claude, peut travailler dans Verbinal avec vous : chercher dans l’archive, télécharger et ouvrir des observations, lire vos sessions et votre stockage, exécuter du code sur CANFAR, et vous faire visiter la fenêtre. Il le fait par le Model Context Protocol (MCP), que Verbinal parle. Vous décidez si un assistant peut se connecter et ce qu’il peut faire sans demander, et vous pouvez lire tout ce qu’il a fait. - [Guide IA](https://docs.verbinal.com/fr/13-ai-guide.md): Le Guide IA est ce qui est dit à chaque assistant IA quand il se connecte à Verbinal : vos propres consignes permanentes, et la description de chacun des outils de Verbinal. À vous de le façonner. Ouvrez-le depuis sa tuile de l’accueil, ou par Aller ▸ Guide IA (⌘7). - [Réglages](https://docs.verbinal.com/fr/14-settings.md): Ouvrez les réglages avec ⌘, ou le bouton en forme d’engrenage de la barre d’outils. Ils comptent huit sections ; chacune est décrite ici avec tous ses réglages. Les réglages sont à vous seul : un assistant IA peut en lire certains, jamais les modifier. - [Confidentialité et vos données](https://docs.verbinal.com/fr/15-privacy.md): Verbinal n’a pas de serveur à lui. Il ne collecte rien sur vous, n’envoie rien à son développeur, et n’a ni statistiques d’usage, ni pistage, ni publicité. Vos données restent sur votre Mac, ou vont aux services du CADC et de CANFAR que vous utilisez, en HTTPS. - [Dépannage](https://docs.verbinal.com/fr/16-troubleshooting.md): Quand quelque chose ne fonctionne pas, la barre d’activité au bas de la fenêtre est le premier endroit où regarder : elle dit ce que fait Verbinal, ce qui a échoué et pourquoi. Cliquez dessus pour la liste Activité. - [Raccourcis clavier et menus](https://docs.verbinal.com/fr/a-shortcuts-and-menus.md): Chaque menu de Verbinal, et chaque raccourci clavier, selon l’endroit où il fonctionne. Les menus que Verbinal partage avec toutes les apps Mac (Édition, Fenêtre) fonctionnent comme d’habitude. - [Glossaire](https://docs.verbinal.com/fr/b-glossary.md): ## Optional - [The whole manual in one file](https://docs.verbinal.com/llms-full.txt) - [Connecting an AI agent to Verbinal](https://github.com/szautkin/canfar-macos/blob/main/AGENTS.md)