Skip to main content

amagi-deck

Let Claude look at your slides and read the numbers behind your charts. amagi-deck turns a .pptx, .key, .ppt, .odp or slide PDF into one markdown file. Every slide gets a PNG render, its text, its speaker notes, its tables, and each chart's data as a table. Use it to get feedback on a pitch deck, pull figures out of a board deck, or turn a webinar deck into a blog post.

demo

Text converters give a model the words on each slide. amagi-deck also gives it a picture of the slide, so it can comment on layout and design, and the chart values, so it doesn't have to guess them from bar heights. It runs on your machine. Nothing is uploaded, and you don't need an account or an API key.

The same slide rendered by PowerPoint and by the built-in sketch renderer

Install

pipx install amagi-deck

Needs Python 3.9 or newer. For faithful slide images you also need Microsoft PowerPoint (Windows) or LibreOffice (any OS). Without either one, amagi-deck still writes all the text and data and draws a rough sketch of each slide (see Renderers).

Usage

The examples folder holds a made-up 9-slide seed deck for a leak-sensor startup, with one hidden slide. This run was on Windows with PowerPoint installed:

$ amagi-deck pitch-deck.pptx -o review/pitch-deck.md
amagi-deck: wrote review\pitch-deck.md (9 slides, 9 images via powerpoint, 2 charts, 2 tables, 6 with notes)

It wrote review/pitch-deck.md and review/pitch-deck_slides/slide-01.png through slide-09.png. Runs on our Windows test machine took 7 to 15 seconds, most of it PowerPoint rendering the slides. Here is slide 4 of the markdown:

## Slide 4: Traction: 9 months of pilot installs

![Slide 4](pitch-deck_slides/slide-04.png)

- 41 paying buildings
- 3 leaks caught before tenant reports
- 0 churned buildings

**Chart: Pilot installs by quarter** (column (clustered))

| Category | Sensors installed | Paying buildings |
|---|---|---|
| Q1 2026 | 140 | 6 |
| Q2 2026 | 410 | 19 |
| Q3 2026 | 960 | 41 |

**Speaker notes**

> Q3 is through September 30 only.
> The 3 caught leaks are the strongest proof point: tell the Elm Street story.

The full output is in the repo: examples/pitch-deck.md and examples/pitch-deck_slides.

The file starts with a header line that names the renderer and counts slides, hidden slides, notes, charts and tables, followed by an outline. Each slide section can hold:

  • the slide image
  • bullet text, with sub-bullets indented
  • tables and chart data as markdown tables
  • pictures, with their alt text or (no alt text)
  • links and speaker notes

Hidden slides are included and marked (hidden) in their heading.

Options

Flag What it does
-o FILE Markdown file to write. -o - prints to stdout. Default: <deck name>.md in the current folder
--slides 1-3,7 Convert only these slides
--render none Text, notes and chart data only, no images. The sample deck takes under 3 seconds this way
--render powerpoint|soffice|sketch Pick a renderer instead of auto
--width 1280 Slide image width in pixels
--images-dir DIR Where the PNGs go. Default: <output name>_slides next to the markdown
--no-notes Leave speaker notes out, for example before you share the file
--json The same content as JSON

Exit codes: 0 ok, 1 the file could not be read or converted, 2 bad arguments.

Renderers

--render auto (the default) tries PowerPoint, then LibreOffice, then the sketch renderer. A PDF is always rendered page by page with PDFium.

Renderer Needs Images
powerpoint Windows with Microsoft PowerPoint PowerPoint's own export
soffice LibreOffice: soffice on PATH, the default install folder, or AMAGI_DECK_SOFFICE LibreOffice's PDF export, rasterized with PDFium
sketch Nothing A rough drawing: text boxes, pictures, tables and simple bar and line charts. No theme colors, gradients or effects

When a deck falls back to sketch, the markdown header says Slide images: sketch and a note explains why, so a model reading it knows not to judge colors or fine layout. To see what this machine has:

