agentigslide

module

v1.3.0 Latest Latest Go to latest Published: May 7, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/owulveryck/agentigslide

Links

Open Source Insights

README ¶

AgentiGSlide

Generateur automatique de presentations Google Slides a partir d'un template et d'une demande en texte libre ou markdown. Le systeme utilise Claude (via Vertex AI) pour analyser un template, puis selectionner et remplir les slides adaptees a chaque demande.

Prerequis

Go 1.25+
Un projet Google Cloud avec l'API Vertex AI activee
Un template Google Slides
gcloud CLI installe et configure

Quickstart

1. Authentification

gcloud auth login
gcloud auth application-default login

2. Configuration

export SLIDES_TEMPLATE_ID="<id-de-la-presentation-template>"
export VERTEX_PROJECT_ID="<id-projet-gcp>"

3. Analyser le template (une seule fois)

make template

Execute les trois phases d'analyse : extraction des donnees depuis Google Slides, analyse par Claude Vision, construction de l'index cherchable.

4. Compiler les outils

make

5. Generer une presentation

bin/slidegen --file request.md

Le fichier request.md contient la demande en texte libre ou markdown.

Chaque outil supporte -h pour afficher toutes les variables d'environnement et les flags disponibles.

Pipeline

Le workflow se decompose en trois phases principales, suivies d'une phase optionnelle :

Analyse -- extraction et analyse par IA vision du template (make template)
Planification -- selection des slides et du contenu par Claude
Production -- duplication du template et application des modifications via les API Google
Post-production (optionnelle) -- correction automatique du formatage (polices, tailles, espacements)

slidegen execute les phases 2 et 3 en un seul appel. Le mode --agent utilise un pipeline multi-agent (Outliner/Selector/Writers/Reviewer).

Voir docs/architecture.md pour le detail de chaque phase.

Utilisation de slidegen

# Generation standard
bin/slidegen --file request.md

# Pipeline multi-agent
bin/slidegen --agent --file request.md

# Dashboard de suivi en temps reel
bin/slidegen --agent --monitor --file request.md

# Reprendre a partir d'un plan sauvegarde
bin/slidegen --plan plan.json

# Afficher le prompt sans executer
bin/slidegen --dump --file request.md

Structure du projet

analysis/              Extraction des donnees brutes depuis Google Slides API
analyzeSlides/         Analyse par Claude Vision (Vertex AI)
buildTemplateIndex/    Construction de template_index.json
slidegen/              Flux tout-en-un (planification + production)
generateSlideList/     Generation du plan de slides (JSON)
applySlideList/        Application d'un plan pour creer la presentation
fixfonts/              Post-production : correction automatique du formatage
mcp-server/            Serveur MCP (Model Context Protocol)
markdown/              Parsing markdown et generation de requetes Google Slides
internal/              Packages partages (config, vertex, auth, pipeline, agent...)
template/              Donnees extraites du template
docs/                  Documentation d'architecture et diagrammes

Licence

MIT -- voir LICENSE.

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
analysis Command analysis fetches all slides from a Google Slides presentation and saves each slide's raw API content as a JSON file and its visual preview as a PNG image.	Command analysis fetches all slides from a Google Slides presentation and saves each slide's raw API content as a JSON file and its visual preview as a PNG image.
analyzeSlides Command analyzeSlides uses Claude Vision via Vertex AI to analyze specific slides from a Google Slides template.	Command analyzeSlides uses Claude Vision via Vertex AI to analyze specific slides from a Google Slides template.
applySlideList Command applySlideList creates a Google Slides presentation from a presentation plan JSON file.	Command applySlideList creates a Google Slides presentation from a presentation plan JSON file.
buildTemplateIndex Command buildTemplateIndex aggregates analysis.json files from all analyzed slides into a single template_index.json.	Command buildTemplateIndex aggregates analysis.json files from all analyzed slides into a single template_index.json.
fixfonts Command fixfonts detects and corrects formatting issues in a Google Slides presentation using AI vision analysis.	Command fixfonts detects and corrects formatting issues in a Google Slides presentation using AI vision analysis.
generateSlideList Command generateSlideList generates a structured presentation plan JSON from a user request.	Command generateSlideList generates a structured presentation plan JSON from a user request.
internal
agent
auth Package auth provides authentication helpers for Google APIs and Vertex AI.	Package auth provides authentication helpers for Google APIs and Vertex AI.
config Package config provides shared configuration structs loaded from environment variables using the kelseyhightower/envconfig library.	Package config provides shared configuration structs loaded from environment variables using the kelseyhightower/envconfig library.
fixfonts Package fixfonts detects and corrects formatting issues in Google Slides presentations.	Package fixfonts detects and corrects formatting issues in Google Slides presentations.
model Package model defines the data types used throughout the AgentiGSlide system.	Package model defines the data types used throughout the AgentiGSlide system.
monitor
pipeline Package pipeline provides the shared presentation generation logic used by both the slidegen CLI and the MCP server.	Package pipeline provides the shared presentation generation logic used by both the slidegen CLI and the MCP server.
plan Package plan provides functions for loading template indexes, building compact index representations for Claude prompts, and enriching AI-generated slide plans into fully resolved presentation plans ready for execution against the Google Slides API.	Package plan provides functions for loading template indexes, building compact index representations for Claude prompts, and enriching AI-generated slide plans into fully resolved presentation plans ready for execution against the Google Slides API.
slides Package slides provides helper functions for working with Google Slides API page structures.	Package slides provides helper functions for working with Google Slides API page structures.
templateindex Package templateindex provides business logic for building a searchable template index from analyzed Google Slides.	Package templateindex provides business logic for building a searchable template index from analyzed Google Slides.
vertex Package vertex provides a client for calling Anthropic Claude models through Google Cloud Vertex AI endpoints.	Package vertex provides a client for calling Anthropic Claude models through Google Cloud Vertex AI endpoints.
markdown Package markdown converts markdown-formatted text into Google Slides API requests.	Package markdown converts markdown-formatted text into Google Slides API requests.
mcp-server Command mcp-server exposes the slidegen presentation generation pipeline as an MCP (Model Context Protocol) server.	Command mcp-server exposes the slidegen presentation generation pipeline as an MCP (Model Context Protocol) server.
slidegen Command slidegen is the full pipeline for generating a Google Slides presentation from a markdown file.	Command slidegen is the full pipeline for generating a Google Slides presentation from a markdown file.