PPTAgent Documentation

🌐 Language

We strongly recommend deploying our fine-tuned model for the best experience with our agent project. According to our experiments, it significantly outperforms existing open-source models.

📅 News Copy Chapter

• [2026/04] 🎉 DeepPresenter accepted to ACL 2026!
• [2026/03] 🤗 We released fine-tuned models and taskset on Hugging Face.
• [2026/01] 🆕 Freeform & template generation now support PPTX export and offline mode. Context management added to prevent context overflow.
• [2025/12] 🔥 Released DeepPresenter codebase with major upgrades — Deep Research Integration, Free-Form Visual Design, Autonomous Asset Creation, Text-to-Image Generation, and an Agent Environment with sandbox & 20+ tools.
• [2025/09] 🛠️ MCP server support added — see MCP Server for configuration details.
• [2025/08] 🎉 PPTAgent accepted to EMNLP 2025!
• [2025/05] ⭐ Reached 1,000 stars on GitHub!
• [2025/01] 🔓 Open-sourced the PPTAgent codebase.

Usage 📖 Copy Chapter

[!IMPORTANT]
Windows is not supported. If you are on Windows, please use WSL.

We strongly recommend starting with the CLI and minimum task to confirm dependencies and environment is configured correctly.

Configuration Copy Section

If you use the CLI, pptagent onboard can help create and update these configurations interactively. If you use Docker Compose or build from source, you should prepare them manually:

cp deeppresenter/config.yaml.example deeppresenter/config.yaml
cp deeppresenter/mcp.json.example deeppresenter/mcp.json

Optional Services That Improve Quality

The following services can noticeably improve generation quality, especially for research depth, PDF parsing, and visual asset creation:

• Tavily: improves web search quality. Apply for an API key at tavily.com, then set TAVILY_API_KEY in deeppresenter/mcp.json.
• MinerU: improves PDF parsing quality. You can either apply for an API key at mineru.net and set MINERU_API_KEY in deeppresenter/mcp.json, or deploy MinerU locally and set MINERU_API_URL instead.
• Text-to-image model: improves image generation quality. Configure t2i_model in deeppresenter/config.yaml.

If you want a fully offline setup, deploy MinerU locally and set offline_mode: true in deeppresenter/config.yaml to avoid loading network-dependent tools such as web search.

More configurable variables can be found in constants.py.

1. Personal Use / OpenClaw Integration: CLI Copy Section

[!NOTE]
On macOS, the CLI may automatically install several local dependencies, including Homebrew, Node.js, Docker, poppler, Playwright, and llama.cpp.

On Linux, you should prepare the environment by yourself.

Use this mode if you want the fastest local setup or want to plug DeepPresenter into OpenClaw through the CLI.

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

# First-time interactive setup
uvx pptagent onboard

# Generate a presentation
uvx pptagent generate "Single Page with Title: Hello World" -o hello.pptx

# Generate with attachments
uvx pptagent generate "Q4 Report" \
  -f data.xlsx \
  -f charts.pdf \
  -p "10-12" \
  -o report.pptx

Docker Images Copy Section

DeepPresenter publishes two runtime images:

2. Minimal Setup / Development: Build From Source Copy Section

Use this mode if you want the smallest abstraction layer and full control over dependencies during development.

uv pip install -e .
playwright install-deps
playwright install chromium
npm install --prefix deeppresenter/html2pptx
modelscope download forceless/fasttext-language-id

docker pull forceless/deeppresenter-sandbox
docker pull forceless/deeppresenter-host
docker tag forceless/deeppresenter-sandbox deeppresenter-sandbox
docker tag forceless/deeppresenter-host deeppresenter-host

# or pull through the 1ms.run mirror
docker pull docker.1ms.run/forceless/deeppresenter-sandbox
docker pull docker.1ms.run/forceless/deeppresenter-host
docker tag docker.1ms.run/forceless/deeppresenter-sandbox deeppresenter-sandbox
docker tag docker.1ms.run/forceless/deeppresenter-host deeppresenter-host

# or build from dockerfile
docker build -t deeppresenter-sandbox -f deeppresenter/docker/SandBox.Dockerfile .
docker build -t deeppresenter-host -f deeppresenter/docker/Host.Dockerfile .

Start the app:

python webui.py

3. Server Deployment: Docker Compose Copy Section

Use this mode for a stable server environment with explicit dependencies.

# Pull the public images to avoid build from source
docker pull forceless/deeppresenter-sandbox
docker pull forceless/deeppresenter-host
docker tag forceless/deeppresenter-sandbox deeppresenter-sandbox
docker tag forceless/deeppresenter-host deeppresenter-host

# Or pull through the 1ms.run mirror
docker pull docker.1ms.run/forceless/deeppresenter-sandbox
docker pull docker.1ms.run/forceless/deeppresenter-host
docker tag docker.1ms.run/forceless/deeppresenter-sandbox deeppresenter-sandbox
docker tag docker.1ms.run/forceless/deeppresenter-host deeppresenter-host

# Or build from source
docker build -t deeppresenter-sandbox -f deeppresenter/docker/SandBox.Dockerfile .
docker build -t deeppresenter-host -f deeppresenter/docker/Host.Dockerfile .

# Start the host service
docker compose up -d

The service exposes the web UI on http://localhost:7861.

Case Study 💡 Copy Chapter

• Prompt: Please present the given document to me.

• Prompt: 请介绍小米 SU7 的外观和价格

• Prompt: 请制作一份高中课堂展示课件，主题为“解码立法过程：理解其对国际关系的影响”

Contributors 🌟 Copy Chapter

Citation 🙏 Copy Chapter

If you find this project helpful, please use the following to cite it:

/* Detailed source-code truncated for AI context efficiency. */