CoolFace
Apppublic

aashu1707/brainrot

sourceHugging Faceupdated 5mo agoView on Hugging Face
0likes
App README

🎬 Viral Brainrot Video Generator

A free-first Python + Gradio + FFmpeg viral video tool built on the original working app.

Cost labels

  • —✅ FREE: Works without paid APIs.
  • —⚠️ OPTIONAL API: Works free, but can improve with HuggingFace/OpenAI/ElevenLabs keys.
  • —🔴 API REQUIRED: Must use an API. Current app avoids API-required core features.

Features

Phase 1 — ✅ FREE

  • —Content presets: Horror Story, Reddit Confession, Finance Explainer, History Mystery, Hinglish Drama, Meme Debate.
  • —Visual styles: Brainrot Blast, Dark Cinematic, Warm Storytime, Horror Whisper, Minimal Documentary.
  • —Script quality checker: hook, generic phrase, sentence length, emotional-word warnings.
  • —Template-based idea generator: script outline, thumbnail idea, background idea, caption tone.
  • —Export bundle: MP4 + subtitles.srt + script.txt + thumbnail.png.

Phase 2 — ⚠️ OPTIONAL API

  • —API settings panel for HuggingFace, Gemini, OpenAI, ElevenLabs.
  • —Thumbnail generator:
  • —✅ FREE fallback: static PIL thumbnail.
  • —⚠️ Better with API: HuggingFace/OpenAI image generation.
  • —Background provider hook:
  • —✅ FREE fallback: local stock videos in assets/footage/.
  • —⚠️ Better with API: HuggingFace hook kept in media_providers.py.
  • —Advanced TTS provider hook:
  • —✅ FREE fallback: existing TikTok/gTTS/Edge flow.
  • —⚠️ Better with API: ElevenLabs hook in media_providers.py.

Phase 3 — ✅ FREE first

  • —Static/optional thumbnail intro clip.
  • —Bigger upgraded captions with word-marker style for selected visual styles.
  • —Basic beat emphasis every 2–3 seconds, no complex audio analysis.

Phase 4 — ✅ FREE / ⚠️ OPTIONAL API

  • —Project save/load as JSON.
  • —Template gallery for presets and styles.
  • —Batch-generation guardrail: one video free, API-assisted variations suggested.
  • —Partial regeneration: thumbnail-only regeneration with free/API fallback.

Setup

bash
pip install -r requirements.txt
python app.py

Open the local Gradio URL shown in the terminal, usually http://127.0.0.1:7860.

Assets

  • —Background videos: assets/footage/
  • —Background music: assets/music/
  • —Character images: assets/characters/

This package includes a generated free sample background video so the app can run immediately. Replace it with real gameplay/background footage for production.

Script format

text
NARRATOR: Here's the truth about sleep.
Alex: Wait, what do you mean?
NARRATOR: Most people don't understand it.
Alex: That's wild!

Emotion tags still work:

text
NARRATOR [excited]: This secret changes everything!
Alex [question]: Wait, are you serious?

API notes

The app works without API keys. Optional keys can be pasted into the API Settings accordion at runtime.

Allowed optional APIs:

  • —HuggingFace
  • —Google Gemini connection slot
  • —OpenAI
  • —ElevenLabs

No core render path depends fully on a paid API. Sensible. Almost suspiciously sensible.