ittybitty

Topic or script in → narrated video out. Shorts for TikTok and Reels, or longer chaptered explainers — with stock footage, your Jellyfin/Plex home videos, or local AI clips.

· 中文 README

Alpha — under construction. APIs, pipelines (R3 screening, R9 talker), and the Windows installer may change between releases. Not production-ready. See alpha release checklist before going public or tagging.

Three ways to use it (pick one):

Same engine under all three: Python backend on port 11054, React dashboard on 11055 when running the dev stack.

Contents

Related MCP server: videoseek-mcp

Windows app

Best if you just want to make videos.

1. Download the latest pre-release installer from Releases (tag v0.2.0-alpha.* or newer)

2. Run the installer → launch ittybitty from Start or your desktop shortcut

3. In Settings, add a free stock API key (Pexels, Pixabay, or Coverr) → Generate with a topic or paste a script

The installer bundles the web dashboard and Python backend — no separate Python or Node install.

Install folder: %LOCALAPPDATA%\ittybitty\
If the backend fails to start: %LOCALAPPDATA%\ai.fleet.ittybitty\logs\backend-spawn.log

Web dashboard

The React UI: Generate, Plan (mid-length), Jobs, Depot, Publish, Settings, Help, Logs.

Already using the Windows app? You're in the dashboard — nothing else to install.

Running on your dev machine (live reload, for contributors):

git clone https://github.com/sandraschi/ittybittyvideos.git videogen-mcp
cd videogen-mcp
.\start.bat

Open http://127.0.0.1:11055. The script starts the dashboard and the API together.

Needs Python 3.10+, FFmpeg, and Node.js — see INSTALL.md.

MCP server

For AI agents that should generate or plan videos over the Model Context Protocol.

1. Start the backend (Windows app running, or .\start.bat -BackendOnly, or uv run python -m videogen_mcp.server)

2. Point your MCP client at http://127.0.0.1:11054/mcp

Example prompts: "Generate a 45-second video about Vienna coffee culture" · "Plan a 5-minute sourdough tutorial" · "Call videogen_help first"

Tool list and REST API: docs/TOOLS.md (16 MCP tools; catalog at /api/v1/tools) · Claude Desktop / MCPB: INSTALL.md

What you need

The in-app Help page walks through each step.

Footage sources

Pick one in Settings → Footage (free tier = no GPU):

• Pexels — free stock (default)

• Pixabay — free stock (MPT parity)

• Mixkit — free 1080p clips, no API key

• NASA — public-domain space/science footage, no API key

• Jellyfin / Plex — cut clips from your library (vacation, pets, …)

• Veo / Omni — Google cloud (config)

• LocalGen — Wan 2.2 on your GPU

Finished videos land in ./output/ and appear in Depot.

How this differs from MoneyPrinterTurbo

MoneyPrinterTurbo popularized topic → short video. ittybitty targets the same job with fleet tooling: agents, longer formats, your own libraries, and a path to local GPU — still alpha, so expect rough edges.

中文说明与中国本地栈（通义千问、CosyVoice 等）：README-zh.md

Sample output

"German Shepherd puppy discovers snow for the first time" -- generated in ~55 seconds. Download full MP4 (17 MB)

Quick test render:

py scripts/smoke_render.py

docs/examples/README.md

More help

Fleet docs: mcp-central-docs/projects/ittybitty

MIT · sandraschi · v0.2.0

Repo folder videogen-mcp, Python package videogen_mcp — kept for MCP tool compatibility.