Technical Architecture•Verified System Design

Decoupled multi-agent systems meet deterministic rendering.

We reject the premise that presentation AI should be a single chain-of-thought mega-prompt guessing coordinates. DeckPilotAI orchestrates specialized agents with mathematical layout compilers.

Production technology stack.

Verified components powering DeckPilotAI across backend, database, storage, and presentation compilation.

Python 3.12 + FastAPI

Backend Core

High-performance asynchronous API orchestration handling tenant isolation, prompt parsing, agent scheduling, and WebSocket progress streaming.

Next.js 16 App Router + React 19

Frontend Application

Strict TypeScript browser workspace with optimistic message handling, dual-track agent progress monitoring, and dark-mode glass styling.

Turso Cloud (Edge libSQL / SQLite)

Database Layer

Distributed serverless edge database providing low-latency schema persistence for users, projects, messages, and deck version histories.

Cloudflare R2 + Cloudflare Edge

Storage & CDN

S3-compatible object storage for document attachments and compiled presentations, secured with short-lived presigned expiring URLs.

Deterministic OpenXML (python-pptx)

Presentation Compiler

Mathematical layout compilation into true Microsoft PowerPoint shapes and master templates. Zero rasterized screenshot illusions.

AWS Lightsail Compute

Hosting Infrastructure

Dedicated Linux cloud instance powering background generation jobs, document extraction workers, and isolated memory pipelines.

Specialized Mesh

How our agents collaborate.

Agents receive typed Pydantic inputs and return validated JSON schemas. No agent invents arbitrary pixel coordinates.

01Intent Understanding

Requirements Agent

Deconstructs natural language prompts, detects user goals, audience constraints, and deck scope.

02Document Ingestion

Extraction Agent

Processes PDF briefs, Excel spreadsheets, and DOCX whitepapers to isolate verified claims and tables.

03Minto Narrative Arc

Storyline Agent

Structures presentation chapters using the Minto Pyramid (Situation → Complication → Resolution).

04Layout & Archetypes

Design Intelligence Agent

Maps content to calibrated 16:9 widescreen archetypes, obsidian color tokens, and font pairings.

05124 Checkpoints

QA Gatekeeper Agent

Inspects margin safety, WCAG contrast ratios, shape collisions, and typographic density.

06Self-Healing Loop

Repair Agent

Autonomously repositions overlapping shapes and adjusts font sizes if any QA gate fails.

Quality Assurance Architecture

124 Automated QA checkpoints & self-healing repair.

Before a presentation is delivered, our Quality Assurance Agent executes 124 deterministic inspection checks across the entire slide deck to guarantee executive Polish.

1. Spatial Boundary & Margin SafetyEnsures all text containers, callout chips, and metric tables remain within the 13.333" × 7.5" widescreen canvas boundaries with 0.6" minimum outer margins.
2. Contrast & Visual HierarchyVerifies WCAG 2.2 AA contrast ratios between typography and backgrounds across obsidian dark themes.
3. Automated Shape Collision RepairDetects text container overlaps or vertical crowding and triggers automated font shrinkage and shape re-spacing.
QA Inspection Pass Log124 Checkpoints Evaluated
CP-012: Canvas Widescreen Ratio (16:9)PASSED
CP-034: Text Boundary Margin >= 0.60inPASSED
CP-058: Typography Hierarchy (Lead > Sub > Body)PASSED
CP-089: WCAG AA Luminance Contrast > 4.5:1PASSED
CP-118: Shape Collision Matrix (Zero Overlap)PASSED
Overall Score: 100% • Package Integrity Confirmed
Multi-Model AI Integration

How Foundation Models Power DeckPilotAI.

DeckPilotAI utilizes a decoupled multi-provider routing layer (`app/services/provider_router.py`) that matches specific agents with the optimal foundation model for each subtask.

Within this architecture, leading high-cognition reasoning models are integrated and prioritized for specialized tasks:

  • Minto Pyramid Narrative Strategy: Advanced reasoning models excel at deconstructing complex source documents and formulating logical Situation-Complication-Resolution outlines without missing nuanced business context.
  • Complex Document Synthesis: Ingesting multi-page financial reports or technical specifications requires extended reasoning to extract grounded quantitative takeaways.
  • Executive Headline Copywriting: Transforming passive bullet points into persuasive, boardroom-caliber claims answering the "So What?" for each slide.
Independent Architecture: DeckPilotAI operates an independent, vendor-agnostic routing framework. We prioritize prompt security, low-latency failover, and strict data privacy, ensuring no customer data is ever retained for model training.

Inspect the technology in action.

Launch our live workspace to experience multi-agent presentation generation.