# LandPPT

**Repository Path**: github-source/LandPPT

## Basic Information

- **Project Name**: LandPPT
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-22
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LandPPT - AI驱动的PPT生成平台

[![GitHub stars](https://img.shields.io/github/stars/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/network)
[![GitHub issues](https://img.shields.io/github/issues/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/issues)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-blue.svg?style=flat-square)](https://www.python.org)
[![FastAPI](https://img.shields.io/badge/FastAPI-0.104+-green.svg?style=flat-square)](https://fastapi.tiangolo.com)
[![Docker](https://img.shields.io/badge/docker-supported-blue.svg?style=flat-square)](https://hub.docker.com/r/bradleylzh/landppt)

[English](README_EN.md) | **中文**

---

## 📋 目录

- [项目简介](#-项目简介)
- [功能亮点](#-功能亮点)
- [核心功能](#-核心功能)
- [快速开始](#-快速开始)
- [使用指南](#-使用指南)
- [配置说明](#-配置说明)
- [API文档](#-api文档)
- [技术栈](#️-技术栈)
- [贡献指南](#-贡献指南)
- [常见问题](#-常见问题)
- [许可证](#-许可证)

## 🎯 项目简介

LandPPT 是一个基于大语言模型（LLM）的智能演示文稿生成平台，能够自动将文档内容转换为专业的PPT演示文稿。平台集成了多种AI模型、智能图像处理、深度研究功能和丰富的模板系统，让用户能够轻松创建高质量的演示文稿。


![image](https://img.pub/p/17ebc2a837fc02827d4a.png)

![image](https://img.pub/p/1f9e79326ddeae3b8716.png)

![image](https://img.pub/p/02bac27fe8097c012d9e.png)

![image](https://img.pub/p/9a38b57c6f5f470ad59b.png)

![image](https://img.pub/p/47090624aec2d337f0df.png)

![image](https://img.pub/p/bebe9fe671d0125ceac6.png)

![image](https://img.pub/p/0d2ffc650792c4a133a4.png)

## 🌟 功能亮点

- **🚀 一键生成**：从主题到完整PPT，全程AI自动化处理
- **🎨 智能配图**：AI自动匹配最适合的图像，支持多源获取
- **🔍 深度研究**：集成多个搜索引擎，获取最新最全面的信息
- **📱 响应式设计**：完美适配各种设备和屏幕尺寸
- **🔒 企业级安全**：支持本地部署，数据安全可控

## ✨ 核心功能

### 🤖 多AI提供商支持
- **OpenAI GPT系列**：GPT-4o、GPT-4o-mini 等最新模型
- **Anthropic Claude**：Claude-3.5 Sonnet、Claude-3 Haiku 系列模型
- **Google Gemini**：Gemini-1.5 Flash、Gemini-1.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生成多种创意页面布局和设计风格
- **场景化模板**：通用、旅游、教育等多种专业场景模板
- **自定义模板**：支持导入和创建个性化模板

### 📊 完整的项目管理
- **三阶段工作流**：需求确认 → 大纲生成 → PPT生成
- **可视化编辑**：直观的大纲编辑器和实时预览
- **版本管理**：项目历史记录和版本回溯功能
- **批量操作**：支持批量生成和处理多个项目

### 🌐 现代化Web界面
- **直观操作**：用户友好的响应式Web界面
- **AI聊天编辑**：侧边栏AI编辑功能，支持实时对话
- **多格式导出**：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
- 或配置本地Ollama服务

### 3. 创建PPT项目
1. **需求确认**：输入主题、选择受众、设置页数范围、选择场景模板
2. **大纲生成**：AI智能生成结构化大纲，支持可视化编辑
3. **内容研究**：可选择启用深度研究功能，获取最新相关信息
4. **图像配置**：配置图像获取方式（本地/网络/AI生成）
5. **PPT生成**：基于大纲生成完整的HTML演示文稿

### 4. 编辑和导出
- 使用AI聊天功能实时编辑内容和样式
- 支持图像替换和优化
- 导出为PDF、HTML或PPTX格式
- 保存项目版本和历史记录
- 支持批量处理和模板复用

## 🔧 配置说明

### 环境变量配置

主要配置项（详见 `.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

# 服务器配置
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格式。

## 📄 许可证

本项目采用 Apache License 2.0 许可证。详情请见 [LICENSE](LICENSE) 文件。

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=sligter/LandPPT&type=Date)](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/+EaOfoceoNwdhNDVl

![LandPPT](https://img.pub/p/a26f6aa4c2b5ae698e95.png)
---

<div align="center">

**如果这个项目对你有帮助，请给我们一个 ⭐️ Star！**

Made with ❤️ by the LandPPT Team

</div>