Auditorium 3.5

Python-scripted live presentations

A tour of every primitive — in one deck.

01

Intro

What is Auditorium?

Slides are async def functions
A FastAPI server pushes DOM mutations over WebSocket
The browser is a dumb client — no build step
Themes are stackable CSS files. No JS required.

02

Layouts

Two-Column Layout

Left Column

This is the main content area, taking up two-thirds of the width.

Point A
Point B
Point C

Right Column

This is the sidebar, taking up one-third.

A useful note.

Header / Body / Footer

Fixed Header

This body region stretches to fill the available space.

Add more content and the body grows, but the header and footer stay put.

This is rows(["auto", 1, "auto"]) — the classic flexbox pattern.

Fixed footer — always at the bottom.

Nested Layouts

Top-Left

Top-Right

Bottom (full width)

Rows inside columns inside rows — it all nests cleanly.

03

Animations

Progressive Reveals

Each point appears on keypress:

First, we set up the problem
Then, we explore solutions
Finally, we conclude

Timed Animations

Watch the countdown:

3...

2...

1...

Go!

Mixed Timing Models

Combining keypress and timed reveals:

Loading...

25% complete

50% complete

75% complete

100% — Done!

Press right arrow to continue

Progressive List (Top-Aligned)

New lines appear at the top, pushing down:

First item — reading position stays stable
Second item — no content reflow
Third item — content grows downward
Fourth item — this is what stable_top was for

04

Blocks

Info Blocks

Coloured callouts for the common cases

Note

A neutral aside that doesn't fit the main flow.

Info

Useful background context the reader may not know.

Success

The migration completed; 42 rows updated.

Warning

This API will be deprecated in v3.0.

Error

Connection refused — check that the server is running.

Academic Blocks

For papers, lectures, and seminar talks

Definition 2.1 (Continuity)

A function $f: X \to Y$ is continuous at $x_0$ if for every $\varepsilon > 0$ there exists $\delta > 0$ such that $|x - x_0| < \delta$ implies $|f(x) - f(x_0)| < \varepsilon$ .

Theorem 2.3 (Extreme Value)

Every continuous function on a compact set attains its maximum.

Proof

By compactness, the image $f(K)$ is compact in $\mathbb{R}$ , hence closed and bounded — so $\sup f(K) \in f(K)$ . $\blacksquare$

Example

$f(x) = x^2$ on $[-1, 1]$ attains its max value $1$ at $x = \pm 1$ .

05

Typography

Code Highlighting

from auditorium import Deck

deck = Deck(title="My Talk")

@deck.slide
async def hello(ctx):
    await ctx.md("# Hello, World!")
    await ctx.step()
    await ctx.md("This is **auditorium**.")

Mathematics with KaTeX

Euler's identity:

$e^{i\pi} + 1 = 0$

The Gaussian integral:

$\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}$

Tables

Method	Acc.	F1
Linear	0.81	0.79
Tree	0.86	0.85
MLP	0.89	0.88

Jupyter Display Protocol

ctx.show(obj) honors _repr_html_ / _repr_svg_ / _repr_png_ automatically.

matplotlib

pandas

altair

tesserax

Any Jupyter-aware object works — no adapters, no bundling.

06

Themes

Stackable Themes

Two axes — layout & color — composed by CSS cascade

Layout: simple, academic, comic, compact, minimalist, magazine, terminal

Color: light, dark, neon, print, solarized, pastel, mono

Mix and match: Deck(theme=["academic", "dark"])

Slide Transitions

CSS-only animation, theme-declared

fade — gentle opacity
slide-left — horizontal slide-in
slide-up — vertical lift
zoom — subtle scale-in
none — instant cuts (e.g. for print)

Override per deck with Deck(transition=...) or per run with --transition.

Thank You

Built with Auditorium 3.5

github.com/apiad/auditorium