LandPPT：自动生成PPT演示文稿的AI平台

LandPPT是一个基于大型语言模型（LLM）的演示文稿生成平台，它可以将用户提供的文档内容自动转换成设计专业的PPT演示文稿。这个平台的核心作用是简化PPT的制作流程，用户只需要输入主题或上传文档，AI就能生成大纲，并最终制作出完整的演示文稿。它接入了多种主流的AI模型，比如OpenAI的GPT系列、Anthropic的Claude系列以及Google的Gemini系列，同时也支持通过Ollama部署在本地的开源模型。除了AI驱动的内容生成，LandPPT还提供了丰富的模板和样式选项，让用户可以轻松创建符合专业要求的高质量演示文稿，并支持导出为PDF、HTML和PPTX等多种格式，以适应不同的演示场景。

功能列表

• 支持多种AI模型：平台集成了OpenAI、Anthropic、Google、Azure OpenAI以及本地化的Ollama模型，用户可以根据需求选择最合适的AI进行内容生成。
• 强大的文件处理能力：支持直接处理PDF、Word、Markdown和TXT等多种格式的文档，并利用minueru和markitdown等工具智能提取核心内容。
• 深度研究功能：集成了Tavily API，可以根据用户输入的主题进行联网深度研究，确保演示文稿内容的深度和广度。
• 丰富的模板系统：提供统一的全局主模板、由AI生成的多样化创意页面布局，还支持用户导入和创建自定义的个性化模板。
• 完整的项目管理流程：工作流分为三个阶段：需求确认、大纲生成和PPT生成，流程清晰。用户还可以通过可视化编辑器对AI生成的大纲进行修改和确认。
• 现代化的Web操作界面：提供直观易用的Web界面，支持16:9比例的响应式页面实时预览。用户还可以在侧边栏通过AI聊天功能，对演示文稿内容进行实时编辑和调整。
• 支持多种格式导出：用户可以将最终完成的演示文稿导出为PDF、HTML或PPTX文件，方便在不同设备和平台下使用。

使用帮助

LandPPT作为一个功能强大的AI演示文稿生成工具，提供了本地安装和Docker部署两种使用方式，用户可以根据自己的技术背景和需求进行选择。

系统环境要求

在开始之前，请确保您的系统满足以下基本要求：

• Python：3.11或更高版本
• 数据库：SQLite 3
• Docker：(可选) 如果您希望使用容器化部署，则需要安装Docker

方法一：本地安装（推荐使用uv）

对于熟悉Python环境的用户，本地安装是最直接的方式。项目推荐使用uv，这是一个速度很快的Python包安装和管理工具。

第一步：克隆项目代码
打开终端，使用git命令将LandPPT的源代码从GitHub克隆到您的本地电脑。

git clone https://github.com/sligter/LandPPT.git

然后进入项目目录。

cd LandPPT```
**第二步：安装uv**
如果您的系统中还没有安装`uv`，可以根据您的操作系统选择对应的命令进行安装。
- **Windows (使用PowerShell)**:
```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• macOS或Linux:

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

第三步：安装项目依赖
项目依赖项都记录在pyproject.toml文件中。使用uv的sync命令可以快速创建虚拟环境并安装所有必需的包。

uv sync

为了支持PPTX格式的导出，还需要安装Apryse SDK。

uv pip install apryse-sdk --extra-index-url=https://pypi.apryse.com

第四步：配置环境变量
项目需要配置API密钥等敏感信息。您可以从模板文件.env.example复制一份新的配置文件。

cp .env.example .env```
接下来，使用文本编辑器打开`.env`文件，填入您自己的AI API密钥。例如，如果您计划使用OpenAI，就需要填写`OPENAI_API_KEY`。如果需要联网研究功能，则需要填写`TAVILY_API_KEY`。
```ini
# 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
# 功能配置
TAVILY_API_KEY=your_tavily_api_key_here
APRYSE_LICENSE_KEY=your_apryse_key_here # 用于PPTX导出

第五步：启动服务
完成所有配置后，运行以下命令即可启动Web服务。

uv run python run.py

服务启动后，您就可以在浏览器中访问http://localhost:8000来使用LandPPT了。

方法二：使用Docker部署

对于希望简化环境配置的用户，使用Docker是最佳选择。

