Turn your material into slides with an AI agent. The agent first writes a short spec (who the talk is for, how it looks, what each slide says), then builds a PowerPoint file or a browser (HTML) presentation from it.
A sample deck made with SDPM: a six-slide introduction to event-driven architecture, in
the bundled aws-light style.
Before building any slide, the agent writes a spec in three parts:
- Brief: who the audience is, what they should take away, and which sources to use.
- Style: the template, colours and fonts, and how slides look. The Web UI shows it as Art Direction.
- Outline: one line per slide, with the slide's claim, what it shows, and where the facts come from.
You can review each part before any slide is built. Then composers (helper agents that build the slides) take over: one composer fixes the layout of every slide, and several composers fill in the slides in parallel. The agent checks the previews and sends fixes back to a composer.
There are two ways to work:
- Fast path: the agent builds a first draft from your material without asking questions.
- Review path: you shape the story with the agent first, and approve the spec before the slides are built.
Describe what you want, and the agent picks the right workflow:
| Ask | What happens |
|---|---|
| "Make slides about β¦" | A new deck: brief β style β outline β slides β review |
| "Make it an HTML deck" | A browser presentation instead of a PPTX |
| "Edit this PPTX" | Imports an existing PPTX into an editable deck |
| "I hand-edited the PPTX, continue from it" | Brings your PowerPoint edits back into the deck (local install only) |
| "Create a style like β¦" | A reusable style: colours, fonts, how slides look |
| "Translate this deck to English" | A copy of the deck in another language; the original stays as it is (PPTX decks, local install only) |
You can give it PDF, Word, Excel and PowerPoint files, text files, images, and URLs.
By default the agent builds a .pptx file that you can edit in PowerPoint. Ask for an HTML
deck and you get a single output.html that runs in any browser, offline, with speaker
notes. HTML slides can include interactive charts.
In the Web UI, turn on the Comment tool, draw a frame around anything on a slide and write what should change. Press Request changes to send all frames at once. The agent sends one composer per slide to make the changes and replies to each comment.
SDPM comes with 15 styles and 2 blank templates. You can use your own .pptx as a template,
and create new styles with AI in the Web UI or by asking your agent. See
Custom templates, styles and assets.
| What it is | What you need | Next step | |
|---|---|---|---|
| Your own AI agent | SDPM runs as an MCP server for the agent you already use (Claude Code, Kiro CLI, Cursor, VS Code, Codex, Claude Desktop). MCP is the protocol AI agents use to call tools. | macOS, Linux or Windows. The installer adds git and uv |
Quick Start |
| The Web UI on your computer | A chat app in your browser, with the spec, the slides and comments side by side. Runs locally, no AWS account. | The installer adds Node.js 20+ and Kiro CLI, which runs the agent | Quick Start, then sdpm webui |
| A team server on AWS | The Web UI and the MCP server deployed in your AWS account, with sign-in through Amazon Cognito. | An AWS account. No local tools for One-Click Deploy | One-Click Deploy |
| Region | Launch |
|---|---|
| Tokyo (ap-northeast-1) |  |
| N. Virginia (us-east-1) | |
| Oregon (us-west-2) | |
The Deploy guide explains the parameters and the other ways to deploy, and Cost Estimates shows what it costs per month.
One command installs SDPM on your computer, into ~/.sdpm:
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/aws-samples/sample-spec-driven-presentation-maker/main/scripts/install/dist/install.sh | bash# Windows (PowerShell; verified in CI only)
irm https://raw.githubusercontent.com/aws-samples/sample-spec-driven-presentation-maker/main/scripts/install/dist/install.ps1 | iexThe installer asks two things: whether to add the browser Web UI, and which of the AI agents
it found on your computer to connect. If tools it needs are missing (such as git, uv or
Node.js), it first asks whether to install them. Then start:
| With | Do this |
|---|---|
| Your AI agent (Claude Code, Cursor, VS Code, Codex) | Ask it "Make slides about β¦". To connect another agent later: sdpm register (restart the agent if it was already open) |
| Kiro CLI | kiro-cli chat --agent sdpm (the installer creates this dedicated agent) |
| Your browser | Run kiro-cli login once, then sdpm webui. Skipped the Web UI at install? sdpm update --with-webui adds it |
| Claude Desktop | Download sdpm.mcpb and double-click it (no installer needed) |
The Web UI runs its agent through Kiro CLI, so kiro-cli login signs you in to Kiro with
GitHub, Google, an AWS Builder ID or your organization's IAM Identity Center. No AWS account
is needed, and Kiro has a free plan (Kiro pricing).
sdpm shows what is installed and connected, sdpm update updates it, and sdpm uninstall
removes it. The launcher goes into ~/.local/bin (on Windows, %USERPROFILE%\bin, which
the installer adds to your PATH); if the installer says that directory is not on your
PATH, add it and open a new terminal. Slide previews need LibreOffice and
poppler; the installer offers them.
The Getting Started guide covers the installer options, each AI agent, and the Web UI.
A hands-on workshop walks you through making slides from URLs, PDFs, CSV files, meeting notes and more. It has scenarios for manufacturing, financial services, healthcare, IT and other industries.
π Workshop
Use it
| Document | What it covers |
|---|---|
| Getting Started | Install, connect your AI agent, use the Web UI, HTML decks |
| Custom Templates, Styles & Assets | Your own .pptx templates, styles and icons |
Run it on AWS for a team
| Document | What it covers |
|---|---|
| Deploy guide | One-Click Deploy and deploying from AWS CloudShell (no local CDK or Docker) |
| Cost Estimates | Monthly cost breakdown and how to stop the fixed charges |
| Security | What the stack sets up and what to review before production |
| Measuring Usage | Tokens and slide counts per user |
| Uninstall | Remove the deployed AWS resources |
Develop or integrate
| Document | What it covers |
|---|---|
| Developer guide | Work from a checkout, deploy with the CDK |
| Architecture | Layers, data flow, auth model, MCP tool reference |
| Connecting Agents | Connect MCP clients and gateways to SDPM |
| Teams & Slack Integration | Use SDPM from chat platforms |
| Web UI | The React Web UI, Local mode and Cloud mode |
| Contributing | How to send a change |
Upgrade from an older version
| Document | What it covers |
|---|---|
| Migration guides | Moving from plugins, skills or uvx setups, and from v0.4 / v0.5 |
| CHANGELOG | Every change, by release |
Contributions are welcome. See CONTRIBUTING.md for the setup and the checks to run.
This project has adopted the Amazon Open Source Code of Conduct.
This is sample code for demonstration and education, not for production use as is. Before you deploy it, review Security with your security and legal teams. To report a potential vulnerability, follow CONTRIBUTING.md instead of opening a public issue.
This project is licensed under the MIT-0 License.