DeckForge

https://github.com/whatsonyourmind/deckforge
Admin
DeckForge is an API-first presentation generation platform featuring 32 slide types, 24 chart types,...
Tokens:39,589
Snippets:428
Trust Score:5.4
License:MIT
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install and Login to Fly CLI

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Steps to install the Fly CLI and authenticate your account for deployment.

```bash
# 1. Install Fly CLI
curl -L https://fly.io/install.sh | sh

# 2. Login and launch
fly auth login
fly launch --name deckforge-api --region iad
```

--------------------------------

### Test SDK Installation in a New Project

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/npm-publish.md

Steps to test the installation and basic usage of the @deckforge/sdk package in a fresh project environment.

```bash
mkdir /tmp/test-sdk && cd /tmp/test-sdk
npm init -y
npm install @deckforge/sdk
node -e "const { DeckForge } = require('@deckforge/sdk'); console.log('OK')"
```

--------------------------------

### Quick Start: Generate a Presentation

Source: https://github.com/whatsonyourmind/deckforge/blob/master/sdk/README.md

Generate a professional PowerPoint deck with a few lines of TypeScript code. This example demonstrates creating a presentation with a title and bullet points, then rendering it.

```typescript
import { DeckForge, Presentation, Slide } from '@lukastan/deckforge';

const df = new DeckForge({ apiKey: 'dk_live_...' });

const pptx = await df.render(
  Presentation.create('Q4 Results')
    .theme('corporate-blue')
    .addSlide(Slide.title({ title: 'Q4 2026', subtitle: 'Board Presentation' }))
    .addSlide(Slide.bullets({
      title: 'Key Metrics',
      items: ['Revenue +23% YoY', 'EBITDA $4.2M', 'NRR 118%'],
    }))
    .build()
);

console.log(pptx.download_url); // https://deckforge-api.onrender.com/v1/files/...
```

--------------------------------

### Start Local Development Services

Source: https://github.com/whatsonyourmind/deckforge/blob/master/CLAUDE.md

Use this command to start all necessary services for local development, including the API, workers, PostgreSQL, Redis, and MinIO.

```bash
docker compose up -d
```

--------------------------------

### Install DeckForge TypeScript SDK

Source: https://github.com/whatsonyourmind/deckforge/blob/master/landing/llms.txt

Install the DeckForge TypeScript SDK using npm.

```bash
npm install @lukastan/deckforge
```

--------------------------------

### Copy Environment Configuration

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Copy the example environment file to a new file for local development configuration. This file contains default settings that work out of the box.

```bash
cp .env.example .env
```

--------------------------------

### Start Docker Compose Services

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Initiate all six services defined in the Docker Compose file for local DeckForge development.

```bash
# Start all 6 services
docker compose up -d
```

--------------------------------

### Manual SDK Publishing Steps

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/npm-publish.md

A sequence of commands to manually publish the SDK package. This includes installing dependencies, running tests, type checking, building, and finally publishing to npm.

```bash
cd sdk

# 1. Install dependencies
npm ci

# 2. Run tests
npm test

# 3. Type check
npm run typecheck

# 4. Build
npm run build

# 5. Publish (requires npm login)
npm publish --provenance --access public
```

--------------------------------

### Install AutoGen Dependencies

Source: https://github.com/whatsonyourmind/deckforge/blob/master/growth/integrations/README.md

Install the necessary Python packages for using DeckForge with AutoGen.

```bash
# AutoGen
pip install autogen-agentchat httpx
```

--------------------------------

### Setup Stripe Products, Prices, and Webhook

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/deployment.md

Uses a Python script to configure Stripe for DeckForge, creating products, prices, and a webhook endpoint. Requires setting the Stripe secret key.

```bash
# Install stripe CLI package
pip install stripe

# Set your Stripe test key
export STRIPE_SECRET_KEY=sk_test_...

# Run setup (test mode by default)
python scripts/setup-stripe.py

# Or specify a custom webhook URL
python scripts/setup-stripe.py --webhook-url https://deckforge-api.fly.dev/v1/billing/webhook

# For live mode (production)
export STRIPE_SECRET_KEY=sk_live_...
python scripts/setup-stripe.py --live
```

--------------------------------

