TavlAI Studio on your Mac

The first ten minutes

  1. Open the app. The first time, macOS may say it cannot check the developer. Right-click the app, choose Open, and confirm once. After that it opens like any app.
  2. Pair it with the web studio. Settings, then Support and connection. Paste the key you made on studio.tavlai.no under the same tab, and press Connect. Your courses now mirror between the web and this Mac.
  3. Let the workshop install its tools. Settings, then Workshop, then Install everything. Leave the app open. It fetches Quarto for the notes, TeX for the slides and Claude Code for the drafting, into the app's own folder. TeX takes about fifteen minutes. Nothing else on the Mac changes.
  4. Sign in to Claude Code once. Course, then Model, then Sign in to Claude. It opens a browser page from Anthropic. Your subscription pays for the drafting, on your account.
  5. Make a course. Home, New course, a title. Books: drop a PDF in, tick it, then Build the book index in the library. Drag chapters or sections into sessions. Click a session, answer the eight questions, and press the next step it offers.

Every step after that is one button, in order: draft the plan, read it, approve it, draft the slides, and so on. The button on each session always says what comes next.

Updates

The app checks the web studio once a day. When a new version is ready it says so at the top. Quit and reopen, and you have it. Nothing to download by hand.

For the advanced user

"/Applications/TavlAI Studio.app/Contents/MacOS/TavlAI Studio" pipeline/build_deck.py --course courses/micro101 L1

The scripts live inside the app under Contents/Resources/studio. Or clone the repository and run them with your own Python: the app and the repository are the same code.

Where things are

WhatWhere
your courses~/Library/Application Support/CourseStudio/courses on this Mac, and your workspace on the web studio
the workshop's programs~/Library/Application Support/TavlAI Studio/tools, and TeX under ~/Library/TinyTeX
the speech and search models~/Library/Application Support/TavlAI Studio/models
keysthe macOS Keychain, never a file
the app's log~/Library/Logs/TavlAI Studio.log
the student listoutside everything, in the folder you named in Settings. The app only keeps its path.