Skip to content

Installation

Install SlideGen on your system using one of the methods below.

Requirements

  • Python 3.9 or higher
  • pip (Python package manager)

Installation Methods

Install from PyPI using pip:

pip install slidegen-pptx

Development Installation

For development or to get the latest features:

# Clone the repository
git clone https://github.com/nicolairobles/slidegen
cd slidegen

# Install in editable mode with dev dependencies
pip install -e ".[dev]"

This installs SlideGen in editable mode, so changes to the source code are immediately available.

Verify Installation

Check that SlideGen is installed correctly:

slidegen --version

You should see the version number (e.g., 0.1.0).

Test the CLI:

slidegen --help

Dependencies

SlideGen depends on the following packages:

  • python-pptx>=0.6.21 - PowerPoint file generation
  • pyyaml>=6.0 - YAML parsing
  • jsonschema>=4.17.0 - Schema validation
  • click>=8.1.0 - CLI framework

These are automatically installed when you install SlideGen.

Optional Dependencies

For LLM integration features:

  • openai>=1.0.0 - OpenAI API client
  • fastapi>=0.100.0 - Web framework (for prototype)

For development:

  • pytest>=7.0.0 - Testing framework
  • mypy>=1.0.0 - Type checking
  • ruff>=0.1.0 - Linting

Install with dev dependencies:

pip install -e ".[dev]"

Platform-Specific Notes

macOS

No special requirements. Install using pip as shown above.

Linux

No special requirements. Install using pip as shown above.

Windows

SlideGen works on Windows. If you encounter issues with python-pptx, make sure you have the latest version of pip:

python -m pip install --upgrade pip
pip install slidegen

We recommend using a virtual environment to isolate SlideGen and its dependencies:

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate

# Install SlideGen
pip install slidegen

Upgrading

To upgrade to the latest version:

pip install --upgrade slidegen-pptx

Uninstallation

To uninstall SlideGen:

pip uninstall slidegen-pptx

Troubleshooting

Permission Errors

If you get permission errors, try installing with --user:

pip install --user slidegen

Or use a virtual environment (recommended).

Import Errors

If you get import errors after installation:

  1. Make sure SlideGen is installed: pip show slidegen-pptx
  2. Check your Python version: python --version (should be 3.9+)
  3. Verify the installation path is in your PYTHONPATH

SSL Certificate Issues

If you encounter SSL certificate issues (common on corporate networks):

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org slidegen-pptx

Next Steps

After installation, check out the Quickstart Guide to create your first presentation.