Visual guide and walkthroughs
Watch the Keating 4.0 launch film, the narrated introduction, and walkthroughs of every layer: classroom, terminal UI, onboarding, CLI artifacts, and the surface tour.
On this page
1. Keating 4.0 and the surface tour
Keating is organized into multiple interconnected surfaces, each designed for a different aspect of independent study, pedagogical verification, and course creation. You can move seamlessly between the browser classroom, the terminal, and command-line compilation.
Start with the 4.0 launch film. It covers the Socratic lesson, learner-owned models and data, GPT Live voice sessions, local recall, independent reviews, and the terminal. Then watch the silent surface tour for the parts of Keating that are not the chat box. Every beat is a capture of the real component.
- Simulate: move a control in the base-rate simulation and watch the chart redraw.
- Code: write a TypeScript solution in the code lab and run the sample tests.
- Speak: record a pronunciation attempt and compare it with the target.
- Recall: review flashcards on a spaced schedule.
- Exam: sit a timed exam, flag questions, and review the grading.
- Plan: follow a nested study plan with linked lessons.
- Sessions: search past sessions without losing fork ancestry.
- Desktop: run a local workspace with real files and processes.
2. Web classroom and interactive OpenUI
The browser classroom is Keating's primary conversational space. Unlike conventional chatbots that return monolithic walls of text or opaque answers, Keating teaches Socratically: it reasons in the open, identifies the edge of your understanding, and hands back the next question worth answering.
As conversations progress, Keating streams typed OpenUI interface documents directly into the response stream. These include conversational Question checks, multi-session StudyPlan checklists, visual ConceptMap diagrams, and persistent SharedNotes that survive across turns.
- Visible reasoning: see how the model constructs its pedagogical next step before delivering it.
- Socratic prompts: Keating asks for predictions and explanations in your own words rather than handing over rote answers.
- Typed OpenUI widgets: interactive Question cards with classification, matching, multiple-choice, and open-ended responses.
- Session rail: search, fork, rename, or resume previous learning branches at any time.
3. Terminal UI and branching dialogue
For learners who prefer working directly in the terminal, Keating provides a full-featured OpenTUI client (keating tui). It connects to the same underlying Pi runtime, preserving all prompts, skills, and session state while offering a dense, keyboard-first environment.
The terminal interface includes a responsive sidepanel, mouse and keyboard selection for cloud and local models, action rows, custom ASCII portraits, and a live visual session tree showing every branch and fork of your conversation.
- Layered sidepanel: toggle sessions, model selection, thinking depth, and focus mode with single keystrokes.
- Fork tree: branch off any previous turn to explore alternative hypotheses without losing the original conversation.
- ASCII-safe rendering: full compatibility with standard terminal emulators, tmux, and SSH sessions.
- Instant /shell switch: drop into the raw Pi extension shell at any time while retaining active session state.
4. First minute and profile onboarding
Keating is designed to be immediately usable without initial credential friction. When launching the terminal client for the first time, an onboarding wizard introduces you to the system's layout and controls before you ever configure an API key.
You can configure your learner handle, select a generated pixel portrait, choose initials, or link a local avatar image. The onboarding flow then walks through panel toggling, model inspection, and focus shortcuts.
- Local-first identity: learner handles and avatars are stored in local configuration, not on remote servers.
- Zero-credential preview: test layout, controls, and help menus before entering cloud provider keys.
- Custom portraits: choose between procedural pixel art, monogram initials, or local image paths.
5. Deterministic pedagogy and CLI artifacts
Beneath the conversational interface lies Keating's deterministic pedagogy layer. Rather than leaving lesson plans and concept relationships to unconstrained model hallucination, Keating compiles learning topics into structured, inspectable files.
Using the keating CLI, you can generate lesson plans, compile Mermaid concept graphs, build Hyperframes animated explanation bundles, and run Chain-of-Verification (CoVe) fact checks. All artifacts are saved under .keating/outputs/ where they can be versioned and reviewed.
- keating plan: creates a deterministic pedagogical sequence balancing intuition, formal structure, and transfer.
- keating map: turns the plan into an inspectable Mermaid knowledge graph with clear prerequisite dependencies.
- keating animate: selects a scene grammar and emits a self-contained Hyperframes visual explanation bundle.
- keating verify: executes a Chain-of-Verification check against the core claims before teaching begins.
keating plan "Special Relativity"
keating map "Special Relativity"
keating animate "Special Relativity"
keating verify "Special Relativity"6. Hyperteacher architecture and narrated film
Keating is designed as a Socratic AI scaffold for people who still want to own their understanding. The narrated introduction below walks through ten real screens: how onboarding asks the way you learn, what the learner profile remembers, sources you can open, simulations, fieldwork away from the screen, timed recall, word-order practice, an honestly graded exam, and the apps you can take anywhere.
Alongside the introduction, the interactive tutorial walkthrough demonstrates the complete guided learning flow: from initial inquiry to progressive hint generation, concept mapping, and knowledge transfer.
- Predict before reveal: test your mental model before the explanation confirms or reframes it.
- Reconstruction in your own words: Keating verifies comprehension by asking you to apply principles to fresh scenarios.
- Branching sessions: fork a question into a sub-investigation without polluting your primary study path.
- Narrated introduction: a Gemini Kore voiceover timed to each screen, with an English caption track.
7. The published metaharness paper and web interface
Keating treats teaching methodology as serious, quotable software engineering. The metaharness paper documents the empirical framework, Socratic prompt architecture, evaluation benchmarks against synthetic learners, and the limits of synthetic scores.
The companion web walkthrough illustrates how the metaharness translates into a fluid browser experience: real-time inspection panels, model selection, live session stats, and verifiable learning traces.
- Published metaharness paper: citation-ready empirical methodology with verifiable study analysis.
- Web classroom: conversational inquiry with live model reasoning and OpenUI cards.
- Review desk annotations: mark teaching turns with Problem, Strength, Suggestion, or Rewrite annotations.
- Multi-surface parity: seamless continuity across web, mobile, desktop, and terminal.
8. Keating 4.0 feature spotlights
Four short narrated films, each on one part of Keating 4.0: judgements you can check, local recall, GPT Live, and the first run with the teacher persona. Each has English captions.
9. Why Keating, a lesson and the changelog
Three shorter films in other shapes: a brand film on what Keating is for, a vertical one-minute lesson that shows the Socratic method at work, and a square 4.0 changelog set to music.