### Install DeckForge for Claude/MCP

Source: https://github.com/whatsonyourmind/deckforge/blob/master/growth/integrations/README.md

Install the DeckForge package for use with Claude Desktop/MCP. No extra dependencies are needed.

```bash
# Claude/MCP (no extra deps -- uses DeckForge MCP server)
pip install deckforge
```

--------------------------------

### Install LangChain Dependencies

Source: https://github.com/whatsonyourmind/deckforge/blob/master/growth/integrations/README.md

Install the necessary Python packages for using DeckForge with LangChain.

```bash
# LangChain
pip install langchain-core httpx
```

--------------------------------

### Troubleshoot Database Connection Refused

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/deployment.md

Guides on verifying PostgreSQL attachment and connection URL correctness. Also provides a command to connect to the database.

```bash
fly secrets list --app deckforge-api | grep DATABASE
```

```bash
fly postgres connect --app deckforge-db
```

--------------------------------

### Deckforge Theme Structure Example

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/superpowers/specs/2026-03-28-deckforge-design.md

Shows the YAML structure for defining a theme, including colors, typography, spacing, shapes, and slide masters.

```yaml
Each theme defines: colors (palette + semantic + chart_series), typography (families, weights, tracking, modular scale), spacing (margins, gaps, grid), shapes (radius, shadow, dividers), and slide_masters (per-slide-type defaults).
```

--------------------------------

### TypeScript SDK Client Initialization

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/superpowers/specs/2026-03-28-deckforge-design.md

Example of initializing the DeckForge client using an API key. The SDK provides a fluent builder API and typed methods for interacting with the DeckForge service.

```TypeScript
import { DeckForge } from "@deckforge/sdk";

const df = new DeckForge({
  apiKey: "dk_live_<hex>",
  // Optional: specify base URL if not using production
  // baseUrl: "http://localhost:8000",
});
```

--------------------------------

### List Available Themes

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Retrieve a list of all available presentation themes by sending a GET request to the /v1/themes endpoint.

```bash
curl http://localhost:8000/v1/themes
```

--------------------------------

### LangChain DeckForge Integration

Source: https://github.com/whatsonyourmind/deckforge/blob/master/growth/integrations/README.md

Example of integrating DeckForge render and generate tools into a LangChain agent.

```python
from deckforge_langchain import DeckForgeRenderTool, DeckForgeGenerateTool
tools = [DeckForgeRenderTool(), DeckForgeGenerateTool()]
agent = create_react_agent(llm, tools)
```

--------------------------------

### Generate Presentation with cURL

Source: https://github.com/whatsonyourmind/deckforge/blob/master/landing/index.html

Examples of using cURL to interact with the DeckForge API. Includes generating from a prompt, rendering an IR payload, and listing available themes. Also shows how to make x402 payments.

```bash
# Generate a presentation from a prompt
curl -X POST https://deckforge-api.onrender.com/v1/generate \
  -H "X-API-Key: $DECKFORGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ 
    "prompt": "Q3 2026 earnings for ACME Corp",
    "slide_count": 12,
    "theme": "executive_dark"
  }'

# Render an IR payload to PPTX
curl -X POST https://deckforge-api.onrender.com/v1/render \
  -H "X-API-Key: $DECKFORGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '@presentation.json' \
  --output deck.pptx

# List available themes
curl https://deckforge-api.onrender.com/v1/discovery/themes \
  -H "X-API-Key: $DECKFORGE_API_KEY"

# x402 payment (AI agents -- no API key needed)
curl -X POST https://deckforge-api.onrender.com/v1/render \
  -H "Content-Type: application/json" \
  -H "X-Payment: <x402-payment-header>" \
  -d '@presentation.json'

```

--------------------------------

### Set x402 Machine Payments Configuration

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/deployment.md

Enables and configures x402 machine payments, including the wallet address. Requires prior wallet setup as detailed in the x402 setup documentation.

```bash
fly secrets set \
  DECKFORGE_X402_ENABLED=true \
  DECKFORGE_X402_WALLET_ADDRESS="0x..." \
  --app deckforge-api
```

--------------------------------

### Install MCP Publisher Tool

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/MCP_REGISTRY_PUBLISH.md

