AI-native presentation generation with Typst and Touying
Turn a topic, document, or URL into a compiled slide deck with a coherent narrative, a fitting
theme, speaker notes, and repeatable quality checks.
English · 简体中文
Tip
Recommended WYSIWYG workspace: Tylina. Tylina is a local-first,
document-first, AI-native WYSIWYG Typst desktop editor. Edit the typeset page directly, connect
your own ACP agent, and keep standard .typ source as the canonical document. The development
preview is available for macOS, Windows, and Linux and requires no account.
SeaSlides is the generation layer: it reads source material, plans the story, selects or creates a theme, authors Typst/Touying, compiles the deck, and checks the deliverables. Tylina turns that output into a WYSIWYG desktop workspace. The typeset page is the editor—not merely a preview: click, select, and type on the rendered deck, then open Source Lens or Split when source-level control is needed.
- WYSIWYG, backed by Typst — edit the final typeset page while the real
.typsource stays in sync. - Bring your own AI agent — connect an ACP agent and give it document context through Skills and MCP.
- A complete Slides workspace — browse thumbnails, edit pages and speaker notes, reorder slides, and present from the same project.
- Local and portable — documents and history stay on your computer, with no proprietary document format or required account.
Download Tylina · Watch the editing demo
Generate with SeaSlides, then inspect, edit, reorder, and present in Tylina.
Tylina also includes a template browser for Tylina Slides and Typst Universe templates, so a new deck can start from an existing visual system instead of rebuilding the design from scratch.
Browse presentation themes and the wider Typst Universe, then open a template as a draft or project.
These overview contact sheets are compiled from the bundled demo.typ files. Click a preview to
open the corresponding theme.
 Cherry · Plain Soft sakura colors, restrained typography, and lightweight components. |
 Midnight · Plain Dark navy foundations, cool accents, and readable technical content. |
 Bauhaus · Rich Geometric components, strong hierarchy, and structured visual rhythm. |
 Data Ink · Rich Charts, tables, metrics, and restrained analytical styling. |
 Polar Expedition · Canvas Expedition-report structure, restrained cartography, and crisp scientific storytelling. |
 Botanical · Canvas Archival botanical detail with an immersive light-and-dark rhythm. |
