gamma-performance-tuning

name	gamma-performance-tuning
description	Optimize Gamma API performance and reduce latency. Use when experiencing slow response times, optimizing throughput, or improving user experience with Gamma integrations. Trigger with phrases like "gamma performance", "gamma slow", "gamma latency", "gamma optimization", "gamma speed".
allowed-tools	Read, Write, Edit
version	1.13.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","gamma","api","performance"]
compatibility	Designed for Claude Code

Gamma Performance Tuning

Overview

Optimize Gamma API integration performance. Gamma's generate-poll-retrieve pattern means most latency is in generation time (10-60s), not API call overhead. Optimize by: reducing poll overhead, parallelizing batch operations, caching results, and choosing the right generation parameters.

Prerequisites

• Working Gamma integration (see gamma-sdk-patterns)
• Understanding of async patterns
• Redis or in-memory cache (recommended)

Performance Characteristics

Operation	Typical Latency	Notes
POST /generations	200-500ms	Just starts the generation
GET /generations/{id} (poll)	100-300ms	Per poll request
Full generation (poll to completion)	10-60s	Depends on content + cards
GET /themes	100-200ms	Cacheable
GET /folders	100-200ms	Cacheable

Instructions

Step 1: Optimize Poll Strategy

// src/gamma/smart-poll.ts
// Adaptive polling: start fast, slow down over time

export async function smartPoll(
  gamma: GammaClient,
  generationId: string,
  opts = { maxTimeMs: 180000 }
): Promise<GenerateResult> {
  const deadline = Date.now() + opts.maxTimeMs;
  let interval = 2000; // Start at 2s

  while (.() < deadline) {
     result =  gamma.(generationId);

     (result. === )  result;
     (result. === )   ();

    
      ( (r, interval));
    interval = .(interval * , ); 
  }

    ();
}