PRINTFILM 教程:从主题到成片的 AI 短视频漫剧流水线

📌 项目地址:github.com/yi1108/printfilm | 星数:273+ | 版本:v0.2.0(2026-09-10)

📋 项目简介

想批量产出 AI 短视频或连载漫剧,市面工具要么闭源要么按条收费。PRINTFILM 给了一条完全自主可控的开源路线:主题 → 分镜 → 图片 → 视频 → 配音 → 成片一条流水线,同一套管线支持多套视觉风格,切换风格即换产品形态。它不只是「能跑的 demo」——注册登录、按量计费、管理后台、对外开放 API 都在内置清单里,可以直接当小型创作 SaaS 的底座用。AI 视频生成的模型侧选择可参考 ffmpeg-skill视频Agent技能教程 与 Anything2Explainer视频讲解技能教程。

🏗️ 技术栈

层级选型
后端Python 3.12 · FastAPI · SQLAlchemy · PostgreSQL
用户端React 19 · TypeScript · Vite 8
管理端React 19 · Tailwind · shadcn/ui(开发端口 5174)
AI文字:OpenAI 兼容(Kimi/DeepSeek 等);生图/生视频:火山方舟 Seedream / Seedance;配音:豆包 TTS 或 edge-tts
任务应用内 scheduler + executor + poller(随 FastAPI 进程启动)
部署Docker 只跑 Postgres / Redis;应用用本机或服务器进程

🚀 快速开始

git clone https://github.com/yi1108/printfilm.git
cd printfilm

# ① 中间件:Postgres 15432 + Redis 16379
cp deploy/.env.prod.example deploy/.env.prod
# 把 POSTGRES_PASSWORD 改成自己的强密码
docker compose -f deploy/docker-compose.yml \
  --env-file deploy/.env.prod up -d

# ② 后端
cd backend
python -m venv .venv
# Windows: .\.venv\Scripts\activate
# Linux/macOS: source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env:DATABASE_URL 密码与中间件一致;填入模型 Key
uvicorn app.main:app --reload --port 8000

# ③④ 另开两个终端分别启动用户端与管理端(管理端 5174)

注意:仓库不含任何密钥,先复制示例配置再启动;README 提供完整操作手册(系统概述 / 安装启动 / 模块导航 / 典型业务流程 / 系统管理 / 日常运维 / 常见问题排查)。

💡 使用建议

📚 常见问题

PRINTFILM 是什么?

一个开源的模板驱动 AI 短视频与漫剧创作平台(yi1108/printfilm,273 星,v0.2.0,2026-09-10 更新)。同一条生成流水线支持多套视觉风格,流程为主题 → 分镜 → 图片 → 视频 → 配音 → 成片;技术栈为 Python 3.12 + FastAPI + PostgreSQL 后端、React 19 + TypeScript 用户端、React 19 + shadcn/ui 管理端,内置注册登录、按量计费、管理后台与对外开放 API。

AI 服务怎么配置?

文字模型走 OpenAI 兼容接口(Kimi、DeepSeek 等均可);生图与生视频用火山方舟的 Seedream / Seedance;配音可选豆包 TTS 或免费的 edge-tts。所有密钥都不在仓库里,需复制 deploy/.env.prod.example 与 backend/.env.example 后自行填入模型 Key。

怎么启动?

四步:① docker compose 用 deploy/ 下的 compose 文件起 Postgres(15432)和 Redis(16379),先改 POSTGRES_PASSWORD 为强密码;② backend 目录建 Python 虚拟环境,pip install -r requirements.txt,复制 .env.example 并让 DATABASE_URL 密码与中间件一致、填入模型 Key,uvicorn app.main:app --reload --port 8000 启动后端;③ 另开终端启动用户端;④ 管理端在 5174 端口。任务调度由随 FastAPI 进程启动的应用内 scheduler + executor + poller 负责。