autoppt 0.3.0

Generate Professional Presentations in Seconds using AI

AutoPPT 🚀

Generate Professional Presentations in Seconds using AI.

AutoPPT combines the power of advanced LLMs (OpenAI, Anthropic, Google) with real-time web research to create structured, researched, and visually styled PowerPoint presentations automatically.

---

✨ Features

• 🧱 Hierarchical Sectioning: Structures content into logical sections and chapters.
• 🎨 8 Visual Themes: Technology, Nature, Creative, Minimalist, Corporate, Academic, Startup, Dark.
• 🤖 Research-Driven Content: DuckDuckGo + Wikipedia integration for accurate data.
• 📊 Chart Generation: Automatic bar, pie, line, and column charts.
• 🖼️ Smart Visuals: Integrated image search with intelligent layout.
• 🔌 Multi-Provider Support: OpenAI, Google Gemini, Anthropic Claude.
• 🌐 Web UI: Streamlit-based interface for easy generation.
• 🧪 Mock Provider: Test without API keys using --provider mock.
• 📈 Progress Indicators: Real-time progress bars during generation.
• ✅ Test Coverage: Comprehensive pytest test suite.

🚀 Quick Start

1. Installation

From PyPI:

pip install autoppt

From source:

git clone https://github.com/yeasy/autoppt.git
cd autoppt
pip install .

2. Configuration

cp .env.example .env
# Add your API keys (at least one for real generation)
# OPENAI_API_KEY=sk-...
# GOOGLE_API_KEY=AIza...
# ANTHROPIC_API_KEY=sk-ant-...

3. Usage

Command Line

# Generate with default settings
autoppt --topic "The Future of AI"

# Use Google Gemini with dark theme
autoppt --topic "Planets in Solar System" --provider google --style dark

Web UI

streamlit run autoppt/app.py

Then open http://localhost:8501 in your browser.

🌐 Web Interface

AutoPPT includes a beautiful Streamlit-based web UI:

• Easy Configuration: Select provider, model, theme, and language
• Real-time Progress: See generation progress as it happens
• Direct Download: Download your PPTX immediately after generation
• No Coding Required: Perfect for non-technical users

🛠️ Configuration Options

Flag	Description	Default
--topic	The presentation subject.	Required
--provider	AI backend: openai, google, anthropic, mock.	openai
--model	Specific model name.	Provider default
--slides	Target number of slides.	10
--language	Output language.	English
--style	Visual theme (see below).	minimalist
--output	Custom output file path.	output/<topic>.pptx
-v	Enable debug logging.	false

🎨 Visual Themes

Theme	Style
minimalist	Clean grayscale
technology	Dark blue
nature	Earthy greens
creative	Vibrant colors
corporate	Professional blue
academic	Traditional maroon
startup	Modern orange
dark	Cyan on dark

🧪 Running Tests

# Run all tests
pytest

# Run with coverage report
pytest --cov=autoppt --cov-report=term-missing

# Run specific test file
pytest tests/test_renderer.py -v

📂 Samples

• AI & Technology (CN)
• Healthy Living (CN)
• Renaissance Art (CN)
• AI & Technology (EN)
• Healthy Living (EN)
• Renaissance Art (EN)

🤝 Contributing

1. Fork the repository
2. Create your feature branch: git checkout -b feature/awesome
3. Run tests & safety audit: pytest && python3 scripts/check_sensitive.py
4. Commit changes: git commit -m "feat: Add awesome feature"
5. Push: git push origin feature/awesome
6. Open a Pull Request

📜 License

Apache 2.0 - See LICENSE

📝 Changelog

See CHANGELOG.md