Skip to main content

Brandly CLI

Brandly CLI Banner

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.

PyPI version Python >=3.10 License: MIT Tests Lint CI GitHub stars


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)
  • 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

v0.3.7 New Features

Feature Description
Quality Gate brandly gate <id> <element> — anti-slop/anti-drift verification before the next step
AI Visual Review Multimodal model scores quality, slop, distortion, drift, and matte backdrop
Auto-Gate brandly reference and brandly video run the gate post-generation (--no-gate to skip)
Matte Sheets Reference sheets now use a seamless matte mid-grey studio backdrop for clean cutouts
Gate Reports Auditable reports written to .brandly/<project>/docs/tmp/

v0.3.1 New Features

Feature Description
Stitch Multi-shot video assembly with transitions (fade, dissolve) and color grading
Export Platforms Platform-optimized exports for TikTok, Instagram, YouTube, Facebook
Thumbnails Keyframe extraction with text overlays
Dubbing Multi-language video dubbing via MiniMax TTS
Beat Sync Music-reactive editing with beat detection
Auto-Director Script-to-video pipeline automation
Trends Trending format research database
Analyzer Video performance prediction & scoring
Templates Reusable project configurations
Webhook CI/CD integration with job queue
Sharing Cloud export with pluggable providers

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, 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):

Skill Purpose
brandly-camera Hollywood camera language — framing, angles, placement, composition, movement, Rembrandt/butterfly/split lighting
brandly-video-generation Master skill — generate AI video & images with prompt engineering
brandly-storyboard Plan shot-by-shot visual blueprints
brandly-production-bible Single source-of-truth campaign document
brandly-consistency Lock visual identity across all shots
brandly-character-sheet Character reference sheets
brandly-object-sheet Product/object reference sheets
brandly-location-sheet Location/set reference sheets
brandly-vehicle-sheet Vehicle reference sheets
brandly-mecha-sheet Mecha/robot reference sheets
brandly-animal-sheet Animal/creature reference sheets
brandly-plant-sheet Plant/botanical reference sheets

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. 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

Command Description
brandly init / brandly start Start a new video project
brandly status <id> Show project status
brandly list List all projects
brandly run <id> Run the next pipeline phase
brandly approve <id> <phase> Approve a phase and advance
brandly cost <id> Show cost summary

Media Generation

Command Description
brandly image Generate an image via Agnes AI
brandly video <id> Generate a video via Agnes AI
brandly music Generate background music
brandly tts <text> Generate voiceover via TTS

Post-Production

Command Description
brandly stitch <clips...> Multi-shot video assembly
brandly export <id> --platforms <p> Export for specific platforms
brandly thumbnail <id> Generate thumbnails
brandly voice-match <video> --source <lang> --target <lang> Dub video
brandly beat-sync <video> <audio> Cut video to beats
brandly analyze <video> Predict performance metrics
brandly share <file> Upload for cloud sharing

Intelligence

Command Description
brandly trend <category> Research trending formats
brandly template list List templates
brandly template use <name> Create project from template
brandly validate <id> Run virality validation
brandly gate <id> [element] Verify an element (anti-slop/drift) before the next step
brandly director Show Director agent prompt

License

MIT — Dream Pixels Forge

Release files for brandly-cli 0.3.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for brandly-cli 0.3.8
File Size Uploaded
brandly_cli-0.3.8.tar.gz 1.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for brandly-cli 0.3.8
File Interpreter ABI Platform
brandly_cli-0.3.8-py3-none-any.whl Python 3 none any Details

Total release size: 2.0 MB

Release files / brandly_cli-0.3.8.tar.gz

Download URL brandly_cli-0.3.8.tar.gz
Size 1.8 MB
Tags Source
SHA-256 checksum
How to use checksums
0eaf4db22677111a959c729db4f5d71cd8c4ae7efa3f9d269a19930fda10f807
BLAKE2b-256 checksum
How to use checksums
11fb84e5d628b700728a13e3ba09f7b8d19e890b6ac28f93c0ed9c3bf44cedf6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.

Transparency log

Release files / brandly_cli-0.3.8-py3-none-any.whl

Download URL brandly_cli-0.3.8-py3-none-any.whl
Size 125.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b15bda6691d67af442cb63191339255e813053421cdd2dc6dc767dacdc600bc2
BLAKE2b-256 checksum
How to use checksums
d00f52c7d868d58eb04c07a91d1c49babec26d75d58c48dbdc4754682130a8fe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.

Transparency log

Release history Release notifications | RSS feed

0.3.26

2 release files

0.3.25

2 release files

0.3.24

2 release files

0.3.22

2 release files

0.3.21

2 release files

0.3.20

2 release files

0.3.19

2 release files

0.3.18

2 release files

0.3.16

2 release files

0.3.15

2 release files

0.3.14

2 release files

0.3.13

2 release files

0.3.11

2 release files

0.3.10

2 release files

0.3.9

2 release files

This release

0.3.8 This release

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page