brandly-cli 0.3.0__tar.gz → 0.3.2__tar.gz

{brandly_cli-0.3.0 → brandly_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: brandly-cli
-Version: 0.3.0
+Version: 0.3.2
 Summary: AI product video orchestrator — add image, video, and sound generation to any AI tool
 Project-URL: Homepage, https://github.com/Dream-Pixels-Forge/brandly-cli
 Project-URL: Repository, https://github.com/Dream-Pixels-Forge/brandly-cli
@@ -34,6 +34,10 @@ Description-Content-Type: text/markdown
 
 # Brandly CLI
 
+<p align="center">
+  <img src="assets/banner.png" alt="Brandly CLI Banner" width="100%">
+</p>
+
 > **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](https://img.shields.io/pypi/v/brandly-cli.svg)](https://pypi.org/project/brandly-cli/)
@@ -58,18 +62,18 @@ Brandly is an **autonomous video production pipeline** that turns product ideas
 - **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.0 New Features
+### v0.3.1 New Features
 
 | Feature | Description |
 |---------|-------------|
-| **Stitch** | Multi-shot video assembly with transitions (fade, dissolve, wipe, slide) and color grading |
+| **Stitch** | Multi-shot video assembly with transitions (fade, dissolve) and color grading |
 | **Export Platforms** | Platform-optimized exports for TikTok, Instagram, YouTube, Facebook |
-| **Thumbnails** | AI-generated thumbnails with text overlays and platform-specific sizing |
-| **Dubbing** | Multi-language video dubbing via MiniMax TTS (10 languages) |
+| **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 (5 categories) |
-| **Analyzer** | Video performance prediction with scoring |
+| **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 |
@@ -85,14 +89,11 @@ pip install brandly-cli
 ### Configure API Keys
 
 ```bash
-# Agnes AI (image + video generation)
 export AGNES_API_KEY="your-agnes-api-key"
-
-# MiniMax Audio (music + TTS)
 export MINIMAX_API_KEY="your-minimax-api-key"
 ```
 
-Or create a `.env` file in your project root:
+Or create a `.env` file:
 
 ```dotenv
 AGNES_API_KEY=your_key_here
@@ -118,50 +119,30 @@ brandly init \
 ### 2. Run the Pipeline
 
 ```bash
-# Check cost estimate first
 brandly estimate --style cinematic --shots 5
-
-# Run each phase
-brandly run <project-id>        # Start the current phase
-brandly approve <project-id> <phase>  # Approve and advance
-
-# Or run the full pipeline at once
-brandly director                # Shows Director prompt for AI tools
+brandly run <project-id>
+brandly approve <project-id> <phase>
+brandly director
 ```
 
-### 3. Generate Media Directly
+### 3. Generate Media
 
 ```bash
-# Image generation
-brandly image --prompt "product on marble surface, studio lighting" \
-               --style-preset cinematic
-
-# Video generation
-brandly video <project-id> --prompt "sleek wireless earbuds rotating" \
-             --duration 5 --wait
-
-# Audio generation
-brandly music --prompt "upbeat electronic background music" --duration 30
+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
 
 ```bash
-# Export for platforms
 brandly export <project-id> --platforms tiktok youtube
-
-# Generate thumbnails
 brandly thumbnail <project-id>
-
-# Stitch clips together
 brandly stitch clip1.mp4 clip2.mp4 --transition fade
-
-# Dub to another language
 brandly voice-match input.mp4 --source en --target es
-
-# Share to cloud
-brandly share output.mp4 --provider local
+brandly analyze video.mp4
+brandly share output.mp4
 ```
 
 ## CLI Reference
@@ -175,9 +156,7 @@ brandly share output.mp4 --provider local
 | `brandly list` | List all projects |
 | `brandly run <id>` | Run the next pipeline phase |
 | `brandly approve <id> <phase>` | Approve a phase and advance |
-| `brandly cancel / pause / resume <id>` | Control project state |
 | `brandly cost <id>` | Show cost summary |
-| `brandly record-cost <id> <phase> <action> <credits>` | Record credit spend |
 
 ### Media Generation
 
@@ -185,162 +164,32 @@ brandly share output.mp4 --provider local
 |---------|-------------|
 | `brandly image` | Generate an image via Agnes AI |
 | `brandly video <id>` | Generate a video via Agnes AI |
-| `brandly music` | Generate background music via MiniMax Audio |
+| `brandly music` | Generate background music |
 | `brandly tts <text>` | Generate voiceover via TTS |
-| `brandly voices` | List available TTS voices |
 
 ### Post-Production
 
 | Command | Description |
 |---------|-------------|
-| `brandly stitch <clips...>` | Multi-shot video assembly with transitions |
+| `brandly stitch <clips...>` | Multi-shot video assembly |
 | `brandly export <id> --platforms <p>` | Export for specific platforms |
-| `brandly thumbnail <id>` | Generate thumbnails from video |
-| `brandly voice-match <video> --source <lang> --target <lang>` | Dub video to another language |
-| `brandly beat-sync <video> <audio>` | Cut video to match beat timestamps |
-| `brandly analyze <video>` | Predict video performance metrics |
-| `brandly share <file>` | Upload to cloud for sharing |
+| `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 video formats |
-| `brandly template list` | List available templates |
+| `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 progress <id>` | Show detailed progress |
 | `brandly director` | Show Director agent prompt |
 
-### System
-
-| Command | Description |
-|---------|-------------|
-| `brandly estimate` | Estimate credit cost |
-| `brandly memory` | View/update user preferences |
-| `brandly config` | Show configuration |
-| `brandly webhook` | Start webhook server (CI/CD) |
-
-## Pipeline Phases
-
-```
-init → trends → concept → script → asset → audio → re_edit → validate → publish → done
-```
-
-Each phase has a corresponding agent prompt that defines the task for the AI orchestrator:
-
-| Phase | Agent | Purpose |
-|-------|-------|---------|
-| `init` | — | Project initialization |
-| `trends` | trends_agent | Research viral formats for the product category |
-| `concept` | concept_agent | Create 3 video concepts using STAMP framework |
-| `script` | script_agent | Write shot-by-shot script with 8-Layer prompts |
-| `asset` | asset_agent | Select models and generate visual assets |
-| `audio` | audio_agent | Generate music, SFX, and voiceover |
-| `re_edit` | script_agent | Review and refine the script |
-| `validate` | validation_agent | Run virality scoring (requires Higgsfield MCP) |
-| `publish` | publish_agent | Generate platform-specific metadata |
-| `done` | — | Pipeline complete |
-
-## Video Styles
-
-| Style | Credits (base) | Best For |
-|-------|---------------|----------|
-| `cinematic` | 250 | Premium brand stories |
-| `ugc` | 150 | User-generated content style |
-| `montage` | 200 | Fast-paced highlight reels |
-| `multi_shot` | 300 | Complex multi-scene videos |
-| `continuous` | 200 | Single-take seamless shots |
-| `unboxing` | 180 | Product reveal videos |
-| `lifestyle` | 170 | Contextual product usage |
-| `collage_motion_graphic` | 350 | Animated collage sequences |
-| `brand_short_video` | 280 | Short-form brand content |
-| `explainer_video` | 400 | Educational/instructional |
-
-## Style Presets (Avoid AI Slop)
-
-| Preset | Description |
-|--------|-------------|
-| `photorealistic` | Camera/lens/grain, natural skin texture |
-| `editorial` | Magazine look, studio lighting |
-| `cinematic` | Anamorphic, film grade, teal & orange |
-| `commercial` | Product photography, clean studio |
-| `documentary` | Photojournalism, available light |
-
-## Director Mode
-
-The **Director** is an autonomous orchestrator agent. When invoked by an AI tool, it:
-
-1. Gathers product info (name, idea, style, budget, platforms)
-2. Creates a project via `brandly init`
-3. Runs the pipeline phase by phase
-4. Checks virality, manages budget, and exports final assets
-
-To use it with any AI tool, copy the output of:
-
-```bash
-brandly director
-```
-
-## Project Structure
-
-```
-.brandly/
-├── projects/
-│   └── {project-id}/
-│       ├── project.json      # Project state
-│       ├── cost.json         # Credit spend log
-│       └── artifacts/
-│           └── {phase}/      # Phase outputs (.md, .json)
-├── user-preferences.json     # Liked/disliked hooks, style prefs
-└── templates/                # Custom saved templates
-```
-
-Generated media is stored in:
-- `imagen/{project-id}/` — generated images
-- `videgen/{project-id}/` — generated videos
-- `audgen/{project-id}/` — generated audio
-
-## Development
-
-```bash
-# Install in development mode
-pip install -e ".[dev]"
-
-# Run tests
-pytest
-
-# Run tests with coverage
-pytest --cov=src/brandly_cli
-
-# Lint
-ruff check src/
-ruff check src/ --fix
-
-# Syntax check
-python -m py_compile src/brandly_cli/*.py
-
-# Build
-python -m build
-```
-
-## Integration with AI Tools
-
-### OpenCode
-
-Add to `.opencode/package.json`:
-```json
-{ "dependencies": { "brandly": "github:Dream-Pixels-Forge/brandly-plugin" } }
-```
-
-Register in `opencode.json`:
-```json
-{ "$schema": "https://opencode.ai/config.json", "plugin": ["brandly"] }
-```
-
-### Codex / Qwen Code / Claude Code
-
-Use the CLI directly — all commands are designed to be called by agent subprocesses. The Director prompt provides the orchestration logic.
+---
 
 ## License
 

brandly_cli-0.3.2/README.md

@@ -0,0 +1,162 @@
+# Brandly CLI
+
+<p align="center">
+  <img src="assets/banner.png" alt="Brandly CLI Banner" width="100%">
+</p>
+
+> **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](https://img.shields.io/pypi/v/brandly-cli.svg)](https://pypi.org/project/brandly-cli/)
+[![Python >=3.10](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-303_passing-green.svg)](https://github.com/Dream-Pixels-Forge/brandly-cli)
+[![Lint](https://img.shields.io/badge/lint-ruff_clean-brightgreen.svg)](https://github.com/Dream-Pixels-Forge/brandly-cli)
+[![CI](https://github.com/Dream-Pixels-Forge/brandly-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Dream-Pixels-Forge/brandly-cli/actions)
+[![GitHub stars](https://img.shields.io/github/stars/Dream-Pixels-Forge/brandly-cli?style=social)](https://github.com/Dream-Pixels-Forge/brandly-cli/stargazers)
+
+---
+
+## 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](https://apihub.agnes-ai.com) (text-to-image, image-to-image)
+- **Video generation** via Agnes AI (text-to-video, keyframe-controlled, reference-based)
+- **Audio generation** via [MiniMax Audio](https://platform.minimaxi.com) (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
+
+```bash
+pip install brandly-cli
+```
+
+### Configure API Keys
+
+```bash
+export AGNES_API_KEY="your-agnes-api-key"
+export MINIMAX_API_KEY="your-minimax-api-key"
+```
+
+Or create a `.env` file:
+
+```dotenv
+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
+
+```bash
+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
+
+```bash
+brandly estimate --style cinematic --shots 5
+brandly run <project-id>
+brandly approve <project-id> <phase>
+brandly director
+```
+
+### 3. Generate Media
+
+```bash
+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
+
+```bash
+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

brandly_cli-0.3.2/dev-notes/DEVELOPMENT.md

@@ -0,0 +1,154 @@
+# Brandly CLI — Development Guide
+
+> This file contains development, architecture, and integration details. For end-user documentation, see [README.md](../README.md).
+
+---
+
+## Pipeline Phases
+
+```
+init → trends → concept → script → asset → audio → re_edit → validate → publish → done
+```
+
+| Phase | Agent | Purpose |
+|-------|-------|---------|
+| `init` | — | Project initialization |
+| `trends` | trends_agent | Research viral formats for the product category |
+| `concept` | concept_agent | Create 3 video concepts using STAMP framework |
+| `script` | script_agent | Write shot-by-shot script with 8-Layer prompts |
+| `asset` | asset_agent | Select models and generate visual assets |
+| `audio` | audio_agent | Generate music, SFX, and voiceover |
+| `re_edit` | script_agent | Review and refine the script |
+| `validate` | validation_agent | Run virality scoring |
+| `publish` | publish_agent | Generate platform-specific metadata |
+| `done` | — | Pipeline complete |
+
+## Video Styles
+
+| Style | Credits (base) | Best For |
+|-------|---------------|----------|
+| `cinematic` | 250 | Premium brand stories |
+| `ugc` | 150 | User-generated content style |
+| `montage` | 200 | Fast-paced highlight reels |
+| `multi_shot` | 300 | Complex multi-scene videos |
+| `continuous` | 200 | Single-take seamless shots |
+| `unboxing` | 180 | Product reveal videos |
+| `lifestyle` | 170 | Contextual product usage |
+| `collage_motion_graphic` | 350 | Animated collage sequences |
+| `brand_short_video` | 280 | Short-form brand content |
+| `explainer_video` | 400 | Educational/instructional |
+
+## Style Presets (Avoid AI Slop)
+
+| Preset | Description |
+|--------|-------------|
+| `photorealistic` | Camera/lens/grain, natural skin texture |
+| `editorial` | Magazine look, studio lighting |
+| `cinematic` | Anamorphic, film grade, teal & orange |
+| `commercial` | Product photography, clean studio |
+| `documentary` | Photojournalism, available light |
+
+## Director Mode
+
+The **Director** is an autonomous orchestrator agent. When invoked by an AI tool, it:
+
+1. Gathers product info (name, idea, style, budget, platforms)
+2. Creates a project via `brandly init`
+3. Runs the pipeline phase by phase
+4. Checks virality, manages budget, and exports final assets
+
+To use it with any AI tool, copy the output of:
+
+```bash
+brandly director
+```
+
+## Project Structure
+
+```
+.brandly/
+├── projects/
+│   └── {project-id}/
+│       ├── project.json      # Project state
+│       ├── cost.json         # Credit spend log
+│       └── artifacts/
+│           └── {phase}/      # Phase outputs (.md, .json)
+├── user-preferences.json     # Liked/disliked hooks, style prefs
+└── templates/                # Custom saved templates
+```
+
+Generated media is stored in:
+- `imagen/{project-id}/` — generated images
+- `videgen/{project-id}/` — generated videos
+- `audgen/{project-id}/` — generated audio
+
+## Development
+
+```bash
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=src/brandly_cli
+
+# Lint
+ruff check src/
+ruff check src/ --fix
+
+# Syntax check
+python -m py_compile src/brandly_cli/*.py
+
+# Build
+python -m build
+```
+
+## CI/CD
+
+- **GitHub Actions**: `.github/workflows/ci.yml` runs tests, lint, and syntax checks
+- **PyPI Publishing**: `.github/workflows/release.yml` publishes on release via OIDC trusted publishing
+- **Pre-commit hooks**: `.pre-commit-config.yaml` with ruff + pytest
+
+## Architecture
+
+### Core Modules
+
+| Module | Purpose |
+|--------|---------|
+| `cli.py` | Click command definitions |
+| `project_manager.py` | Project CRUD operations |
+| `edit.py` | FFmpeg video editing |
+| `stitch.py` | Multi-shot assembly |
+| `export_platforms.py` | Platform-specific exports |
+| `thumbnails.py` | Keyframe extraction |
+| `dubbing.py` | Multi-language dubbing |
+| `beat_sync.py` | Music-reactive editing |
+| `autodirector.py` | Script-to-video pipeline |
+| `trends.py` | Trend research database |
+| `analyzer.py` | Performance prediction |
+| `templates.py` | Project templates |
+| `webhook.py` | CI/CD webhook server |
+| `sharing.py` | Cloud export providers |
+
+### API Providers
+
+| Provider | Purpose |
+|----------|---------|
+| `agnes_client.py` | Image + video generation |
+| `ark_client.py` | BytePlus Ark (Seedream/Seedance) |
+| `minimax_client.py` | Music + TTS |
+
+### Key Dependencies
+
+- `click` — CLI framework
+- `pydantic` — Data validation
+- `httpx` — Async HTTP client
+- `rich` — Terminal UI
+- `pillow` — Image processing
+- `pytest` / `pytest-asyncio` — Testing
+
+## License
+
+MIT — Dream Pixels Forge

{brandly_cli-0.3.0 → brandly_cli-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "brandly-cli"
-version = "0.3.0"
+version = "0.3.2"
 description = "AI product video orchestrator — add image, video, and sound generation to any AI tool"
 readme = "README.md"
 license = "MIT"

{brandly_cli-0.3.0 → brandly_cli-0.3.2}/src/brandly_cli/__about__.py

@@ -1,3 +1,3 @@
 """Package metadata."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.2"