Download and extract the MCP publisher tool for Linux/macOS using curl, or download from releases for Windows/Git Bash.

```bash
# Linux/macOS: curl install; Windows/Git Bash: download from releases
curl -L https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr A-Z a-z)_amd64.tar.gz | tar -xz
```

--------------------------------

### Publish DeckForge to PyPI

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/MCP_REGISTRY_PUBLISH.md

Use this command to build and upload your Python package to PyPI. Ensure you have build and twine installed and your PyPI API token is configured.

```bash
# From SlideMaker repo root
python -m pip install --upgrade build twine
python -m build
python -m twine upload dist/* \
    --username __token__ \
    --password <PYPI_API_API_TOKEN>
```

--------------------------------

### Generate Presentation with Python httpx

Source: https://github.com/whatsonyourmind/deckforge/blob/master/landing/index.html

Use the Python httpx library to interact with the DeckForge API for generating presentations. This example shows how to generate from a prompt and poll for job completion.

```python
import httpx
import os

API_KEY = os.environ["DECKFORGE_API_KEY"]
BASE_URL = "https://deckforge-api.onrender.com"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

# Generate from natural language
resp = httpx.post(
    f"{BASE_URL}/v1/generate",
    headers=headers,
    json={
        "prompt": "Q3 2026 earnings for ACME Corp",
        "slide_count": 12,
        "theme": "executive_dark",
    },
)
job = resp.json()
print(f"Job: {job['job_id']} -- {job['status']}")

# Poll for completion
result = httpx.get(
    f"{BASE_URL}/v1/jobs/{job['job_id']}",
    headers=headers,
)
print(f"Download: {result.json()['download_url']}")

```

--------------------------------

### AutoGen DeckForge Integration

Source: https://github.com/whatsonyourmind/deckforge/blob/master/growth/integrations/README.md

Example of registering DeckForge functions for use with AutoGen agents.

```python
from deckforge_autogen import generate_presentation, render_presentation
assistant.register_for_llm()(generate_presentation)
user_proxy.register_for_execution()(generate_presentation)
```

--------------------------------

### Configure MCP Servers for DeckForge

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/generate-powerpoint-from-json-or-prompt-api-mcp.md

This JSON configuration specifies how to run the DeckForge MCP server locally using Python. It defines the command and arguments needed to start the server.

```json
{
  "mcpServers": {
    "deckforge": {
      "command": "python",
      "args": ["-m", "deckforge.mcp.server"]
    }
  }
}
```

--------------------------------

### Generate Presentation with TypeScript SDK

Source: https://github.com/whatsonyourmind/deckforge/blob/master/landing/index.html

Use the DeckForge TypeScript SDK to generate a presentation from a natural language prompt or build it programmatically using a typed builder. Requires API key setup.

```typescript
import { DeckForge } from '@lukastan/deckforge';

const df = new DeckForge({ apiKey: process.env.DECKFORGE_API_KEY });

// Generate from natural language
const deck = await df.generate({
  prompt: 'Q3 2026 earnings for ACME Corp',
  slideCount: 12,
  theme: 'executive_dark',
});

// Or build with the typed builder
const ir = df.presentation('Q3 Earnings')
  .addSlide(df.slides.title({ title: 'ACME Corp Q3 2026' }))
  .addSlide(df.slides.chart({
    title: 'Revenue Trend',
    chart: df.charts.bar({
      categories: ['Q1', 'Q2', 'Q3'],
      series: [{ name: 'Revenue', values: [1.2, 1.8, 2.4] }],
    }),
  }))
  .build();

const pptx = await df.render(ir);
console.log(`Deck ready: ${pptx.downloadUrl}`);

```

--------------------------------

### Initialize Database

Source: https://github.com/whatsonyourmind/deckforge/blob/master/CLAUDE.md

Run this script to set up the database, including applying migrations, seeding the admin user, and generating a test API key.

```bash
bash scripts/bootstrap-db.sh
```

--------------------------------

### List Available Slide Types

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Retrieve a list of all available slide types, including example Intermediate Representation (IR), by sending a GET request to the /v1/slide-types endpoint.

```bash
curl http://localhost:8000/v1/slide-types
```

--------------------------------

### Presentation Builder API