第一步：拉取预构建的Docker镜像
项目开发者已经将应用打包成Docker镜像并上传到了Docker Hub，您只需要一条命令就可以拉取最新的镜像。

docker pull bradleylzh/landppt:latest

第二步：准备配置文件
与本地安装一样，您仍然需要在主机上创建一个.env文件并填入必要的API密钥。

第三步：运行容器
使用docker run命令启动LandPPT容器。这条命令会将您本地的.env文件挂载到容器内部，并设置数据持久化卷，确保您的项目数据不会丢失。

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

第四步：访问和管理
容器成功运行后，同样通过浏览器访问http://localhost:8000即可打开操作界面。如果需要查看服务运行的日志，可以使用以下命令：

docker logs -f landppt

操作流程

1. 访问Web界面：启动服务后，在浏览器输入http://localhost:8000。
2. 配置AI：在界面的“设置”页面中，填入您所使用的AI模型的API密钥。
3. 创建项目：在主界面，输入您想要生成的演示文稿的主题、选择受众（例如“技术人员”或“市场营销团队”）以及期望的PPT页数范围。
4. 生成大纲：点击生成按钮，AI会根据您的需求，自动生成一份结构清晰的演示文稿大纲。您可以在大纲编辑器中对内容进行修改和确认。
5. 生成PPT：确认大纲无误后，AI将根据大纲内容和内置模板，生成完整的HTML演示文稿，并提供实时预览。
6. 编辑和导出：利用侧边栏的AI聊天功能，可以对生成的内容进行微调。完成所有编辑后，您可以将演示文稿导出为PDF、HTML或PPTX格式。

应用场景

1. 商业分析师
   商业分析师需要定期向管理层汇报市场趋势、竞品分析或项目进展。他们可以使用LandPPT，通过上传数据报告或输入分析主题，快速生成结构清晰、图文并茂的演示文稿，从而将更多时间投入到数据分析本身，而不是PPT排版。
2. 教育工作者和学生
   教师可以利用该工具，将课程讲义（如Word或PDF文档）快速转换为生动的教学课件。学生在准备课程报告或毕业设计答辩时，也可以通过输入论文大纲或研究报告，快速生成演示文稿的初稿，再进行个性化修改，大大提升了学习和研究效率。
3. 市场营销人员
   市场营销团队在制定营销活动方案或进行产品介绍时，需要制作大量演示文稿。通过LandPPT，他们可以输入活动主题和核心创意，让AI自动生成包含市场定位、目标用户、推广策略等模块的演示文稿，从而快速响应市场变化。
4. 技术开发者
   开发者在进行技术分享、项目复盘或向上级汇报技术方案时，可以使用LandPPT将技术文档或Markdown笔记直接转换为演示文稿。这不仅节省了制作时间，也使得技术内容的呈现更加系统和专业。

QA

1. LandPPT支持哪些语言模型？我可以使用自己的本地模型吗？
   LandPPT平台支持多种主流的云端大型语言模型，包括OpenAI的GPT系列、Anthropic的Claude系列、Google的Gemini系列以及微软的Azure OpenAI服务。同时，它也支持通过Ollama框架接入和使用您自己在本地部署的开源模型，为用户提供了极大的灵活性。
2. 如果AI生成的大纲不符合我的要求，我该怎么办？
   在LandPPT的工作流中，大纲生成是一个独立的环节。AI生成大纲后，您可以进入一个可视化的“大纲编辑器”，在这里您可以手动修改、增加或删除任何部分的内容。只有在您确认大纲无误后，平台才会进入下一步的PPT生成环节，确保最终内容符合您的预期。
3. 我是否可以自定义演示文稿的模板和样式？
   可以。LandPPT拥有一个强大的模板系统。除了平台提供的全局主模板和由AI生成的多样化布局外，它还支持用户导入和创建自己的个性化模板。这意味着您可以根据公司品牌指南或个人偏好来设计演示文稿的外观，实现高度的定制化。
4. 将项目文件导出为PPTX格式需要付费吗？
   LandPPT本身是一个开源项目，其大部分功能是免费的。但要实现将HTML演示文稿导出为PPTX格式的功能，项目集成了Apryse SDK。根据Apryse公司的许可政策，您可能需要获取相应的许可证密钥（APRYSE_LICENSE_KEY）才能在生产环境中使用此导出功能。