Finance Shorts Factory

Local tools for short, reviewed personal-finance videos.

Generate beginner finance Shorts with local script generation, Piper voice, WhisperX caption timing, Pillow scenes, FFmpeg rendering, and optional private YouTube uploads.

Repository Setup Guide Governance Releases

Pipeline

Script

Ollama drafts metadata, sections, and a spoken script for one focused finance mechanism.

Review

The quality gate checks language, risky claims, pacing, TTS notation, and loan math consistency.

Render

Piper, WhisperX, Pillow, and FFmpeg create the final vertical video for manual review.

Finance Shorts Factory architecture diagram

Development Session

Use the lightweight scripts for day-to-day work. The Windows setup script remains the first-time installer.

.\start_dev.ps1
.\stop_dev.ps1

Quality Checks

Run the static checks before opening a pull request.

python -m compileall -q generate_short.py run_pipeline.py setup_channel.py upload_youtube.py test_voice.py
ruff check --output-format=github .
bandit -q -r . --severity-level medium --confidence-level high -x ./.git,./.venv,./outputs,./voices,./assets/music

Review Standard

Generate private videos first and review finance accuracy before publishing.
Keep OAuth files, local config, and generated media out of commits.
Prefer small pull requests with clear verification notes.
Publish release source packages from reviewed tags with checksums.
Use channel positioning that is educational, plain-English, and not advice.

Education only. Not financial advice. Generated videos should be reviewed before public release.