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)
- 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
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
1 maintainer
Release files for brandly-cli 0.3.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| brandly_cli-0.3.7.tar.gz | 1.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| brandly_cli-0.3.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.9 MB
Release files / brandly_cli-0.3.7.tar.gz
| Download URL | brandly_cli-0.3.7.tar.gz |
|---|---|
| Size | 1.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7cb2e6eb91132233aca8d475f9d4ca7d6c0fff2c7b625a32556d2523c4db48fb
|
|
BLAKE2b-256 checksum How to use checksums |
82979bb3ad61f8868c67af9873978814fbd48852a2e0dff7fb63edb6098552b3
|
| 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 logRelease files / brandly_cli-0.3.7-py3-none-any.whl
| Download URL | brandly_cli-0.3.7-py3-none-any.whl |
|---|---|
| Size | 125.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b4c6cc88c12aa531a25317cbcce909ec2d3b543266c94a7f293b27263ffeec58
|
|
BLAKE2b-256 checksum How to use checksums |
8c4defcf1aa12d2f7eb675dd63490796d72b0293a0979a728f66e09f8f240e83
|
| 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
