JayChanHoi/ppt-agentic-generator-app skill 下载入口和本地安装教程

JayChanHoi/ppt-agentic-generator-app 是 PPT Generator Agent 的 Streamlit 前端入口，下载从 GitHub 仓库页进入，常用方式是页面右侧的 ZIP 下载或 git clone https://github.com/JayChanHoi/ppt-agentic-generator-app.git。它不是一个独立的在线生成网页，打开前端前还要准备后端仓库 JayChanHoi/ppt-generator-agent，因为这个前端默认会连本机 http://127.0.0.1:8000。

这个项目的入口问题要先讲明白：前端仓库只有 app.py、requirements.txt 和界面逻辑，真正负责 Draft、Review、HTML 预览、PPTX 下载的服务在后端仓库。前端页面能打开，只代表 Streamlit 启动了；要看到草稿、预览和 PPTX 下载按钮，还要让 8000 端口的后端服务能回应 /health。

先把两个仓库放在同一级目录

前端仓库的 requirements.txt 里有一行 -r ../ppt-generator-agent/requirements.txt，这意味着它会读取相邻目录里的后端依赖。新手如果只克隆前端仓库，再在里面执行 pip install -r requirements.txt，很容易遇到找不到 ../ppt-generator-agent/requirements.txt 的报错。

更稳的目录摆法是先建一个工作目录，把前端和后端放在同一级：

mkdir ppt-agent-work
cd ppt-agent-work
git clone https://github.com/JayChanHoi/ppt-generator-agent.git
git clone https://github.com/JayChanHoi/ppt-agentic-generator-app.git

这样前端的相对依赖能找到后端目录。后端仓库 README 写到，它用 LangGraph 编排 Draft、Review、Design、Render 流程，用 LangChain 连接模型，HTML/CSS 设计再通过 Node 侧的 html2pptx 转成原生 .pptx。如果你用 OpenAI 模型，就在后端根目录准备 .env 或导出 OPENAI_API_KEY；如果走本地模型，也要先确认本地模型服务能被后端调用。

先开 8000 后端，再开 Streamlit 前端

后端服务先启动。进入 ppt-generator-agent 后安装依赖，再用 README 给出的服务命令启动 API：

cd ppt-generator-agent
pip install -r requirements.txt
uvicorn src.api:app --host 0.0.0.0 --port 8000

后端启动后，前端才有地方提交请求。另开一个终端进入 ppt-agentic-generator-app，安装前端依赖并启动 Streamlit：

cd ../ppt-agentic-generator-app
pip install -r requirements.txt
streamlit run app.py

app.py 里默认读取 PPT_AGENT_BACKEND_URL，没有设置时会使用 http://127.0.0.1:8000，并且会把 0.0.0.0 规范成 127.0.0.1 方便本地访问。如果后端不在 8000 端口，就先设置环境变量，再启动前端：

export PPT_AGENT_BACKEND_URL="http://127.0.0.1:8000"
streamlit run app.py

打开页面后，看草稿、预览和下载是否连起来

前端页面标题是 PPT Agentic Generator，页面文案里能看到 Draft → review → preview → refine → generate PPTX 这条路径。第一次测试不要上传复杂参考稿，先输入一个短主题，让它请求后端的 /v1/draft。如果后端正常，页面右侧会显示可读草稿；内容确认后，前端会向后端提交 review，左侧出现 HTML 预览。

生成 PPTX 时，前端会去拿 /v1/artifacts/{thread_id}/pptx。能下载文件，才说明前端、后端、模型调用和渲染链路都接上了。页面只停在 Streamlit 空壳，或提示 PPTX not available to download，就回到两个地方查：后端终端有没有报模型、Node/html2pptx 或环境变量错误；前端环境变量是否指向了正在运行的 8000 服务。

把 JayChanHoi/ppt-agentic-generator-app skill 当成本地前端入口会更顺：GitHub/ZIP/clone 负责下载，ppt-generator-agent 负责服务，streamlit run app.py 负责页面，草稿、预览和 PPTX 下载一起出现，才说明这条安装入口真正可用。