Brandly CLI

AI product video orchestrator — add image, video, and sound generation capability to any AI tool (OpenCode, Codex, Qwen Code, Claude Code, etc.) via a CLI and Director agent.

What is Brandly?

Brandly is an autonomous video production pipeline that turns product ideas into platform-ready marketing videos. It provides:

• Image generation via Agnes AI (text-to-image, image-to-image)
• Video generation via Agnes AI (text-to-video, keyframe-controlled, reference-based)
• Audio generation via MiniMax Audio (background music, TTS voiceover)
• 3D Spatial Control — Blender PlayBlast renderer for spatial reference frames (camera composition, depth, keyframes) feeding Agnes AI keyframe/reference modes
• Multi-agent pipeline — automated workflow from idea → trends → concept → script → assets → audio → validate → publish
• Director orchestrator — an autonomous agent that guides the entire production process
• Credit budgeting — track spend per phase against a project budget
• Style presets — avoid AI slop with photorealistic, cinematic, editorial, commercial, and documentary presets
• Production plan as source of truth — every generation registers on docs/plan/production_plan.md; brandly produce generates multi-shot films one shot at a time (Agnes: 1 request/min)
• Smaller reference payloads — large local images auto-convert to webp/jpeg before upload

v0.3.15 New Features + Issue Fixes (#19–#24)

v0.3.12 Bug Fixes

v0.3.9 New Features

v0.3.7 New Features

v0.3.1 New Features

Installation

pip install brandly-cli

Install Agent Skills

Brandly ships a set of agent skills (camera language, storyboard, production bible, character/object/vehicle/animal/plant/mecha sheets, 3D spatial, consistency, video generation) that you can install into any AI tool that supports the npx skills protocol:

npx skills add https://github.com/Dream-Pixels-Forge/brandly-cli/tree/main/skills

Available skills (see skills/README.md for details):

Configure API Keys

export AGNES_API_KEY="your-agnes-api-key"
export MINIMAX_API_KEY="your-minimax-api-key"

Or create a .env file:

AGNES_API_KEY=your_key_here
MINIMAX_API_KEY=your_key_here
AGNES_BASE_URL=https://apihub.agnes-ai.com/v1
MINIMAX_BASE_URL=https://api.minimaxi.com/v1

Quick Start

1. Initialize a Project

brandly init \
  --name "SuperWidget Pro" \
  --idea "A revolutionary widget that organizes your desk with AI" \
  --style cinematic \
  --budget 500 \
  --shots 5 \
  --platforms tiktok instagram youtube

2. Run the Pipeline

brandly estimate --style cinematic --shots 5
brandly run <project-id>
brandly approve <project-id> <phase>
brandly director

3. Generate Media

brandly image --prompt "product on marble surface" --style-preset cinematic
brandly video <project-id> --prompt "sleek earbuds rotating" --duration 5
brandly music --prompt "upbeat electronic" --duration 30
brandly tts "Welcome to SuperWidget Pro"

4. 3D Spatial References (Optional)

If Blender is installed, generate spatial reference frames for Agnes AI keyframe/reference modes:

# Detect installed Blender version
python -c "from brandly_cli.blender_integration import detect_blender; v = detect_blender(); print(v)"

# Render spatial references
python skills/brandly-3d-spatial/scripts/playblast_renderer.py \
  --config .brandly/my-project/3d-spatial/cameras/scene.json \
  --output .brandly/my-project/3d-spatial/cameras \
  --mode single

# Extract references for Agnes
python skills/brandly-3d-spatial/scripts/extract_references.py \
  --input .brandly/my-project/3d-spatial/cameras \
  --output .brandly/my-project/3d-spatial/keyframes \
  --strategy first

5. Export & Share

brandly export <project-id> --platforms tiktok youtube
brandly thumbnail <project-id>
brandly stitch clip1.mp4 clip2.mp4 --transition fade
brandly voice-match input.mp4 --source en --target es
brandly analyze video.mp4
brandly share output.mp4

CLI Reference

Project Management

Media Generation

Large local reference images are auto-converted to smaller webp/jpeg payloads before upload (disable with BRANDLY_IMAGE_CONVERT=off). Scope auto-injected references with brandly video --no-auto-refs / --auto-ref-category <name>, and adopt client-supplied plates with brandly reference <id> --image <path> [--no-generate].

Post-Production

Intelligence

3D Spatial

Keywords

ai video generation, product video, marketing video, cli tool, agent pipeline, multi-agent, agentic ai, brand video, social media video, tiktok video, youtube video, image generation, video generation, keyframe video, reference video, blender 3d, spatial reference, agnes ai, minimax tts, background music, voiceover, director agent, pipeline orchestration, creative ai, automated video production, product demo, commercial, advertising, content creation, shot list, storyboard, consistency, character sheet, reference sheet

License

MIT — Dream Pixels Forge