$ amagi-deck --renderers
powerpoint  found (Microsoft PowerPoint via COM)
soffice     not found (install LibreOffice, or set AMAGI_DECK_SOFFICE)
sketch      always available (approximate drawing, not a faithful render)

The LibreOffice path was tested with LibreOffice 25.2 on Linux, with .pptx, .odp and .ppt copies of the sample deck. All 9 slides rendered, the hidden one included.

Use it from Claude

The repo ships a SKILL.md. Copy it to ~/.claude/skills/amagi-deck/SKILL.md and ask Claude something like "review my pitch deck at ~/Downloads/seed.pptx" or "turn slides 3 to 8 of this webinar deck into a blog post." Claude runs amagi-deck into a scratch folder, reads the markdown, and opens the slide images before it comments on design. The skill also tells it to check whether the images are sketches, and to ask before it quotes speaker notes.

How it compares

markitdown (0.1.9) reads a .pptx well: text, tables, notes and chart data. If text is all you need, use it. amagi-deck adds a rendered image of every slide, marks hidden slides, and reads Keynote files and slide PDFs. python-pptx is the library amagi-deck uses to read .pptx files.

Limits

  • Chart numbers come from the data cached inside the .pptx. A chart pasted in as a picture has no data, so only the slide image shows it.
  • A slide PDF has no speaker notes, and its charts and tables come through as plain text lines. Chart axis labels can show up as bullets. A link is only captured when the URL is visible on the slide.
  • .key, .ppt and .odp files are converted to .pptx first, by LibreOffice (or by PowerPoint for .ppt and .odp). Sub-bullet levels can be lost in that step. LibreOffice's Keynote import does not cover every Keynote feature. If a Keynote deck comes out empty or wrong, export it from Keynote (File > Export To > PowerPoint or PDF) and run that file.
  • Speaker notes often hold private remarks. Use --no-notes before you share the output.

If this saved you time

A star helps other people find it. If a deck converts badly, open an issue and attach the deck if you can share it.

More AmagiLabs tools

Development

pip install -e ".[dev]"
pytest
python examples/make_sample_deck.py   # rebuild examples/pitch-deck.pptx

Tests that need PowerPoint or LibreOffice are skipped on machines that don't have them.

License

MIT. See LICENSE. amagi-deck uses python-pptx (MIT), pypdfium2 (BSD-3-Clause or Apache-2.0), Pillow (MIT-CMU) and lxml (BSD-3-Clause). The sample company, its people and its numbers are made up.

Metadata

Release files for amagi-deck 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for amagi-deck 0.1.0
File Size Uploaded Provenance Actions
amagi_deck-0.1.0.tar.gz 557.7 kB Without provenance Details for amagi_deck-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for amagi-deck 0.1.0
File Interpreter ABI Platform Actions
amagi_deck-0.1.0-py3-none-any.whl Python 3 none any Details for amagi_deck-0.1.0-py3-none-any.whl

Total release size: 583.8 kB

Release files / amagi_deck-0.1.0.tar.gz

Download URL amagi_deck-0.1.0.tar.gz
Size 557.7 kB
Tags Source
SHA-256 checksum
How to use checksums
7b06774f982f2114452bb2da95d84e005668b5925005d7ee81d9c8f6fc6dfac7
BLAKE2b-256 checksum
How to use checksums
524151bb99206074e2d4cbf73705d562344246e4c4083c552550fb627aafd283
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release files / amagi_deck-0.1.0-py3-none-any.whl

Download URL amagi_deck-0.1.0-py3-none-any.whl
Size 26.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7ec898239c6bef33dafdd23abd6760b18d46c943b96ac60dabbb4a33093f2d91
BLAKE2b-256 checksum
How to use checksums
ef528c25e109bd08929ac74df031dbc36ddac9a5c386a64c58cdbc61ffbf4647
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Security for amagi-deck 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page