Skip to content

About

个人自托管的 AI 短视频生产工作站:LLM 写稿 → MoneyPrinterTurbo 出片 → ffprobe 质检 → 人工审核。FastAPI + Vue 3 + SQLite,Docker Compose 部署。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

HotFactory · 本机配音工具

单人本机使用的短视频配音工具:上传一段已有视频,填入旁白文案,生成配音后的成片,并在视频库里查看和删除。页面不再触发 AI 视频生成;创作部分请在外部 agent 中完成。

前置条件

  • Python 3.12+(本机实测 3.13.14),Node.js 22+,npm。
  • ffmpeg 与 ffprobe 在 PATH 中。
  • 本机 .mpt-venv/Scripts/edge-tts.exe 可用(音色注册表见 backend/app/providers/voices.py)。
  • 配音合成需要联网(Edge 在线 TTS 服务)。

安装

cd backend
uv venv .venv
uv pip install --python .venv/Scripts/python.exe -r requirements.txt

cd ../frontend
npm ci
npm run build

启动

Windows 双击 start.bat,或:

cd backend
.venv/Scripts/python.exe -m uvicorn app.main:app --host 127.0.0.1 --port 8000

浏览器打开 http://127.0.0.1:8000。服务只监听回环地址。

前端开发时可另开终端运行 cd frontend && npm run dev,Vite 会把 /api 代理到 8000 端口。

使用

  1. 「视频配音」页选择源视频(mp4/mov/mkv/avi/webm/flv),粘贴旁白文案,选音色、语速、音调、音量。
  2. 点「开始配音」并等待完成;合成过程依赖联网,通常需要几十秒。
  3. 成功后自动跳到「视频库」,可播放成片;删除需要输入文件名确认。

配音会替换整条原音轨,画面保持原样;旁白短于视频时用静音补齐,长于视频时按视频时长截断。

数据与配置

  • config/.env:可选,样例见 config/env.example;不要提交。
  • data/:SQLite 数据库与输入数据;output/videos/:成片;logs/:日志。这些目录不进 Git。
  • 常用变量:HF_DUBBING_TTS_COMMAND、HF_DUBBING_FFMPEG、HF_DUBBING_TIMEOUT、HF_TRUSTED_HOSTS、HF_TRUSTED_ORIGINS。

验证

cd backend && .venv/Scripts/python.exe -m pytest
cd frontend && npm run typecheck && npm run build

本项目只在本机运行:没有 Docker 镜像、没有 Worker/队列,也没有视频生成链路。

About

个人自托管的 AI 短视频生产工作站:LLM 写稿 → MoneyPrinterTurbo 出片 → ffprobe 质检 → 人工审核。FastAPI + Vue 3 + SQLite,Docker Compose 部署。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages