自托管部署教程 — 4 种方式免费运行 AI 视频生成器

环境要求

部署前确认本机满足以下条件（选择 Docker 方式可跳过，镜像已内置全部依赖）：

• Python 3.10+（手动与 npm 方式必需）
• ffmpeg（仅手动方式需要；Docker 与 npm 已内置）
• Node.js 18+（仅 npm 方式需要）
• Git（用于克隆仓库）
• 无需 GPU、无需大内存——所有 AI 计算在云端完成，普通笔记本即可

四种部署方式

任选其一即可启动服务，浏览器打开 http://localhost:8765 使用。

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
./start.sh

docker run -d -p 8765:8765 \
  -e AGNES_API_KEY=<你的key> \
  -v ~/agnes-data/working:/app/.working_dir \
  -v ~/agnes-data/config:/app/.agnes_config \
  ghcr.io/lcy362/free-short-video:latest

npx free-short-video
# 或全局安装后运行：free-short-video（简写别名：fsv）
AGNES_API_KEY=<你的key> npx free-short-video

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
# 然后对你的 AI Agent 说：
"阅读这个项目的 AGENTS.md，安装依赖，配置 API Key，然后启动服务。"

部署成功标志

• 浏览器自动打开（或手动访问）http://localhost:8765，看到 Agnes Video Generator 界面即成功
• 在页面顶部粘贴你的免费 API Key 后即可开始生成
• 生成耗时参考：简单视频约 1-3 分钟，创意长视频（5 场景）约 10-20 分钟

使用要点

• 断点续传：服务中断后重新启动，在任务列表中找到未完成任务点击「续传」即可从断点恢复
• 输出目录：所有任务产物存放在 .working_dir/{时间戳}_{task_id}/，final_video.mp4 为最终视频（含旁白与字幕）
• 端口占用：端口 8765 被占用时，macOS/Linux 执行 lsof -ti:8765 | xargs kill，Windows 用 netstat -ano | findstr :8765 查 PID 后 taskkill
• 有每分钟 16 次的 API 调用限制——这是为免费而做的限速，不是你的电脑慢