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:
Newer release available (0.3.2)

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.1.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.1-py3-none-any.whl (97.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: brandly_cli-0.3.1.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.1.tar.gz
Algorithm Hash digest
SHA256 70c2382c8ee807e0ac1c400763ead013b9c3dc67f031169edd370f0303100072
MD5 d3b2c876ee98444fbd0bc2a202893474
BLAKE2b-256 8b10ff71b06668ea035229c6c70f7651538ff749902cbb7af3e76a846b1d9b9a

See more details on using hashes here.

Provenance

The following attestation bundles were made for brandly_cli-0.3.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: brandly_cli-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 97.9 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a636b7e2510de8e49eb5697bba39b6ef5103c1910c7ad630644b4ade15c49995
MD5 235ee4824c858a0aa6a73f2c5d8281bb
BLAKE2b-256 fcfbd0200af7a6ffd6d12ecd14fb4c15cfb88c8d5a607ab451dcc9befb1f1110

See more details on using hashes here.

Provenance

The following attestation bundles were made for brandly_cli-0.3.1-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

0.3.2

2 files

This release

0.3.1 This release

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