LoopPPT

A Loop Engineering-powered PPT generation product, not a one-shot prompt wrapper.

LoopPPT is a local LAN web app that turns PPT generation into a persistent, observable, and recoverable execution loop. It uses an already logged-in coding-agent CLI such as Claude Code, OpenCode, Cursor Agent, Codex CLI, Gemini CLI, or Trae Agent to generate editable PowerPoint decks.

Instead of expecting one perfect prompt to produce one perfect deck, LoopPPT continuously prepares context, constrains the design, executes generation, validates artifacts, repairs failures, and resumes stalled work until the delivery contract is satisfied.

Built Around Loop Engineering

LoopPPT treats the model as one component inside a controlled engineering loop:

flowchart LR
    A["User request + source files"] --> B["Prepare structured context"]
    B --> C["Plan content + apply template constraints"]
    C --> D["Coding-agent CLI generates editable PPTX"]
    D --> E["Validate structure, layout, and artifacts"]
    E -->|Pass| F["Preview + deliver"]
    E -->|Needs repair| C
    D -->|Stalled| G["Adaptive heartbeat"]
    G --> C

Loading

• Persistent state: every job keeps its request, source notes, plan, generated files, logs, and template snapshot.
• Explicit contracts: the bundled pipeline defines required artifacts and editable PPTX output expectations.
• Feedback loops: validators turn layout and artifact failures into repair signals instead of silently accepting weak output.
• Continuation over restart: adaptive heartbeats nudge stalled agent sessions to continue from existing work.
• Model independence: the loop can run through multiple supported coding-agent CLIs without coupling the product to one model provider.
• Human observability: users see understandable workflow progress, previews, history, and downloadable results.

Product Preview

LoopPPT gives ordinary users a focused chat interface while keeping template selection, workflow progress, per-slide previews, history, and diagnostics available around the generation loop.

Example of a generated editable deck after planning, generation, validation, and repair:

Core Features

Chat-to-PowerPoint

Users describe the presentation they need, upload source material, and choose a template in a simple chat-oriented interface. LoopPPT turns the request into an editable .pptx, shows understandable workflow progress, and provides per-slide previews and downloads.

Supported source documents include Markdown, text, Word, PDF, PowerPoint, Excel, and CSV. Logos, screenshots, product images, and other visual assets can be uploaded separately for the agent to use. After generation, users can request targeted slide revisions without rebuilding the whole deck.

Reusable PPT Templates

Admins can upload existing .pptx or .potx files and turn them into reusable generation templates. LoopPPT extracts visual rules such as:

• Colors, typography, and page dimensions
• Cover and content-page layout regions
• Image and logo placement rules
• Design constraints and prohibited patterns

Each template can use either a strict master-reference mode or a looser style-reference mode. Templates can be named, described, tagged, reordered, and deleted from the admin interface.

Editable Output With Visual QA

The result is a real editable PowerPoint deck, not a collection of slide screenshots. Before delivery, LoopPPT validates required artifacts, slide dimensions, JSON planning files, off-canvas text, obvious overlaps, and other common generation failures.

When validation finds a repairable problem, the agent receives the failure signal and continues improving the existing work. Successful jobs include browser-based per-slide previews so users can inspect the deck before downloading it.

Reliable Multi-User LAN Service

LoopPPT is designed for teams sharing one service inside a local network:

• Local accounts, roles, passwords, and personal job history
• Persistent task queue with limited concurrency and visible queue position
• Cancellation, timeouts, and interrupted-job recovery after service restarts
• Template snapshots that protect running jobs from later template changes
• Admin settings for users, templates, and preferred execution agent

Agent-Agnostic Execution

LoopPPT uses an already installed and logged-in coding-agent CLI as its reasoning and execution engine. It can auto-detect or explicitly select Claude Code, Codex CLI, Gemini CLI, OpenCode, Cursor Agent, or Trae Agent.

The product keeps orchestration, templates, job state, validation, previews, and recovery inside LoopPPT. Changing the execution agent does not change the user workflow.

Adaptive Recovery Loop

Long-running generation is observable and recoverable. If an OpenCode session stops making useful progress, LoopPPT uses step-aware heartbeat timing learned from historical runs to nudge the same session forward from its existing artifacts. It does not immediately discard the work and restart from zero.

Generation Flow

1. The user submits a request, documents, visual assets, and a template.
2. LoopPPT prepares structured source notes and an isolated job workspace.
3. The selected coding agent plans and generates an editable PowerPoint.
4. Validators inspect the output and feed repair signals back into the loop.
5. LoopPPT prepares per-slide previews and delivers the completed deck.

Quick Start

Requirements: Node.js 22+, Python 3, and at least one supported coding-agent CLI that is already logged in.

git clone https://github.com/NimaChu/loop-ppt.git
cd loop-ppt
npm run start:lan

Windows users can run start-lan.bat; macOS users can run start-lan.command. The launcher prepares dependencies, builds the app when needed, creates the initial admin account, and prints the local and LAN access addresses.

Default first-run account: admin / ppt-agent-admin. Change the password after signing in.