Source: https://github.com/whatsonyourmind/deckforge/blob/master/sdk/README.md

Create a presentation using the immutable builder API. Start with `Presentation.create()`, chain methods to add themes and slides, and call `.build()` to get the final presentation object.

```typescript
import { Presentation } from '@lukastan/deckforge';

const ir = Presentation.create('Annual Review')
  .theme('executive-dark')
  .language('en')
  .addSlide(/* ... */)
  .addSlide(/* ... */)
  .build();
```

--------------------------------

### Install CrewAI Dependencies

Source: https://github.com/whatsonyourmind/deckforge/blob/master/growth/integrations/README.md

Install the necessary Python packages for using DeckForge with CrewAI.

```bash
# CrewAI
pip install crewai crewai-tools httpx
```

--------------------------------

### Bump Version, Tag, and Push for SDK

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/npm-publish.md

Steps to manually prepare for an automated SDK publish. This involves changing the version, creating a git tag, and pushing the changes.

```bash
cd sdk

# 1. Bump the version (choose: patch, minor, or major)
npm version patch   # 0.1.0 -> 0.1.1
npm version minor   # 0.1.0 -> 0.2.0
npm version major   # 0.1.0 -> 1.0.0

# 2. Create a git tag matching the sdk-v* pattern
git tag sdk-v$(node -p "require('./package.json').version")

# 3. Push the commit and tag
git push origin main --tags
```

--------------------------------

### Deploy DeckForge Application on Fly.io

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/DEPLOY_FLYIO.md

Navigate to the project directory, create the Fly.io app, set necessary secrets for various services (database, Redis, S3, Stripe, Unkey, LLM), deploy the application, and run database migrations. Finally, verify the deployment with a health check.

```bash
cd /path/to/deckforge

# Create the app (first time only)
fly apps create deckforge-api

# Set secrets
fly secrets set \
  DECKFORGE_DATABASE_URL="postgresql+asyncpg://user:pass@host/deckforge" \
  DECKFORGE_REDIS_URL="redis://host:6379" \
  DECKFORGE_S3_ENDPOINT="https://your-r2.r2.cloudflarestorage.com" \
  DECKFORGE_S3_ACCESS_KEY="your-key" \
  DECKFORGE_S3_SECRET_KEY="your-secret" \
  DECKFORGE_S3_BUCKET="deckforge-prod" \
  DECKFORGE_STRIPE_SECRET_KEY="rk_live_..." \
  DECKFORGE_STRIPE_WEBHOOK_SECRET="whsec_..." \
  DECKFORGE_UNKEY_ROOT_KEY="unkey_..." \
  DECKFORGE_UNKEY_API_ID="api_..." \
  DECKFORGE_LLM_DEFAULT_PROVIDER="anthropic" \
  ANTHROPIC_API_KEY="sk-ant-..." \
  DECKFORGE_SECRET_KEY="$(openssl rand -hex 32)"

# Deploy
fly deploy

# Run migrations
fly ssh console -C "alembic upgrade head"

# Verify
curl https://deckforge-api.fly.dev/v1/health
```

--------------------------------

### Run Migrations on Production

Source: https://github.com/whatsonyourmind/deckforge/blob/master/CLAUDE.md

Connect to the production environment via Fly.io SSH and execute database migrations using Alembic.

```bash
fly ssh console -C "alembic upgrade head"
```

--------------------------------

### Get Pricing Information

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Retrieves current pricing and tier information.

```APIDOC
## GET /v1/pricing

### Description
Current pricing and tier info.

### Method
GET

### Endpoint
/v1/pricing

### Auth
No
```

--------------------------------

### Get Job Status

Source: https://github.com/whatsonyourmind/deckforge/blob/master/landing/index.html

Polls for the status of a previously submitted generation job.

```APIDOC
## GET /v1/jobs/{job_id}

### Description
Retrieves the status and download URL for a specific generation job.

### Method
GET

### Endpoint
/v1/jobs/{job_id}

### Parameters
#### Path Parameters
- **job_id** (string) - Required - The ID of the job to query.

### Response
#### Success Response (200)
- **job_id** (string) - The ID of the job.
- **status** (string) - The current status of the job.
- **download_url** (string) - The URL to download the generated presentation.
```

--------------------------------

