Content
# 🚀 MultiAgentPPT
**News**: The current version is no longer maintained due to difficulties in maintaining PPT content and templates, so a new solution is being reconstructed. It is recommended to adopt a template-based approach for PPT, which is a more enterprise-oriented version: https://github.com/johnson7788/TrainPPTAgent
Author's WeChat for Q&A:
A multi-agent system based on A2A + MCP + ADK that supports streaming concurrent generation of high-quality (editable online) PPT content.
## 🧠 1. Project Introduction
MultiAgentPPT utilizes a multi-agent architecture to automate the process from theme input to complete presentation generation, with the main steps including:
1. **Outline Generation Agent**: Generates an initial content outline based on user requirements.
2. **Topic Splitting Agent**: Breaks down the outline content into multiple topics.
3. **Research Agents Working in Parallel**: Multiple agents conduct in-depth research on each topic separately.
4. **Summary Agent Outputs**: Compiles the research results to generate PPT content, returning it to the frontend in real-time.
## Advantages
- **Multi-Agent Collaboration**: Improves the efficiency and accuracy of content generation through parallel work by multiple agents.
- **Real-time Streaming Return**: Supports streaming return of generated PPT content, enhancing user experience.
- **High-Quality Content**: Combines external retrieval and agent collaboration to generate high-quality content outlines and presentations.
- **Scalability**: The system is designed flexibly, making it easy to expand with new agents and functional modules.
## 2. Recent Upgrades
### ✅ Completed (Done)
- ✅ Fixed output bugs except for Gemini, addressing package issues with ADK and A2A: [View Details](https://github.com/johnson7788/MultiAgentPPT/blob/stream/backend/birthday_planner/README.md)
- ✅ In terms of image rendering: Dynamically switch styles based on whether it is a background image (`object-cover` or `object-contain`), and display explanatory text for non-background images. To ensure the uniqueness of PPT pages, use `page_number` from the output of the large model as a unique identifier, replacing the previous title-based method to support content updates and proofreading.
- ✅ Use a loop agent to generate each PPT page instead of generating all content at once, facilitating the generation of more pages and avoiding LLM token output limits.
- ✅ Introduced PPTChecker Agent to check the quality of each generated PPT page. Actual testing results are good; please replace with real image data and content RAG data.
- ✅ Frontend displays the generation process status of each agent.
- ✅ PPTX download, using python-pptx to download frontend JSON data and render it on the backend.
- ✅ Metadata data transmission: Supports frontend transmission of configuration to agents, with agents returning results along with metadata information.
- ✅ [Local Model Adaptation.md](docs/%E6%9C%AC%E5%9C%B0%E6%A8%A1%E5%9E%8B%E9%80%82%E9%85%8D.md)
### 📝 To Do
- 🔄 Integrate an editable and downloadable PPTX frontend.
## 3. User Interface Screenshot Display
Below are demonstrations of the core functionalities of the MultiAgentPPT project:
### 1. Theme Input Interface
Users input the desired PPT theme content in the interface:
### 2. Streaming Outline Generation Process
The system returns the generated outline structure in real-time based on the input content:
### 3. Complete Outline Generation
The final system will display the complete outline for user confirmation:
### 4. Streaming PPT Content Generation
After confirming the outline, the system begins to stream generate the content for each slide and returns it to the frontend:
### 5. For Multi-Agent Generated PPT, add progress detail display in slide_agent
## 📊 Concurrent Multi-Agent Collaboration Process (slide_agent + slide_outline)
```mermaid
flowchart TD
A[User Inputs Research Content] --> B[Call Outline Agent]
B --> C[MCP Retrieve Materials]
C --> D[Generate Outline]
D --> E{User Confirms Outline}
E --> F[Send Outline to PPT Generation Agent]
F --> G[Split Outline Agent Splits Outline]
G --> H[Parallel Agents Process in Parallel]
%% Concurrent Research Agents
H --> I1[Research Agent 1]
H --> I2[Research Agent 2]
H --> I3[Research Agent 3]
I1 --> RAG1[Automatic Knowledge Base Retrieval RAG]
I2 --> RAG2[Automatic Knowledge Base Retrieval RAG]
I3 --> RAG3[Automatic Knowledge Base Retrieval RAG]
RAG1 --> J[Summary Agent Merges Results]
RAG2 --> J
RAG3 --> J
J --> L[Loop PPT Agent Generates Slide Pages]
subgraph Loop PPT Agent
L1[Write PPT Agent<br>Generates Each Slide]
L2[Check PPT Agent<br>Checks Each Content Quality, Up to 3 Retries]
L1 --> L2
L2 --> L1
end
L --> L1
```
## 🗂️ Project Structure
```bash
MultiAgentPPT/
├── backend/ # Backend multi-agent service directory
│ ├── simpleOutline/ # Simplified outline generation service (no external dependencies)
│ ├── simplePPT/ # Simplified PPT generation service (no retrieval or concurrency)
│ ├── slide_outline/ # Outline generation service with external retrieval (more accurate outline based on MCP tool)
│ ├── slide_agent/ # Concurrent multi-agent PPT generation primarily in XML format
├── frontend/ # Next.js frontend interface
```
---
## ⚙️ 4. Quick Start
### 🐍 4.1 Backend Environment Configuration (Python)
1. Create and activate a Conda virtual environment (recommended Python version 3.11 or higher to avoid bugs):
```bash
conda create --name multiagent python=3.12
conda activate multiagent
```
2. Install dependencies:
```bash
cd backend
pip install -r requirements.txt
```
3. Set backend environment variables:
```bash
# Copy template configuration files for all modules
cd backend/simpleOutline && cp env_template .env
cd ../simplePPT && cp env_template .env
cd ../slide_outline && cp env_template .env
cd ../slide_agent && cp env_template .env
```
---
### 🧪 4.2 Start Backend Services
| Module | Function | Default Port | Start Command |
| --------------- | ----------------- | -------------------------- | -------------------- |
| `simpleOutline` | Simple Outline Generation | 10001 | `python main_api.py` |
| `simplePPT` | Simple PPT Generation | 10011 | `python main_api.py` |
| `slide_outline` | High-Quality Outline Generation (with retrieval) | 10001 (must close `simpleOutline`) | `python main_api.py` |
| `slide_agent` | Multi-Agent Concurrent Full PPT Generation | 10011 (must close `simplePPT`) | `python main_api.py` |
---
## 🧱 5. Frontend Database Setup and Installation & Running (Next.js)
Database stores user-generated PPT:
1. Start PostgreSQL using Docker:
```bash
For use with VPN:
docker run --name postgresdb -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=welcome -d postgres
For use in China:
docker run --name postgresdb -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=welcome -d swr.cn-north-4.myhuaweicloud.com/ddn-k8s/ghcr.io/cloudnative-pg/postgresql:15
```
2. Modify `.env` sample configuration:
```env
DATABASE_URL="postgresql://postgres:welcome@localhost:5432/presentation_ai"
A2A_AGENT_OUTLINE_URL="http://localhost:10001"
A2A_AGENT_SLIDES_URL="http://localhost:10011"
DOWNLOAD_SLIDES_URL="http://localhost:10021"
```
3. Install dependencies and push database models:
```bash
cp env_template .env
# Install frontend dependencies
pnpm install
# Push database models and insert user data
pnpm db:push
# Start frontend
npm run dev
```
4. Open the browser and visit: [http://localhost:3000/presentation](http://localhost:3000/presentation)
---
## Docker Deployment
```
# Please check the docker-compose.yml and Dockerfile files in each directory
cd frontend
docker compose up
cd backend
docker compose up
```
---
## 🧪 Sample Data Description
> The current system has a built-in research example: **“Overview of Electric Vehicle Development”**. For other research topics, please configure the corresponding Agent and connect to real data sources.
> To configure real data, simply change the prompt and the corresponding MCP tool.
---
## 📎 6. References
The frontend project is partially based on the open-source repository: [allweonedev/presentation-ai](https://github.com/allweonedev/presentation-ai)
# Star History
[](https://www.star-history.com/#johnson7788/MultiAgentPPT&Date)
