# aippt

**Repository Path**: chun-lin/aippt

## Basic Information

- **Project Name**: aippt
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-15
- **Last Updated**: 2025-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI PPT生成器

基于LangChain + DeepSeek + FastAPI + Vue3的智能PPT生成系统

## 功能特性

- 🤖 AI驱动的内容生成
- 🎨 多种专业模板样式
- 📱 实时生成进度预览
- 🖼️ 智能图片占位符
- 📥 一键下载PPT文件
- 🎯 响应式Web界面

## 技术栈

### 后端
- FastAPI - 现代Python Web框架
- LangChain 0.3.26 - AI应用开发框架
- DeepSeek API - 大语言模型服务
- python-pptx - PPT文件生成
- WebSocket - 实时通信

### 前端
- Vue3 - 渐进式JavaScript框架
- Element Plus - Vue3组件库
- Vite - 前端构建工具
- Pinia - 状态管理
- Socket.IO - 实时通信客户端

## 快速开始

### 环境要求
- Python 3.8+
- Node.js 16+
- Redis (可选)

### 后端设置

1. 进入后端目录并激活虚拟环境：
```bash
cd backend
source venv/bin/activate  # Linux/Mac
# 或 venv\Scripts\activate  # Windows
```

2. 安装依赖：
```bash
pip install -r requirements.txt
```

3. 配置环境变量：
```bash
cp .env.example .env
# 编辑 .env 文件，设置你的API密钥
```

4. 启动后端服务：
```bash
uvicorn main:app --reload --host 0.0.0.0 --port 8000
```

### 前端设置

1. 进入前端目录：
```bash
cd frontend
```

2. 安装依赖：
```bash
npm install
```

3. 启动开发服务器：
```bash
npm run dev
```

4. 访问应用：
打开浏览器访问 `http://localhost:5173`

## 项目结构

```
.
├── backend/                 # 后端代码
│   ├── venv/               # Python虚拟环境
│   ├── main.py             # FastAPI应用入口
│   ├── requirements.txt    # Python依赖
│   ├── .env.example        # 环境变量模板
│   └── ...
├── frontend/               # 前端代码
│   ├── src/                # Vue3源码
│   ├── package.json        # Node.js依赖
│   └── ...
├── .gitignore             # Git忽略文件
└── README.md              # 项目说明
```

## API文档

启动后端服务后，访问以下地址查看API文档：
- Swagger UI: `http://localhost:8000/docs`
- ReDoc: `http://localhost:8000/redoc`

## 开发指南

### 添加新模板
1. 在 `backend/templates/` 目录下创建模板配置文件
2. 定义颜色方案、字体和布局
3. 在模板管理器中注册新模板

### 自定义AI提示词
1. 编辑 `backend/prompts/` 目录下的提示词文件
2. 根据需要调整内容生成逻辑

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request！