Getting Started

AgentPreso is an AI-native presentation platform built on markdown. Create beautiful presentations using plain text that AI agents can read, write, and edit.

Installation

Install the AgentPreso CLI globally:

# Using bun (recommended)
bun install -g @agentpreso/cli

# Or download the standalone binary
curl -fsSL https://agentpreso.com/install.sh | bash

Verify the installation:

agentpreso --version

Authentication

To use cloud features, log in to your AgentPreso account:

agentpreso login

This opens a browser window where you can authenticate. Your API key is stored locally in ~/.agentpreso/credentials.

Create Your First Deck

Scaffold a new presentation from a template:

agentpreso create my-first-deck

This creates my-first-deck.md with starter content. You can also specify a template:

agentpreso create my-first-deck --template corporate

Edit Your Presentation

Open the markdown file in your favorite editor. AgentPreso presentations are standard markdown with a YAML frontmatter:

---
marp: true
agentpreso:
  template: minimal
paginate: true
---

# Welcome to AgentPreso

Your first AI-native presentation

---

## Slide Two

- Bullet points work as expected
- Add **bold** and *italic* text
- Include `code snippets`

---

## Add a Diagram

```mermaid
graph TD
  A[Start] --> B[Process]
  B --> C[End]

## Preview Your Deck

Start a local development server with hot-reload:

```bash
agentpreso serve my-first-deck.md

This opens your presentation in the browser at http://localhost:3000. Changes to the markdown file are reflected instantly.

Render Your Presentation

Generate the final output:

# HTML (default, works offline)
agentpreso render my-first-deck.md

# PDF
agentpreso render my-first-deck.md --format pdf

# PowerPoint
agentpreso render my-first-deck.md --format pptx

The rendered file is saved in the same directory as your source file.

Push to Cloud

Save your deck to your AgentPreso cloud account:

agentpreso push my-first-deck.md

Now you can access it from anywhere:

# On another machine
agentpreso pull my-first-deck

Next Steps