### Provision Redis on Fly.io

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Instructions to create a Redis instance on Fly.io and obtain the connection URL.

```bash
# 4. Provision Redis (via Upstash or Fly Redis)
fly redis create --name deckforge-redis
# Copy the REDIS_URL from output
```

--------------------------------

### CrewAI DeckForge Integration

Source: https://github.com/whatsonyourmind/deckforge/blob/master/growth/integrations/README.md

Example of integrating the DeckForge tool into a CrewAI agent.

```python
from deckforge_crewai import DeckForgeTool
presenter = Agent(role="Presenter", tools=[DeckForgeTool()])
```

--------------------------------

### Enable x402 and Set Wallet Address (Local Development)

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/x402-setup.md

Configure DeckForge for local development by enabling the x402 payment protocol and setting the USDC receiving wallet address in a .env file.

```bash
# Add to .env file
DECKFORGE_X402_ENABLED=true
DECKFORGE_X402_WALLET_ADDRESS=0xYOUR_WALLET_ADDRESS
```

--------------------------------

### List Slide Types

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Retrieves a list of available slide types along with examples.

```APIDOC
## GET /v1/slide-types

### Description
List slide types with examples.

### Method
GET

### Endpoint
/v1/slide-types

### Auth
No
```

--------------------------------

### Render Demo Deck using cURL

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Use this cURL command to render a demo deck from a local development server. Ensure you replace YOUR_KEY_HERE with your actual API key.

```bash
curl -X POST http://localhost:8000/v1/render \
  -H "Authorization: Bearer dk_test_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d @demos/mckinsey-strategy/ir.json \
  --output mckinsey-strategy.pptx
```

--------------------------------

### Run SDK Tests

Source: https://github.com/whatsonyourmind/deckforge/blob/master/CLAUDE.md

Navigate to the SDK directory and run its tests using Vitest.

```bash
cd sdk && npm test
```

--------------------------------

### Enable x402 and Set Wallet Address (Production)

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/x402-setup.md

Configure DeckForge for production by enabling the x402 payment protocol and setting the USDC receiving wallet address using Fly.io secrets.

```bash
fly secrets set \
  DECKFORGE_X402_ENABLED=true \
  DECKFORGE_X402_WALLET_ADDRESS="0xYOUR_WALLET_ADDRESS" \
  --app deckforge-api
```

--------------------------------

### TypeScript SDK Streaming Generation

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/superpowers/specs/2026-03-28-deckforge-design.md

Example of using the `generate.stream()` method to receive progress events asynchronously during deck generation.

```TypeScript
const stream = df.generate.stream({
  prompt: "A presentation about AI",
  model: "claude-3-opus-20240229",
});

for await (const progress of stream) {
  console.log(progress.status, progress.progress);
  // e.g., 'generating_outline', 0.2
}
```

--------------------------------

### Provision PostgreSQL on Fly.io

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Commands to create and attach a PostgreSQL database instance for your Fly.io deployment.

```bash
# 3. Provision PostgreSQL
fly postgres create --name deckforge-db --region iad
fly postgres attach deckforge-db
```

--------------------------------

### TypeScript SDK Presentation Creation

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/superpowers/specs/2026-03-28-deckforge-design.md

Demonstrates creating a new presentation using the fluent builder pattern in the TypeScript SDK. Includes adding slides and elements.

```TypeScript
const presentation = await Presentation.create(df, {
  title: "My Awesome Deck",
  theme: "modern",
});

await presentation.addSlide(Slide.TitleSlide({
  title: "Introduction",
  subtitle: "Welcome to DeckForge",
}));

await presentation.addSlide(Slide.ContentSlide({
  title: "Key Features",
  bullets: [
    "Fluent Builder API",
    "Typed Endpoints",
    "Auto-generated Types",
  ],
}));

await presentation.addSlide(Slide.ChartSlide({
  title: "Usage Growth",
  chart: Elements.LineChart({
    // ... chart data and options
  }),
}));
```

--------------------------------

### Generation Methods

Source: https://github.com/whatsonyourmind/deckforge/blob/master/sdk/README.md

Provides methods for initiating AI-powered content generation from natural language prompts, including starting a generation process and streaming progress.

