Skip to content
BrewReel

Practical guide

Make your first BrewReel promo video: run a sample, then use your own product

Set up the local renderer, validate and render an existing storyboard, then move to a product brief and a human review before publishing.

Finderchangchang ·

Understand who does each part

You supply a brief and assets. A language model writes storyboard JSON using the project’s recipes. BrewReel renders the video locally with code. Running an existing sample first helps verify the renderer before introducing model-generated storyboards.

The cards recipe presents features and processes, quiz handles question-and-reveal sequences, and journey follows a character through a scene. Cards and quiz default to 1080×1920; journey defaults to 1080×1350. Check the repository for available recipes and parameters.

Prepare the local environment

The current README lists Node.js 18+ and Python 3.10+, and records testing with Node 22. The DeepSeek Harness plugin has separate runtime requirements. You also need Git, npm and space for dependencies. Follow the project’s x64 requirements on Windows.

1. Install rendering dependencies

git clone https://github.com/Finderchangchang/brewreel.git
cd brewreel/template
npm install
npx remotion browser ensure
cd ..
python -m pip install numpy scipy

If your system only provides python3, use python3 -m pip install numpy scipy for the last line. These commands install rendering components, download a headless browser and install music-generation dependencies. If the browser download fails, inspect network access and the project’s local-browser instructions before changing the storyboard.

2. Validate and render a repository sample

node scripts/validate.mjs examples/ledger.json
node scripts/make.mjs examples/ledger.json --out ../brewreel-out/ledger

Run these from the repository root and keep the output directory outside it. Passing static validation establishes that the storyboard meets validation rules. Complete a render before checking the actual video and delivery files.

The README describes video.mp4, sheet.png, check/, report.txt and manifest.json in the output. Watch the complete video, inspect the report and confirm the manifest corresponds to your storyboard.

3. Replace the sample with your product brief

Specify the product name, audience, core action, features, evidence, assets and acquisition route. Ask the model to follow the project SKILL and the selected industry recipe. Start with the product brief guide. Mark missing facts as unknown instead of letting the model invent performance figures.

Repeat validation, rendering and review. Use validator errors and human observations to revise the storyboard. Model calls and optional voiceover services may incur separate fees.

4. Review before publishing

Automated checks catch some issues; they do not replace watching the video or reviewing its business claims. A rendered sample is not automatically ready for a customer to publish.

Check both project and dependency licenses

BrewReel uses Apache-2.0. Follow LICENSE and NOTICE requirements when redistributing or modifying the project. Rendered videos do not require project attribution. Remotion has its own license; for-profit organizations with four or more employees need a Company License. See the official terms.

This guide follows the public README. The website update did not independently rerender or benchmark these samples. Check the repository for commands, limitations and version changes.