Lybrand-tyro/ppt_ai GitHub 下载入口与本地安装测试教程

Lybrand-tyro/ppt_ai 是一个基于 FastAPI 和 LLM 的智能 PPT 生成器，GitHub 入口在 https://github.com/Lybrand-tyro/ppt_ai，可从仓库页面的 Code 按钮下载 ZIP，也可用 git clone https://github.com/Lybrand-tyro/ppt_ai.git 拉到本地。源码到位后，入口脚本是根目录的 run.py，默认启动在 http://localhost:8001，网页端会读取 web/index.html。

这个项目的主线很直接：输入主题生成大纲，编辑后生成 HTML 预览，再下载 PPTX 文件。仓库没有 README，安装时更要看根目录文件和 BUSINESS_LOGIC.txt：依赖在 requirements.txt，后端代码在 src/，前端单页在 web/，运行日志会进入 logs/。

把源码放好，再启动 8001 端口

本地先准备 Python 3 环境，进入仓库根目录后安装依赖。macOS 和 Linux 可以这样跑：

git clone https://github.com/Lybrand-tyro/ppt_ai.git
cd ppt_ai
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python run.py

Windows 下把激活命令换成 .venvScriptsactivate。启动脚本会把 src 加入运行路径，并用 Uvicorn 加载 src.main:app。终端里出现服务器地址后，浏览器打开 http://localhost:8001，能看到 Web 界面就说明静态页面和 FastAPI 主程序已经接上。

先用模板跑通，再接 LLM 和搜索

前端会先创建任务，再调用 /api/generate-outline 生成大纲，随后用 /api/generate-slides 生成 HTML。LLM 没配置好时，项目里有模板大纲和模板内容兜底，用小主题测试基本链路更稳，例如输入“新能源汽车行业报告”，确认页面能否生成 6 页左右的大纲。

需要接入模型时，配置入口是 /api/configure-llm，请求里包含 api_endpoint、api_key、model_name 和 is_local。服务会把常见端点补全到 /v1/chat/completions，OpenAI 兼容接口和本地模型接口都能按这个字段走。联网搜索另走 /api/configure-web-search，可选 Tavily、SerpAPI、Bing、Google、Brave，其中 Google 还需要 cx。

看 HTML 预览和 PPTX 下载结果

大纲生成后，页面会把每页标题、类型、布局、场景样式送到 PPT 服务。HTML 预览由 PPTService.generate_html() 生成，内容页会按每页 3 个要点拆分，支持居中、左对齐、双栏、引用、卡片、时间线等布局。看到 iframe 里出现完整页面，说明前端展示、后端生成和任务进度已经连起来。

PPTX 下载走 /api/download-pptx，内部用 python-pptx 生成 16:9 文件，并通过文件流返回。文件名来自大纲标题，浏览器开始下载后，再看 logs/ppt_ai_日期.log，里面会记录生成、失败和接口调用信息。管理员相关接口会生成密码哈希和 24 小时 token，配置历史最多保留 20 条，个人本地试用时不要把真实 key 放进公开环境。

Lybrand-tyro/ppt_ai 的入口不复杂，难点在于先分开验证三件事：服务能在 8001 打开，模板大纲和 HTML 预览能返回，PPTX 下载能落到浏览器。确认这三步后，再接 LLM、联网搜索和管理员配置，排错范围会小很多。