See the complete theme catalog for all Plain, Rich, Canvas, Builtin, and Universe options.
- Source to slides — PDF, DOCX, PPTX, spreadsheets, EPUB, HTML, URLs, Markdown, or plain text
- 180+ catalogued themes — 14 Plain, 86 Rich, 37 Canvas, 6 Touying built-ins, and 40 community themes
- Two workflows — Quick Mode for a fast usable draft; Full Mode for strategy, research, new assets, or bespoke design
- Typst-native output — readable
.typsource with Touying components and speaker notes - Repeatable quality gates — compilation, per-page PNGs, overview sheet, mechanical checks, validation, and review at the depth you request
- Presentation resources — 50+ chart templates, 15 optional Typst packages, and 6 icon systems
- Optional asset and export tools — AI image generation, licensed web image search, and PPTX export
- More than slide decks — academic posters, CVs, social covers, and other presentation-oriented formats
For Claude Code, Codex, Cursor, and other local agents that support Skills:
npx skills add https://github.com/touying-typ/seaslides --skill seaslides-typst-slides-skillThen give the agent a topic or a source file:
Create a quick 8-slide Typst deck from this Markdown file. Use reasonable defaults.
Turn projects/q3-report/report.pdf into a concise executive presentation and export PDF and PPTX.
Use Full Mode to create a research talk from these notes, with citations and a delivery-grade visual review.
The skill automatically routes between Quick and Full Mode, converts supported source files, selects a theme, compiles the deck, and validates the result.
The command above installs the Skill files. Install the Python dependencies from the installed Skill directory, or clone the full repository below, to use the conversion, compilation, image, and export tools.
Clone the repository when you want the complete scripts, theme library, and local development workflow:
git clone https://github.com/touying-typ/seaslides.git
cd seaslides
python3 -m pip install -r requirements.txtOptional image and search providers are configured through .env:
cp .env.example .envThe Python Typst binding is included in the requirements. A standalone typst CLI is only needed
for direct commands such as typst watch.
| Quick Mode | Full Mode | |
|---|---|---|
| Best for | First usable draft, speed, reasonable defaults | High-stakes delivery, research, new assets, bespoke design |
| Theme | One existing Plain, Rich, or Canvas theme | Existing, extended, or newly designed theme |
| Planning | Concise narrative written directly | Separate content design specification |
| Roles | Direct authoring | Strategist → Image Generator when needed → Executor |
| Visual review | None, targeted, or full—matched to the request | Full workflow, with review depth still honoring the request |
Quick/Full are workflow modes. Plain/Rich/Canvas are theme-complexity tiers; a demonstrated Canvas theme can still be fast in Quick Mode.
Quick: Source → Project → Existing Theme → Author → Compile → [Review] → Export
Full: Source → Project → Theme → Strategist → [Images] → Executor → Compile → Review → Export
The normal publication pipeline produces:
| Artifact | Purpose |
|---|---|
main.typ + template.typ |
Editable Typst/Touying source and project-owned theme |
output/slides.pdf |
Presentation-ready PDF |
output/pngs/slide_XX.png |
One PNG per rendered slide |
output/overview.png |
Contact sheet for fast deck-level review |
output/compile-manifest.json |
Receipt for a coherent compilation run |
output/slides.pptx |
Optional PPTX export through typ2pptx |
Every slide is authored with speaker notes.
SeaSlides chooses by content, audience, and delivery setting rather than mapping every topic to the same style.
| Tier | Use it for |
|---|---|
| Plain | Restrained typography and minimal decoration |
| Rich | Dependable component-based decks, cards, metrics, and structured layouts |
| Canvas | Editorial, Swiss, festival, visual-storytelling, or bespoke page composition |
| Builtin / Universe | Named Touying themes and maintained community packages |
Browse the theme dispatcher, or open the Plain, Rich, and Canvas catalogs.
SKILL_DIR=skills/seaslides-typst-slides-skill
# Create and populate a project
python3 "$SKILL_DIR/scripts/project_manager.py" init my-deck --exact-name
python3 "$SKILL_DIR/scripts/project_manager.py" import-sources projects/my-deck source.pdf --copy
# Compile, audit, and validate
python3 "$SKILL_DIR/scripts/typst_compiler.py" projects/my-deck --all
python3 "$SKILL_DIR/scripts/typst_quality_checker.py" projects/my-deck
python3 "$SKILL_DIR/scripts/validate_project.py" projects/my-deck
# Quick Mode validation omits the separate design specification
python3 "$SKILL_DIR/scripts/validate_project.py" projects/my-deck --mode quick
# Optional PPTX export
python3 "$SKILL_DIR/scripts/typst_compiler.py" projects/my-deck --format pptxFor normal use, ask the agent to run the workflow instead of invoking every command manually.
skills/
seaslides-typst-slides-skill/
SKILL.md # Authoritative workflow and quality contract
workflows/ # Quick, Full, review, research, and theme workflows
references/ # Strategy, execution, design, and Typst standards
scripts/ # Conversion, compilation, validation, and image tools
templates/ # Themes, charts, packages, icons, and schemas
seaslides-html-slides-skill/ # Companion HTML/SVG presentation backend
projects/ # Local generated projects (gitignored)
Start with the main Skill. For implementation details, see the script index, Quick Mode, and the visual-review workflow.
SeaSlides is developed on top of PPT Master by Hugo He. PPT Master established the project foundation: an agent-driven workflow that turns source material into a structured narrative, generates an editable presentation through multiple stages, and checks the result before delivery.
SeaSlides extends that foundation with three major capabilities and architectural changes:
- First-class Typst support. The generation, compilation, review, and export pipeline is built around Typst and Touying, with native PDF, PNG, and PPTX output.
- Separation of templates and content. Reusable visual systems, layout components, and public APIs live in theme files, while presentation-specific narrative and copy remain in the content source. A deck can therefore change themes without rebuilding its content structure, and a theme can be reused across many decks.
- Native Tylina editing. SeaSlides decks can use Tylina's native Typst Slides workspace to open, edit, preview, reorder, and present from the desktop application.
We are grateful to PPT Master for the workflow architecture and implementation foundation that made this project possible.
The HTML presentation portion of SeaSlides was developed with reference to Guizang PPT Skill by Guizang. Its agent-native HTML/CSS generation approach, electronic-magazine compositions, and Swiss editorial visual language informed SeaSlides' HTML-side implementation and design vocabulary.
Typst and Touying provide the typesetting and presentation foundations for SeaSlides' Typst workflow. Please visit and support all of these original projects.
Bug reports, theme requests, and workflow ideas are welcome in GitHub Issues.
Released under the MIT License. Third-party themes, packages, fonts, icons, and media retain their respective licenses.
If you find SeaSlides useful, please cite our paper: SeaSlides: Semantic Abstraction Layer for Agentic Slide Generation.
@misc{fang2026seaslides,
title = {{SeaSlides}: Semantic Abstraction Layer for Agentic Slide Generation},
author = {Shengjun Fang and Chenyang Wu and Zongzhang Zhang},
year = {2026},
eprint = {2608.03298},
archivePrefix = {arXiv},
primaryClass = {cs.AI},
url = {https://arxiv.org/abs/2608.03298}
}