gptslideshow

README

gptslideshow

GoSlideShow is a proof-of-concept (POC) command-line tool written in Go. It automates the creation and modification of Google Slides presentations by leveraging Google APIs and OpenAI's language model. The goal is to demonstrate how to interact with an AI based on large language models (LLMs) to generate structured content.

Features

• Generate Slides from Markdown or Audio: Convert Markdown files or audio inputs into structured Google Slides presentations.
• Template Support: Create presentations based on a specified Google Slides template.
• OAuth2 Authentication: Uses Google's OAuth2 for secure API access.
• Structured Output: The model internally uses structured output to organize content effectively. For more information, see Structured Outputs.
• Audio Input Support: Convert audio input via Whisper during a call to OpenAI.
• Image Generation: Optionally generate images for chapter slides using OpenAI's image generation capabilities.

Demo

https://github.com/user-attachments/assets/139fadb1-075c-4e40-9174-5cfa0de737b6

Prerequisites

• Go 1.21 or later
• Google API credentials (credentials.json)
• Access to the Google Slides and Drive APIs
• OpenAI API Key: Set the OPENAI_API_KEY environment variable with your OpenAI API key.

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/goslideshow.git
   cd goslideshow
   

2. Install dependencies:

   Ensure you have the required Go packages installed. You can use Go modules to handle dependencies:

   go mod tidy
   

3. Setup Google API Credentials:

   Place your credentials.json file in the root directory of the project. This file should contain your Google API credentials.

4. Set OpenAI API Key:

   Export your OpenAI API key as an environment variable:

   export OPENAI_API_KEY=your_openai_api_key
   

Usage

Run the program with the following command:

go run main.go -content <path-to-markdown-file> [-t <template-id>] [-id <presentation-id>] [-audio <path-to-audio-file>]

• -content: Path to the Markdown file to convert into slides.
• -t: (Optional) ID of the Google Slides template to use.
• -id: (Optional) ID of an existing presentation to update.
• -audio: (Optional) Path to the audio file to convert into slides.

File Structure

• main.go: The entry point of the application. It handles command-line arguments, initializes services, and orchestrates the creation of slides.
• presentation.go: Contains data structures and functions for generating presentations from Markdown or audio content. It uses OpenAI's API to convert content into slide format.
• google_auth.go: Manages OAuth2 authentication, including token storage and retrieval. It ensures secure access to Google APIs.
• slides_operations.go: Contains functions for interacting with Google Slides, such as copying templates and creating new slides. It handles the insertion of content into slide placeholders.
• util/: Subdirectory containing utilities for querying Google Slides to retrieve information from templates, such as layout IDs for custom templates.

Internal Packages

• internal/ai: Manages interactions with OpenAI's API, including text and image generation.
• internal/gcputils: Provides utilities for Google Cloud Platform operations, including authentication.
• internal/driveutils: Contains functions for handling Google Drive operations, such as uploading images.
• internal/slidesutils: Provides utilities for managing Google Slides operations, including slide creation and modification.
• internal/structure: Defines the data structures used for organizing slide content.

Authentication

The tool uses OAuth2 to authenticate with Google APIs. The first time you run the tool, it will prompt you to visit a URL and authorize the application. The token will be cached for future use.

Disclaimer

This project is a proof-of-concept intended for educational purposes. It demonstrates how to interact with AI models and Google APIs to automate tasks. It is not intended for production use. I will not provide any support for this code.

Contribution

As a POC, I will not make this project evolve. Feel free to use, fork, or modify it as you see fit.

License

This project is licensed under the MIT License.