```APIDOC
## Generation Methods

### Description
Methods for AI-powered content generation from natural language prompts.

| Method | Description |
|---|---|
| `df.generate.start(prompt, opts?)` | Start AI generation from natural language prompt. |
| `df.generate.stream(prompt, opts?)` | Stream generation progress as `AsyncGenerator<ProgressEvent>`. |
```

--------------------------------

### Deploy to Fly.io

Source: https://github.com/whatsonyourmind/deckforge/blob/master/CLAUDE.md

Deploy the application to the Fly.io platform.

```bash
fly deploy
```

--------------------------------

### Configure Testnet Environment Variables

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/x402-setup.md

Set environment variables for x402 payments to use the Base Sepolia testnet, including the network chain ID, wallet address, and enabling the protocol.

```bash
# In .env or fly secrets
DECKFORGE_X402_NETWORK=eip155:84532  # Base Sepolia chain ID
DECKFORGE_X402_WALLET_ADDRESS=0xYOUR_TEST_WALLET
DECKFORGE_X402_ENABLED=true
```

--------------------------------

### Verify DeckForge API Health

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Check if the DeckForge API is running and healthy by sending a GET request to the health endpoint. This confirms the API is accessible.

```bash
curl http://localhost:8000/v1/health
# => {"status":"healthy"}
```

--------------------------------

### User Signup

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Creates a new account and generates an API key for the user.

```APIDOC
## POST /v1/onboard/signup

### Description
Create account and API key.

### Method
POST

### Endpoint
/v1/onboard/signup

### Auth
No
```

--------------------------------

### Build TypeScript SDK

Source: https://github.com/whatsonyourmind/deckforge/blob/master/CLAUDE.md

Navigate to the SDK directory and build the TypeScript SDK using tsup.

```bash
cd sdk && npm run build
```

--------------------------------

### Publish to MCP Registry

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/MCP_REGISTRY_PUBLISH.md

Execute the publish command from your repository's root directory after authentication. The server.json file in the root handles the declarations for PyPI and remote endpoints.

```bash
cd "C:/Users/lukep/Desktop/Projects AI/SlideMaker"
./mcp-publisher publish
```

--------------------------------

### Clone DeckForge Repository

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Clone the DeckForge repository to your local machine. This is the first step to setting up the project.

```bash
git clone https://github.com/Whatsonyourmind/deckforge && cd deckforge
```

--------------------------------

### Set Stripe Billing Secrets

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/deployment.md

Configures Stripe API keys and price IDs for enabling billing features in the DeckForge application. Assumes Stripe setup script has been run.

```bash
fly secrets set \
  DECKFORGE_STRIPE_SECRET_KEY="sk_live_..." \
  DECKFORGE_STRIPE_WEBHOOK_SECRET="whsec_..." \
  DECKFORGE_STRIPE_STARTER_PRICE_ID="price_..." \
  DECKFORGE_STRIPE_PRO_PRICE_ID="price_..." \
  --app deckforge-api
```

--------------------------------

### DeckForge Client Initialization

Source: https://github.com/whatsonyourmind/deckforge/blob/master/sdk/README.md

Initializes the DeckForge client with an API key and optional configuration parameters like base URL, timeout, and retry settings.

```APIDOC
## DeckForge Client Initialization

### Description
Initializes the DeckForge client with an API key and optional configuration parameters.

### Usage
```typescript
import { DeckForge } from '@lukastan/deckforge';

const df = new DeckForge({
  apiKey: 'dk_live_...',        // Required
  baseUrl: 'https://deckforge-api.onrender.com', // Optional
  timeout: 30_000,              // Optional (ms)
  maxRetries: 2,                // Optional
});
```
```

--------------------------------

### Deploy to Fly.io

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Command to deploy your DeckForge application to the Fly.io platform after configuration.

```bash
# 6. Deploy
fly deploy
```

--------------------------------

### Generate a Deck from Natural Language Prompt

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Generate a presentation from a natural language prompt by sending a POST request to the /v1/generate endpoint. Specify the prompt, theme, and desired output format (e.g., pptx). Requires LLM API keys configured in .env.

