PurffleShorts writes the script with any AI model, voices it with a free neural voice, finds footage for every sentence, adds captions synced to each word, renders a 1080×1920 video and uploads or schedules it on YouTube. Then it does the next one.
01 App tour · v2.0.0
The Studio dashboard, the command line, and frames from a real render — made with no API keys, using free voices and free AI images.
Create Shorts from a form, watch the job log, preview renders and upload — all in your browser, on your machine.
02 Features
Everything between an idea and a published Short, in one Python app. No MoviePy, no ImageMagick, no GPU.
Hook, scenes, a footage search and image prompt per scene, title, description, hashtags, tags and category — from GPT, Claude, Gemini, Llama via Ollama, DeepSeek, Grok, Mistral or any OpenAI-compatible API, with automatic fallback.
75 languages with word-level timing, no key. Or OpenAI TTS, ElevenLabs, Kokoro, Coqui.
A stock search per scene (Pexels, Pixabay), portrait-first, never reused — or AI images.
Each word appears as it is spoken, current word highlighted. Six styles.
Music ducks under the voice; loudness normalised to −14 LUFS.
Publish now or slot each video into your next free time slot — quota-aware, with AI-content disclosure, playlists and privacy options.
Run forever, make one-offs, render bulk batches in parallel, or run several channels from separate settings files.
Your niches, Google Trends, Wikipedia "On this day", Reddit TIL or your list.
Every video also gets a cover image, SRT subtitles and a metadata file.
macOS, Windows, Linux or Docker. You pick every model and key.
03 AI models
12 providers · automatic fallbackUse the model you already pay for — or a free local one. If a provider fails, PurffleShorts falls back to the next.
--script.04 How it works
Python 3.10–3.13 and ffmpeg. The first render needs no API keys at all.
Download the zip below (or git clone) and run pip install -e . inside the folder.
Run purffle-shorts doctor — it checks Python, ffmpeg, voices and any keys you set.
Run purffle-shorts make for one Short, or start autopilot and let it keep publishing.
Upload uses the official YouTube Data API with your own Google project, and stays inside YouTube's daily quota. Mark AI-generated content as such — PurffleShorts sets YouTube's disclosure flag for you — and follow the platform's rules for your channel.
05 Compare
An honest look at the usual options.
| PurffleShorts | Paid AI video sites | Editing by hand | |
|---|---|---|---|
| Price | Free (pay only for keys you choose) | Monthly subscription | Your time |
| Choice of AI model | 12 providers + local | Theirs | — |
| Word-synced captions | ✓ | Usually | Manual |
| Auto-upload & scheduling | ✓ | Sometimes | ✕ |
| Runs on your computer | ✓ | ✕ | ✓ |
| Watermark | None | Often on free plans | None |
| Open source | ✓ MIT | ✕ | — |
06 Download · v2.0.0
PurffleShorts is a Python app, so there is no installer — download the source, install it with pip, and run it. Or use Docker.
Unzip, then in that folder: pip install -e . and purffle-shorts doctor.
git clone https://github.com/Chamanrajragu/purffle-shorts then pip install -e .
A Dockerfile ships in the repo — build it once and run autopilot in the background.
Yes — free and open source under MIT. The first Short can be made with no keys at all (free neural voices and free AI images). You only pay providers you choose to use.
OpenAI, Anthropic Claude, Google Gemini, Groq, OpenRouter, DeepSeek, Mistral, Together AI, xAI Grok, Ollama, LM Studio, or any OpenAI-compatible URL — with automatic fallback between them.
No. Rendering is a single ffmpeg pass. A 25-second Short rendered in 30–40 seconds on an Intel Mac in testing.
Yes — publish immediately or schedule into your next free time slot, using your own Google project and the official YouTube Data API.
The output is a standard vertical 9:16 MP4 with SRT subtitles and a cover image, so it works anywhere vertical video does. Auto-upload is YouTube only.
320+ free voices across 75 languages, and captions in Latin, Indic, Arabic, Thai and CJK scripts.
Yes — write or edit a script file and render it with --script, no LLM call needed.
YouTube allows AI-assisted content but requires disclosure of realistic synthetic media and penalises low-effort mass-produced videos. PurffleShorts sets the disclosure flag; making videos worth watching is up to you.
08 Guides
Straight answers to the questions people search for — including the limitations.
The whole pipeline — script, voice, footage, captions, upload — set up with free tools, step by step.
Read guideGoogle Cloud setup, the daily API quota explained, scheduled releases and what to do when uploads queue.
Read guideFrom topic to published Short — free, open source, on your own computer.