项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3646
使用教程
环境要求
- Docker 环境(单容器部署),或 Docker Compose(生产推荐)
- 源码方式运行需 Python 环境并安装 uv
- 至少一个 AI 模型 API Key(OpenAI/Claude/Gemini 等,或本地 Ollama)
- 使用图像功能需额外申请 Pixabay、Unsplash、SiliconFlow 等密钥
安装与启动步骤
-
1准备 .env 配置
复制示例配置并编辑,至少填入一个 AI API Key;Docker 运行前必须先有 .env 文件。
cp .env.example .env -
2拉取 Docker 镜像
从 Docker Hub 拉取官方镜像 bradleylzh/landppt:latest,体积较大需耐心等待。
docker pull bradleylzh/landppt:latest -
3启动单容器
映射 8000 端口并挂载 .env 与数据卷;示例用当前目录下的 .env 文件,请按需改路径。
docker run -d \ --name landppt \ -p 8000:8000 \ -v $(pwd)/.env:/app/.env \ -v landppt_data:/app/data \ -v landppt_uploads:/app/uploads \ -v landppt_reports:/app/research_reports \ -v landppt_cache:/app/temp \ -v landppt_lib:/app/lib \ bradleylzh/landppt:latest -
4查看容器日志
跟随日志确认服务启动正常,出现报错多半是 .env 缺少 AI API Key。
docker logs -f landppt -
5Compose 生产部署
会启动 Web + Worker + PostgreSQL + Valkey + MinIO,至少配置 AI Key、SECRET_KEY、POSTGRES_PASSWORD。
cp .env.example .env docker compose up -d docker compose logs -f landppt -
6源码方式启动
先安装 uv 并编辑 .env 配置 AI API Key,再运行启动脚本,本地默认 SQLite + 内存缓存。
python run.py
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
AI API Key | 是 | 至少配置一个 AI 提供商密钥,支持 GPT/Claude/Gemini/DeepSeek/Qwen 或 Ollama | sk-xxxxxxxx |
SECRET_KEY | 是 | 生产部署(docker compose)必须修改的密钥项 | your-secret-key |
POSTGRES_PASSWORD | 是 | 生产部署 PostgreSQL 数据库密码,必须自行修改 | your-postgres-password |
LANDPPT_PORT | 否 | 修改 Web 访问端口,默认 8000 | 8000 |
LANDPPT_BOOTSTRAP_ADMIN_ENABLED | 否 | 生产默认关闭管理员自动初始化,首次部署设为 true 并配账号密码 | true |
ENABLE_IMAGE_SERVICE | 否 | 开启图像功能,并配合 Pixabay/Unsplash/AI 生成等密钥 | true |
如何确认成功
浏览器访问 http://localhost:8000 能正常打开界面,且 docker logs 中无报错,即启动成功。
常见问题
Q:如何配置图像功能?
A:在 .env 中设置 ENABLE_IMAGE_SERVICE=true,并配置 PIXABAY_API_KEY、UNSPLASH_ACCESS_KEY,或 SILICONFLOW_API_KEY、POLLINATIONS_API_KEY 等 AI 生成密钥。
Q:支持纯本地部署吗?
A:支持,可用 Docker 或源码安装;推理侧可接 Ollama,无需外部大模型 API,但深度研究、网络配图等能力仍可能需要外网。
Q:需要自己装 PostgreSQL 和 Valkey 吗?
A:本地默认使用 SQLite + 内存缓存即可跑通;生产推荐用仓库内 docker-compose.yml,自动编排 Web + Worker + PostgreSQL + Valkey + MinIO。
Q:首次部署没有管理员账号怎么办?
A:生产默认关闭管理员自动初始化,首次部署请设置 LANDPPT_BOOTSTRAP_ADMIN_ENABLED=true 及对应账号密码。
Q:怎么修改访问端口和镜像?
A:Compose 部署可用 LANDPPT_PORT 改端口(默认 8000),用 LANDPPT_IMAGE 覆盖默认镜像 bradleylzh/landppt:latest。
注意事项
- 运行 Docker 容器前必须先创建并配置 .env,至少包含一个 AI API Key。
- Docker Compose 部署的 MinIO 控制台默认在 http://localhost:9001。
- 生产环境务必修改 SECRET_KEY 与 POSTGRES_PASSWORD,不要沿用示例值。
- 更多 .env 变量见 .env.example,高级配置见 src/landppt/core/config.py。
核心亮点
- 支持多种主流大模型,用户可灵活选择最优生成效果
- 模板丰富且可自定义,满足不同场景的视觉需求
- 自动化内容提炼与排版,大幅缩短制作时间
不足之处
- 复杂图表和动画支持有限,生成效果可能不如手动精细
- 文档/社区待观察
适用场景
- 快速将研究报告或论文转为演示文稿
- 企业周报或项目汇报的自动化PPT生成
- 教学课件或培训材料的批量制作
替代项目
Slidebean、Decktopus、Tome
上一篇:xiaoju-survey
下一篇:surf
同类项目推荐
Chatbook
开源
在 Wolfram Notebook 里直接调用大模型对话与计算
Wolfram Notebooks + LLMs
ChatGPT-Writer
开源
输入几个关键词,AI 秒写完整邮件
Free Chrome extension that uses ChatGPT AI to generate entire emails or replies base···
resume_render_from_job_descripti···
开源
贴个职位链接,AI 自动改好简历
jevos: an open-source alternative to Jev and Microsoft-Decision-1. Yes/no decisions,···
copilot
开源
本地转写+悬浮提示,面试会议随身 AI 助手
Локальный AI-копилот для интервью и встреч (Window···
PPT-Design-Skill
开源
一句话生成4万种风格、可编辑的专业PPT
Precision PPT design skill for OpenCode/Claude Code/Codex, with 40,000+ styles, pixe···
QuickClipboard
开源
复制即记录,历史内容随时搜、跨设备同步
QuickClipboard 是一款跨平台剪贴板增强工具(现支持Windows,Android),基于 Tauri 2 + ···
pdf2md
开源
浏览器里直接把 PDF 变成 Markdown,不用上传,隐私安全。
Browser based tool to convert PDFs to Markdown
yn
开源
一个编辑器搞定 Markdown 写作、AI 助手、代码运行和演示
A highly extensible Markdown editor featuring version control, AI Copilot, document ···
ScreenMemo
开源
自动截屏+OCR+AI总结,让屏幕信息随时可搜可查
ScreenMemo 是一款在本地运行的智能截屏备忘与检索工具:自动记录你在 Android 设备上的屏···
