# pptwise

> A real PowerPoint file. Not a picture of one. Tell your AI what to cover. pptwise builds the deck on your own machine, and every heading, bullet, and chart bar still opens in PowerPoint for you to retype and restyle. The same content makes the same deck every time.

pptwise turns a description into a real PowerPoint file. A model writes a
semantic description of the deck, the engine owns every coordinate, and the
export is native DrawingML: every heading, bullet, and chart bar stays a real,
editable PowerPoint shape. Chart and table figures are the exception, because
the export carries no native chart part: to change those numbers, rebuild the
page. Rendering happens on the user's own machine with no account, no API key,
and no network call.

It installs into an AI agent rather than being run by hand. There is no web app
and no hosted service.

## Installing it

The user hands one sentence to their agent. Which sentence depends on the
harness, and the user picks it, because an agent cannot reliably tell which
harness it is running in.

- Any harness that reads a skill folder (Claude Code, Codex, Grok CLI, and
  friends): Install pptwise following https://raw.githubusercontent.com/liustack/pptwise/main/INSTALL.md, then run the health check and tell me the result.
- DeepSeek Harness, where pptwise is a native plugin instead:
  Install pptwise following https://raw.githubusercontent.com/liustack/pptwise/main/INSTALL-dsh.md, then run the health check and tell me the result.

## What it ships

- 24 built-in themes: academic, arena, campaign, classroom, consulting, crayon, ember, enterprise, heritage, ink, insight, journal, lecture, luxe, memo, museum, playbill, pulse, runway, stage, swiss, tech, terra, vermilion
- 117 layouts across cover, chapter, content, and ending pages
- 37 component types, from bullets and charts to SWOT, Gantt, Sankey, and
  people cards
- Deterministic output: the same description and seed render the same bytes
- MIT licensed, no watermark, commercial use fine

## Links

- [Repository, README, and full docs](https://github.com/liustack/pptwise)
- [Install guide, skill-folder harnesses](https://raw.githubusercontent.com/liustack/pptwise/main/INSTALL.md)
- [Install guide, DeepSeek Harness](https://raw.githubusercontent.com/liustack/pptwise/main/INSTALL-dsh.md)
- [Agent skill, the workflow pptwise teaches](https://github.com/liustack/pptwise/blob/main/skills/pptwise/SKILL.md)
- [CLI reference](https://github.com/liustack/pptwise/blob/main/docs/cli.md)
- [Deck description format](https://github.com/liustack/pptwise/blob/main/docs/ir.md)
- [Themes](https://github.com/liustack/pptwise/blob/main/docs/themes.md)
- [中文说明](https://pptwise.com/zh)
- [npm package](https://www.npmjs.com/package/@liustack/pptwise)