```bash
curl -X POST http://localhost:8000/v1/generate \
  -H "Authorization: Bearer dk_test_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a 10-slide pitch deck for a B2B SaaS startup in the cybersecurity space, Series A, $2M ARR",
    "theme": "executive-dark",
    "output_format": "pptx"
  }' \
  --output pitch-deck.pptx
```

--------------------------------

### Generate Presentation with DeckForge API

Source: https://github.com/whatsonyourmind/deckforge/blob/master/landing/index.html

Use this cURL command to generate a presentation. Replace 'dk_live_...' with your actual API key. The API returns a job ID to poll for status or use webhooks.

```bash
$ curl -X POST https://deckforge-api.onrender.com/v1/generate \
  -H "X-API-Key: dk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ \
    "prompt": "Q3 earnings presentation for ACME Corp", \
    "slide_count": 12, \
    "theme": "executive_dark" \
  }'
```

```json
{
  "job_id": "job_8f3a...",
  "status": "processing",
  "estimated_seconds": 15
}
```

--------------------------------

### Login to npm

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/npm-publish.md

Logs into your npm account. If the @deckforge scope doesn't exist, the first publish will create it. Ensure your account has publish access to the scope.

```bash
# Login to npm
npm login

# If @deckforge scope doesn't exist yet, the first publish creates it
# Ensure your account has publish access to the org/scope
```

--------------------------------

### Monitor DeckForge Application

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/deployment.md

Provides commands for viewing live logs, checking application status, accessing the Fly dashboard, and SSHing into instances.

```bash
# Live logs
fly logs --app deckforge-api
```

```bash
# Application status and VM info
fly status --app deckforge-api
```

```bash
# Open Fly dashboard in browser
fly dashboard --app deckforge-api
```

```bash
# SSH into a running instance for debugging
fly ssh console --app deckforge-api
```

--------------------------------

### Manage Custom Domain and SSL Certificates

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/deployment.md

Creates and manages SSL certificates for a custom domain. Requires following DNS instructions provided in the output.

```bash
# Add a custom domain
fly certs create deckforge.yourdomain.com --app deckforge-api
```

```bash
# Follow DNS instructions from the output (CNAME to deckforge-api.fly.dev)
fly certs show deckforge.yourdomain.com --app deckforge-api
```

--------------------------------

### Launch Fly App

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/deployment.md

Launches a new Fly.io application with a specified name, region, and configuration. Deployment is deferred to allow for secret configuration.

```bash
fly launch --name deckforge-api --region iad --no-deploy
```

--------------------------------

### DeckForge Client Initialization

Source: https://github.com/whatsonyourmind/deckforge/blob/master/sdk/README.md

Initialize the DeckForge client with your API key. Optional parameters include baseUrl, timeout, and maxRetries for customizing API interactions.

```typescript
import { DeckForge } from '@lukastan/deckforge';

const df = new DeckForge({
  apiKey: 'dk_live_...',        // Required
  baseUrl: 'https://deckforge-api.onrender.com', // Optional
  timeout: 30_000,              // Optional (ms)
  maxRetries: 2,                // Optional
});
```

--------------------------------

### Run DeckForge MCP Server

Source: https://github.com/whatsonyourmind/deckforge/blob/master/landing/llms.txt

Run the DeckForge MCP server using Python.

```bash
python -m deckforge.mcp.server
```

--------------------------------

### Render a Deck from Intermediate Representation (IR)

Source: https://github.com/whatsonyourmind/deckforge/blob/master/README.md

Render a presentation by sending a POST request to the /v1/render endpoint with a JSON payload defining the slides and theme. The output is saved to a PPTX file.

```bash
curl -X POST http://localhost:8000/v1/render \
  -H "Authorization: Bearer dk_test_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q4 Board Update",
    "theme": "corporate-blue",
    "slides": [
      {
        "slide_type": "title_slide",
        "elements": [
          {"type": "title", "content": "Q4 2026 Board Update"},
          {"type": "subtitle", "content": "Acme Corp -- Confidential"}
        ]
      },
      {
        "slide_type": "stats_callout",
        "elements": [
          {"type": "title", "content": "Key Metrics"},
          {"type": "metric", "content": "$4.2M", "label": "ARR"},
          {"type": "metric", "content": "142%", "label": "YoY Growth"},
          {"type": "metric", "content": "94%", "label": "Retention"}
        ]
      }
    ]
  }' \
  --output board-update.pptx
```

