405 lines
14 KiB
Markdown
405 lines
14 KiB
Markdown
# LandPPT - AI驱动的PPT生成平台
|
||
|
||
[](https://github.com/sligter/LandPPT/stargazers)
|
||
[](https://github.com/sligter/LandPPT/network)
|
||
[](https://github.com/sligter/LandPPT/issues)
|
||
[](LICENSE)
|
||
[](https://www.python.org)
|
||
[](https://fastapi.tiangolo.com)
|
||
[](https://hub.docker.com/r/bradleylzh/landppt)
|
||
[](https://deepwiki.com/sligter/LandPPT)
|
||
|
||
---
|
||
|
||
## 🎯 Open to Opportunities
|
||
|
||
我目前正在寻找 **Agent 开发相关的工作机会**。如果你对我的项目感兴趣，或有合适的岗位/合作机会，欢迎联系我！
|
||
|
||
[](mailto:ai@yydsapp.com)
|
||
|
||
---
|
||
|
||
|
||
[English](README_EN.md) | **中文**
|
||
|
||
---
|
||
|
||
## 📋 目录
|
||
|
||
- [项目简介](#-项目简介)
|
||
- [功能亮点](#-功能亮点)
|
||
- [核心功能](#-核心功能)
|
||
- [快速开始](#-快速开始)
|
||
- [使用指南](#-使用指南)
|
||
- [配置说明](#-配置说明)
|
||
- [API文档](#-api文档)
|
||
- [技术栈](#️-技术栈)
|
||
- [贡献指南](#-贡献指南)
|
||
- [常见问题](#-常见问题)
|
||
- [许可证](#-许可证)
|
||
|
||
## 🎯 项目简介
|
||
|
||
LandPPT 是一个基于大语言模型（LLM）的智能演示文稿生成平台，能够自动将文档内容转换为专业的PPT演示文稿。平台集成了多种AI模型、智能图像处理、深度研究功能和丰富的模板系统，让用户能够轻松创建高质量的演示文稿。
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
## 🌟 功能亮点
|
||
|
||
- **🚀 一键生成**：从主题到完整PPT，全程AI自动化处理
|
||
- **🎨 智能配图**：AI自动匹配最适合的图像，支持多源获取和参考图片生成
|
||
- **🔍 深度研究**：集成多个搜索引擎，获取最新最全面的信息
|
||
- **🎤 演讲稿生成**：智能生成配套演讲稿，支持多种导出格式
|
||
- **👁️ 视觉参考**：AI编辑助手支持图像上传和视觉内容分析
|
||
- **📂 多文件上传**：支持同时上传多个文件，批量处理更高效
|
||
- **⚡ 批量生成**：支持批量生成PPT页面，显著提升生成速度
|
||
- **🎯 模型自定义**：按功能自定义模型选择，精准控制成本
|
||
- **📝 备注导出**：支持将演讲稿导出至PPT备注栏
|
||
- **🖼️ 图片导出**：支持以图片格式导出PPT页面
|
||
- **📱 响应式设计**：完美适配各种设备和屏幕尺寸
|
||
- **🔒 企业级安全**：支持本地部署，数据安全可控
|
||
|
||
## ✨ 核心功能
|
||
|
||
### 🤖 多AI提供商支持
|
||
- **OpenAI GPT系列**：GPT-4o、GPT-4o-mini 等模型
|
||
- **Anthropic Claude**：Claude-4 Sonnet、Claude-4 Haiku 系列模型
|
||
- **Google Gemini**：Gemini-2.5 Flash、Gemini-2.5 Pro 系列模型，支持自定义端点配置
|
||
- **Azure OpenAI**：企业级AI服务，支持自定义部署
|
||
- **Ollama**：本地部署的开源模型，支持 Llama、Mistral 等
|
||
|
||
### 📄 强大的文件处理能力
|
||
- **多格式支持**：PDF、Word、Markdown、TXT、Excel 等多种格式
|
||
- **智能解析**：使用 MinerU 和 MarkItDown 进行高质量内容提取
|
||
- **深度研究**：集成 Tavily API 和 SearXNG 的多源研究功能
|
||
- **内容增强**：自动网页内容提取和智能摘要生成
|
||
|
||
### 🎨 智能图像处理系统
|
||
- **多源图像获取**：本地图库、网络搜索、AI生成三合一
|
||
- **网络图像搜索**：支持 Pixabay、Unsplash 等优质图库
|
||
- **AI图像生成**：集成 DALL-E、SiliconFlow、Pollinations 等服务
|
||
- **智能图像选择**：AI自动匹配最适合的图像内容
|
||
- **图像处理优化**：自动尺寸调整、格式转换、质量优化
|
||
|
||
### 🔍 增强研究功能
|
||
- **多引擎搜索**：Tavily 和 SearXNG 双引擎支持
|
||
- **深度内容提取**：智能网页内容解析和结构化处理
|
||
- **多语言支持**：支持中英文等多语言研究内容
|
||
- **实时信息获取**：获取最新的网络信息和数据
|
||
|
||
### 🎨 丰富的模板系统
|
||
- **全局主模板**：统一的HTML模板系统，支持响应式设计
|
||
- **多样化布局**：AI生成多种创意页面布局和设计风格
|
||
- **场景化模板**：通用、旅游、教育等多种专业场景模板
|
||
- **自定义模板**：支持导入和创建个性化模板
|
||
- **参考图片生成**：AI模板生成支持参考图片，智能匹配设计风格
|
||
|
||
### 📊 完整的项目管理
|
||
- **三阶段工作流**：需求确认 → 大纲生成 → PPT生成
|
||
- **可视化编辑**：直观的大纲编辑器和实时预览
|
||
- **版本管理**：项目历史记录和版本回溯功能
|
||
- **批量操作**：支持批量生成和处理多个项目
|
||
|
||
### 🌐 现代化Web界面
|
||
- **直观操作**：用户友好的响应式Web界面
|
||
- **AI聊天编辑**：侧边栏AI编辑功能，支持实时对话和视觉参考
|
||
- **演讲稿生成**：支持单页/多页/全部幻灯片的演讲稿生成，导出为DOCX/Markdown格式
|
||
- **多格式导出**：PDF/HTML/PPTX 多种格式导出支持
|
||
- **实时预览**：16:9 标准比例的实时页面预览
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 系统要求
|
||
- Python 3.11+
|
||
- SQLite 3
|
||
- Docker (可选)
|
||
|
||
### 本地安装
|
||
|
||
#### 方法一：uv（推荐）
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git clone https://github.com/sligter/LandPPT.git
|
||
cd LandPPT
|
||
|
||
# 安装uv（如果尚未安装）
|
||
# Windows (PowerShell)
|
||
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
|
||
# macOS/Linux
|
||
curl -LsSf https://astral.sh/uv/install.sh | sh
|
||
|
||
# 使用uv同步环境
|
||
uv sync
|
||
|
||
# 安装额外依赖（可选，用于PPTX导出）
|
||
uv pip install apryse-sdk --extra-index-url=https://pypi.apryse.com
|
||
|
||
# 配置环境变量
|
||
cp .env.example .env
|
||
# 编辑 .env 文件，配置你的AI API密钥
|
||
|
||
# 启动服务
|
||
uv run python run.py
|
||
```
|
||
|
||
#### 方法二：传统pip安装
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git clone https://github.com/sligter/LandPPT.git
|
||
cd LandPPT
|
||
|
||
# 创建虚拟环境
|
||
python -m venv venv
|
||
# 激活虚拟环境
|
||
# Windows
|
||
venv\Scripts\activate
|
||
# macOS/Linux
|
||
source venv/bin/activate
|
||
|
||
# 安装依赖
|
||
pip install -e .
|
||
|
||
# 配置环境变量
|
||
cp .env.example .env
|
||
# 编辑 .env 文件，配置你的AI API密钥
|
||
|
||
# 启动服务
|
||
python run.py
|
||
```
|
||
|
||
### Docker部署
|
||
|
||
#### 使用预构建镜像（推荐）
|
||
|
||
```bash
|
||
# 拉取最新镜像
|
||
docker pull bradleylzh/landppt:latest
|
||
|
||
# 运行容器
|
||
docker run -d \
|
||
--name landppt \
|
||
-p 8000:8000 \
|
||
-v $(pwd)/.env:/app/.env \
|
||
-v landppt_data:/app/data \
|
||
-v landppt_reports:/app/research_reports \
|
||
-v landppt_cache:/app/temp \
|
||
bradleylzh/landppt:latest
|
||
|
||
# 查看日志
|
||
docker logs -f landppt
|
||
```
|
||
|
||
> **注意**: 确保在运行前创建并配置好 `.env` 文件，包含必要的API密钥。
|
||
|
||
|
||
## 📖 使用指南
|
||
|
||
### 1. 访问Web界面
|
||
启动服务后，访问以下地址：
|
||
- **Web界面**: http://localhost:8000
|
||
- **API文档**: http://localhost:8000/docs
|
||
- **健康检查**: http://localhost:8000/health
|
||
|
||
(初始账号`admin`密码`admin123`)
|
||
|
||
### 2. 配置AI提供商
|
||
在设置页面配置你的AI API密钥：
|
||
- OpenAI API Key
|
||
- Anthropic API Key
|
||
- Google API Key
|
||
- 302.AI API Key
|
||
- 或配置本地Ollama服务
|
||
|
||
### 3. 创建PPT项目
|
||
1. **需求确认**：输入主题、选择受众、设置页数范围、选择场景模板
|
||
2. **大纲生成**：AI智能生成结构化大纲，支持可视化编辑
|
||
3. **内容研究**：可选择启用深度研究功能，获取最新相关信息
|
||
4. **图像配置**：配置图像获取方式（本地/网络/AI生成）
|
||
5. **PPT生成**：基于大纲生成完整的HTML演示文稿
|
||
|
||
### 4. 编辑和导出
|
||
- 使用AI聊天功能实时编辑内容和样式，支持图像上传进行视觉参考
|
||
- 支持图像替换和优化，AI模板生成可参考上传的图片
|
||
- 生成配套演讲稿，支持单页/多页/全部幻灯片模式
|
||
- 导出为PDF、HTML、PPTX、演讲稿DOCX/Markdown格式
|
||
- 保存项目版本和历史记录
|
||
- 支持批量处理和模板复用
|
||
|
||
## 🔧 配置说明
|
||
|
||
### 环境变量配置
|
||
|
||
主要配置项（详见 `.env.example`）：
|
||
|
||
```bash
|
||
# AI提供商配置
|
||
DEFAULT_AI_PROVIDER=openai
|
||
OPENAI_API_KEY=your_openai_api_key_here
|
||
ANTHROPIC_API_KEY=your_anthropic_api_key_here
|
||
GOOGLE_API_KEY=your_google_api_key_here
|
||
GOOGLE_BASE_URL=https://generativelanguage.googleapis.com # 自定义Gemini端点
|
||
|
||
# 服务器配置
|
||
HOST=0.0.0.0
|
||
PORT=8000
|
||
SECRET_KEY=your-secure-secret-key
|
||
|
||
# 研究功能配置
|
||
TAVILY_API_KEY=your_tavily_api_key_here # Tavily 搜索引擎
|
||
SEARXNG_HOST=http://localhost:8888 # SearXNG 实例地址
|
||
RESEARCH_PROVIDER=tavily # 研究提供商：tavily, searxng, both
|
||
|
||
# 图像服务配置
|
||
ENABLE_IMAGE_SERVICE=true # 启用图像服务
|
||
PIXABAY_API_KEY=your_pixabay_api_key_here # Pixabay 图库
|
||
UNSPLASH_ACCESS_KEY=your_unsplash_key_here # Unsplash 图库
|
||
SILICONFLOW_API_KEY=your_siliconflow_key_here # AI图像生成
|
||
POLLINATIONS_API_TOKEN=your_pollinations_token # Pollinations AI
|
||
|
||
# 导出功能配置
|
||
APRYSE_LICENSE_KEY=your_apryse_key_here # PPTX导出
|
||
|
||
# 生成参数
|
||
MAX_TOKENS=8192
|
||
TEMPERATURE=0.7
|
||
```
|
||
|
||
## 📚 API文档
|
||
|
||
启动服务后访问：
|
||
- **Swagger UI**: `http://localhost:8000/docs`
|
||
- **ReDoc**: `http://localhost:8000/redoc`
|
||
|
||
## 🛠️ 技术栈
|
||
|
||
### 后端技术
|
||
- **FastAPI**: 现代化的Python Web框架，支持异步处理
|
||
- **SQLAlchemy**: ORM数据库操作，支持多种数据库
|
||
- **Pydantic**: 数据验证和序列化，类型安全
|
||
- **Uvicorn**: 高性能ASGI服务器
|
||
|
||
### AI集成
|
||
- **OpenAI**: GPT-4o、GPT-4o-mini 等最新模型
|
||
- **Anthropic**: Claude-3.5 系列模型
|
||
- **Google AI**: Gemini-1.5 系列模型
|
||
- **LangChain**: AI应用开发框架和工具链
|
||
- **Ollama**: 本地模型部署和管理
|
||
|
||
### 文件处理
|
||
- **MinerU**: 高质量PDF智能解析和结构化提取
|
||
- **MarkItDown**: 多格式文档转换（Word、Excel、PowerPoint等）
|
||
- **BeautifulSoup4**: HTML/XML解析和处理
|
||
|
||
### 图像处理
|
||
- **Pillow**: 图像处理和格式转换
|
||
- **OpenAI DALL-E**: AI图像生成
|
||
- **SiliconFlow**: 国产AI图像生成服务
|
||
- **Pollinations**: 开源AI图像生成平台
|
||
|
||
### 研究功能
|
||
- **Tavily**: 专业搜索引擎API
|
||
- **SearXNG**: 开源元搜索引擎
|
||
- **HTTPX**: 异步HTTP客户端
|
||
- **Playwright**: 网页内容提取
|
||
|
||
### 导出功能
|
||
- **Playwright**: HTML转PDF高质量导出
|
||
- **Apryse SDK**: 专业PPTX生成和转换
|
||
|
||
## 🤝 贡献指南
|
||
|
||
我们欢迎所有形式的贡献！
|
||
|
||
### 如何贡献
|
||
1. Fork 本仓库
|
||
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
|
||
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
|
||
4. 推送到分支 (`git push origin feature/AmazingFeature`)
|
||
5. 开启 Pull Request
|
||
|
||
详情请见 [贡献指南](CONTRIBUTING.md)。
|
||
|
||
### 报告问题
|
||
如果你发现了bug或有功能建议，请在 [Issues](https://github.com/sligter/LandPPT/issues) 页面创建新的issue。
|
||
|
||
## ❓ 常见问题
|
||
|
||
### Q: 支持哪些AI模型？
|
||
A: 支持 OpenAI GPT(兼容)、Anthropic Claude、Google Gemini、Azure OpenAI 和 Ollama 本地模型。可以在配置页面切换不同的AI提供商。
|
||
|
||
### Q: 如何配置图像功能？
|
||
A: 在 `.env` 文件中配置相应的API密钥：
|
||
- Pixabay: `PIXABAY_API_KEY`
|
||
- Unsplash: `UNSPLASH_ACCESS_KEY`
|
||
- AI生成: `SILICONFLOW_API_KEY` 或 `POLLINATIONS_API_TOKEN`
|
||
|
||
### Q:在使用反向代理（如Nginx、Apache等）时，如果没有正确配置`base_url`，会出现以下问题：
|
||
- 图片链接仍然显示为`localhost:8000`
|
||
- 前端无法正确加载图片
|
||
- 图片预览、下载等功能异常
|
||
|
||
A: 通过Web界面配置
|
||
|
||
1. 访问系统配置页面：`https://your-domain.com/ai-config`
|
||
2. 切换到"应用配置"标签页
|
||
3. 在"基础URL (BASE_URL)"字段中输入您的代理域名
|
||
4. 例如：`https://your-domain.com` 或 `http://your-domain.com:8080`
|
||
5. 点击"保存应用配置"
|
||
|
||
### Q: 研究功能如何使用？
|
||
A: 配置 `TAVILY_API_KEY` 或部署 SearXNG 实例，然后在创建PPT时启用研究功能即可自动获取相关信息。
|
||
|
||
### Q: 支持本地部署吗？
|
||
A: 完全支持本地部署，可以使用 Docker 或直接安装。支持 Ollama 本地模型，无需依赖外部API。
|
||
|
||
### Q: 如何导出PPTX格式？
|
||
A: 需要配置 `APRYSE_LICENSE_KEY`，然后在导出选项中选择PPTX格式。
|
||
|
||
### Q: 并行生成会影响PPT质量吗？
|
||
A: 不会。并行生成只是改变了生成顺序，每页的生成逻辑和质量保持不变。
|
||
|
||
### Q: 所有AI提供商都支持批量生成吗？
|
||
A: 大多数AI提供商支持并发请求，但可能有不同的限制。建议查看您使用的AI服务的API文档。
|
||
|
||
## 📄 许可证
|
||
|
||
本项目采用 Apache License 2.0 许可证。详情请见 [LICENSE](LICENSE) 文件。
|
||
|
||
## Star History
|
||
|
||
[](https://www.star-history.com/#sligter/LandPPT&Date)
|
||
|
||
## 📞 联系我们
|
||
|
||
- **项目主页**: https://github.com/sligter/LandPPT
|
||
- **问题反馈**: https://github.com/sligter/LandPPT/issues
|
||
- **讨论区**: https://github.com/sligter/LandPPT/discussions
|
||
- **交流群**: https://t.me/+EaOfoceoNwdhNDVlsh
|
||
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
**如果这个项目对你有帮助，请给我们一个 ⭐️ Star！**
|
||
|
||
Made with ❤️ by the LandPPT Team
|
||
|
||
</div> |