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

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 director Show Director agent prompt

License

MIT — Dream Pixels Forge

Project links

Data verified by PyPI on Sep 7, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dream-pixels-forge from gravatar.com dream-pixels-forge

Credits

Author: Dream Pixels Forge

GitHub Statistics

Data verified by PyPI on Sep 7, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

agent ai cli generation image orchestrator video

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

brandly_cli-0.3.2.tar.gz (1.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

brandly_cli-0.3.2-py3-none-any.whl (100.5 kB view details)

Uploaded Python 3

File details

Details for the file brandly_cli-0.3.2.tar.gz.

File metadata

  • Download URL: brandly_cli-0.3.2.tar.gz
  • Upload date:
  • Size: 1.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for brandly_cli-0.3.2.tar.gz
Algorithm Hash digest
SHA256 b6c3e9784854c129c4dad672bf567c17fc8f6f76434e31e1cf797327f7de6d5d
MD5 4c06b1a3ab33bbcab0623b8504da30c7
BLAKE2b-256 e4e7afb1ba1c6e7fb13b6fced21ede5d59dd0fb4886edea12a2bfedf87ccccb7

See more details on using hashes here.

Provenance

The following attestation bundles were made for brandly_cli-0.3.2.tar.gz:

Publisher: release.yml on Dream-Pixels-Forge/brandly-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file brandly_cli-0.3.2-py3-none-any.whl.

File metadata

  • Download URL: brandly_cli-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 100.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for brandly_cli-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 17c1fcb2204847df4a2d6091c93e746ef860877657058f7578a8521b3eeae362
MD5 7130d8cec40e8ba83c31bfd1efbe67cf
BLAKE2b-256 76322ee2d639b5e28489eedfd3688c305d8ce8974ff42774290de9a43797d785

See more details on using hashes here.

Provenance

The following attestation bundles were made for brandly_cli-0.3.2-py3-none-any.whl:

Publisher: release.yml on Dream-Pixels-Forge/brandly-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.3.2 This release

2 files

0.3.1

2 files

0.3.0

2 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