--------------------------------

### Configure Custom x402 Facilitator URL (Advanced)

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/x402-setup.md

Set a custom x402 facilitator URL for payment verification and settlement in a production environment using Fly.io secrets.

```bash
fly secrets set \
  DECKFORGE_X402_FACILITATOR_URL="https://your-facilitator.com" \
  --app deckforge-api
```

--------------------------------

### Run Database Migrations

Source: https://github.com/whatsonyourmind/deckforge/blob/master/docs/DEPLOY_RENDER.md

Execute Alembic database migrations after the initial deployment to set up the database schema. This can be done via the Render shell or by configuring a pre-deploy command.

```bash
alembic upgrade head

```

--------------------------------

### Core Methods

Source: https://github.com/whatsonyourmind/deckforge/blob/master/sdk/README.md

Provides methods for rendering presentations to PPTX or ArrayBuffer, estimating costs, and retrieving job statuses.

```APIDOC
## Core Methods

### Description
Methods for rendering presentations, estimating costs, and managing asynchronous jobs.

| Method | Description |
|---|---|
| `df.render(ir)` | Render a Presentation IR to PPTX. Returns `RenderResult` with `download_url`. |
| `df.renderToBuffer(ir)` | Render and download as `ArrayBuffer`. |
| `df.estimate(ir)` | Estimate credit cost before rendering. Returns `CostEstimate`. |
| `df.getJob(jobId)` | Poll async job status for large presentations. |
```

--------------------------------

### Create Financial Presentation Slides

Source: https://github.com/whatsonyourmind/deckforge/blob/master/sdk/README.md

Utilize the DeckForge SDK to programmatically create presentations with specialized financial slide types such as investment theses, comparable company tables, DCF summaries, and waterfall charts.

```typescript
import { DeckForge, Presentation, Slide, Chart } from '@lukastan/deckforge';

const df = new DeckForge({ apiKey: 'dk_live_...' });

const deck = Presentation.create('Acme Corp - Investment Memo')
  .theme('finance-pro')
  .addSlide(Slide.title({
    title: 'Acme Corp',
    subtitle: 'Investment Committee Memorandum',
  }))
  .addSlide(Slide.investmentThesis({
    title: 'Investment Thesis',
    items: [
      'Market leader in $12B addressable market',
      '30% recurring revenue with 95% net retention',
      'Clear path to 25%+ EBITDA margins by 2028',
    ],
  }))
  .addSlide(Slide.compTable({
    title: 'Public Comparable Companies',
    headers: ['Company', 'EV/Revenue', 'EV/EBITDA', 'P/E'],
    rows: [
      ['Peer A', '8.2x', '22.1x', '35.4x'],
      ['Peer B', '6.5x', '18.3x', '28.7x'],
      ['Peer C', '9.1x', '25.0x', '41.2x'],
      ['Median', '8.2x', '22.1x', '35.4x'],
    ],
  }))
  .addSlide(Slide.dcfSummary({
    title: 'DCF Valuation Summary',
    headers: ['Metric', 'Bear', 'Base', 'Bull'],
    rows: [
      ['Enterprise Value', '$8.2B', '$10.5B', '$13.1B'],
      ['Equity Value', '$6.8B', '$9.1B', '$11.7B'],
      ['Implied Share Price', '$45', '$60', '$78'],
    ],
  }))
  .addSlide(Slide.Slide.waterfallChart({
    title: 'EBITDA Bridge',
    chart: Chart.waterfall({
      categories: ['2025 EBITDA', 'Revenue Growth', 'Cost Savings', 'Investments', '2026E EBITDA'],
      values: [100, 30, 15, -10, 135],
    }),
  }))
  .addSlide(Slide.returnsAnalysis({
    title: 'Returns Analysis',
    headers: ['Scenario', 'IRR', 'MOIC', 'Payback'],
    rows: [
      ['Base', '22%', '2.8x', '4.2 years'],
      ['Upside', '28%', '3.5x', '3.5 years'],
      ['Downside', '14%', '1.8x', '5.8 years'],
    ],
  }))
  .build();

const result = await df.render(deck);
```
Tokens:
Raw