SlideSpark AI - Intelligent Presentation Co-pilot

SlideSpark AI is a powerful cross-platform application that acts as an intelligent co-pilot for creating and editing presentations. It transforms raw text documents into well-structured presentations and provides a chat-based interface for making precise edits.

Features

• Draft-to-Deck: Convert text documents (.docx, .txt) into structured presentations
• AI-Powered Editing: Use natural language commands to edit presentations
• Three-Panel Interface: Structure explorer, AI command console, and live visual preview
• Multi-Provider LLM Support: Choose between OpenAI, Anthropic, and Ollama in real-time
• Context-Aware Editing: Choose between local (single shape) or global (entire presentation) context

Installation

1. Clone the repository:

git clone https://github.com/yourusername/slidespark-ai.git
cd slidespark-ai

2. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Set up environment variables:

cp .env.example .env
# Edit .env with your API keys

Configuration

LLM Provider Setup

SlideSpark AI supports multiple LLM providers. You can switch between providers in real-time using the dropdown in the AI Command Console.

Configure your API keys in the .env file:

Anthropic (Default)

ANTHROPIC_API_KEY=your-api-key-here
ANTHROPIC_MODEL=claude-sonnet-4-20250514

OpenAI

OPENAI_API_KEY=your-api-key-here
OPENAI_MODEL=gpt-4o

Ollama (Local)

OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=qwen3:1.7b

Note: The LLM_PROVIDER environment variable sets the default provider, but users can change it anytime from the UI.

Slide Preview (Optional)

For slide preview functionality, install LibreOffice:

• macOS: brew install --cask libreoffice
• Ubuntu/Debian: sudo apt-get install libreoffice
• Windows: Download from libreoffice.org

If LibreOffice is not installed, the app will show placeholder images instead.

Usage

1. Start the application:

python app.py

2. Open your browser to http://localhost:5030

3. Choose AI Provider (Optional):

   • Select your preferred AI provider from the dropdown in the AI Command Console
   • The app remembers your choice for future sessions

4. Upload a Presentation:

   • Click "Upload Presentation" in the Structure Explorer panel
   • Select a .pptx file

5. Edit with AI:

   • Select a shape in the Structure Explorer
   • Choose context mode (Local or Global)
   • Type your command in the AI Command Console
   • Click "Execute" to apply changes

6. Create from Document:

   • Click "Ingest from Document" in the AI Command Console
   • Upload a .docx or .txt file
   • Review the proposed structure
   • Confirm to generate the presentation

Example Commands

• "Make the title larger and bold"
• "Change the color to blue"
• "Shorten this bullet point"
• "Add a new bullet point about market growth"
• "Make this consistent with other slide titles" (use Global context)

Testing

Run the test suite:

pytest test_app.py

Project Structure

slidespark-ai/
├── app.py                  # Main Flask application
├── llm_provider.py         # LLM provider abstraction
├── presentation_engine.py  # PowerPoint manipulation logic
├── document_processor.py   # Document ingestion logic
├── templates/
│   └── index.html         # Frontend interface
├── static/
│   ├── css/
│   │   └── style.css      # Styling
│   └── js/
│       └── app.js         # Frontend JavaScript
├── test_app.py            # Test suite
├── requirements.txt       # Python dependencies
└── README.md             # This file

API Endpoints

Method	Endpoint	Description
POST	/api/upload/presentation	Upload a .pptx file
POST	/api/upload/document	Upload a document for ingestion
GET	/api/presentation/{id}/structure	Get presentation structure
GET	/api/presentation/{id}/slide/{n}/preview.png	Get slide preview
POST	/api/presentation/{id}/plan	Execute presentation plan
POST	/api/presentation/{id}/edit	Edit a shape

Troubleshooting

LibreOffice not found

• Ensure LibreOffice is installed and soffice is in your PATH
• The app will still work but show placeholder images

LLM API errors

• Check your API keys in the .env file
• Ensure you have sufficient API credits
• For Ollama, ensure the service is running locally

File upload issues

• Maximum file size is 16MB
• Only .pptx, .docx, and .txt files are supported

License

MIT License - see LICENSE file for details