brandly-cli 0.3.0__tar.gz

brandly_cli-0.3.0/$null

@@ -0,0 +1,2 @@
+'Get-ChildItem' is not recognized as an internal or external command,
+operable program or batch file.

brandly_cli-0.3.0/.env.example

@@ -0,0 +1,17 @@
+# Brandly CLI — Environment Variables
+# Copy this file to .env and fill in your API keys.
+
+# Agnes AI (image + video generation)
+# Get your key from: https://apihub.agnes-ai.com
+AGNES_API_KEY=your_agnes_api_key_here
+AGNES_BASE_URL=https://apihub.agnes-ai.com/v1
+
+# MiniMax (music + TTS + some image/video)
+# Get your key from: https://platform.minimaxi.com
+MINIMAX_API_KEY=your_minimax_api_key_here
+MINIMAX_BASE_URL=https://api.minimaxi.com/v1
+
+# BytePlus Ark (Seedream images + Seedance videos)
+# Get your key from: https://console.volcengine.com/ark
+ARK_API_KEY=your_ark_api_key_here
+ARK_BASE_URL=https://ark.cn-beijing.volces.com/api/v3

brandly_cli-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  push:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install FFmpeg
+        run: sudo apt-get update && sudo apt-get install -y ffmpeg
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Type check
+        run: python -m pytest tests/ -v --tb=short
+
+      - name: Lint
+        run: ruff check src/
+
+      - name: Syntax check
+        run: python -m py_compile src/brandly_cli/*.py

brandly_cli-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/brandly-cli
+    permissions:
+      id-token: write  # OIDC trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: python -m pip install --upgrade build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Release to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

brandly_cli-0.3.0/.gitignore

@@ -0,0 +1,50 @@
+# Brandly CLI — generated project state
+.brandly/
+
+# API keys that may be synced into tool configs
+.env
+**/.env
+!.env.example
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+
+# Virtual environments
+venv/
+env/
+.venv/
+.env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test artifacts
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+
+# Generated skill output
+skills_output/
+
+# Pre-commit
+.pre-commit-cache/

brandly_cli-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  - repo: local
+    hooks:
+      - id: ruff-lint
+        name: ruff-lint
+        entry: python3 -m ruff check src/
+        language: system
+        types: [python]
+        pass_filenames: false
+
+      - id: pytest
+        name: pytest
+        entry: python3 -m pytest tests/ -v --tb=short
+        language: system
+        types: [python]
+        pass_filenames: false
+        always_run: true

brandly_cli-0.3.0/Makefile

@@ -0,0 +1,81 @@
+# Brandly CLI — Makefile
+
+PYTHON   := python3
+PNPM     := pnpm
+PIP      := $(PYTHON) -m pip
+PYTEST   := $(PYTHON) -m pytest
+RUFF     := $(PYTHON) -m ruff
+ROOT     ?= .
+
+.PHONY: help install dev test lint type-check build clean \
+        pre-commit ci e2e upgrade sync
+
+## Show this help
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) \
+		| awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-14s\033[0m %s\n", $$1, $$2}'
+
+## Install package in editable mode + dev deps
+install: ## install
+	$(PIP) install -e ".[dev]"
+
+## Install pre-commit hooks
+pre-commit: ## pre-commit
+	$(PIP) install pre-commit
+	pre-commit install
+
+## Run full test suite
+test: ## test
+	$(PYTEST) tests/ -v --tb=short
+
+## Run tests with coverage
+cov: ## cov
+	$(PYTEST) tests/ -v --tb=short --cov=src/brandly_cli --cov-report=term-missing --cov-report=html
+
+## Run linter
+lint: ## lint
+	$(RUFF) check src/
+
+## Fix lint issues automatically
+lint-fix: ## lint-fix
+	$(RUFF) check src/ --fix
+
+## Syntax check all modules
+check-syntax: ## check-syntax
+	$(PYTHON) -m py_compile src/brandly_cli/*.py
+
+## Run all quality gates (test + lint + syntax)
+ci: check-syntax lint test ## ci
+	@echo "All quality gates passed."
+
+## End-to-end CLI smoke test
+e2e: ## e2e
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ \
+		init --name "Smoke" --idea "test" --style cinematic --shots 3
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ list
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ config
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ estimate --style cinematic --shots 5
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ director > /dev/null
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ models > /dev/null
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ memory view > /dev/null
+	$(PYTHON) -m brandly_cli.cli --root /tmp/brandly-e2e-$$ prompt \
+		--subject "wireless earbuds" --action "rotate" \
+		--environment "desk" --shots 3 --style cinematic > /dev/null
+	rm -rf /tmp/brandly-e2e-*
+	@echo "E2E smoke test passed."
+
+## Upgrade dev dependencies
+upgrade: ## upgrade
+	$(PIP) install --upgrade -e ".[dev]"
+
+## Sync API keys into AI tool configs (requires env vars set)
+sync: ## sync
+	$(PYTHON) -m brandly_cli.cli sync
+
+## Clean build/cache artifacts
+clean: ## clean
+	find src -name '__pycache__' -type d -exec rm -rf {} + 2>/dev/null || true
+	find tests -name '__pycache__' -type d -exec rm -rf {} + 2>/dev/null || true
+	rm -rf .pytest_cache .ruff_cache .mypy_cache htmlcov dist build *.egg-info
+	rm -rf /tmp/brandly-e2e-*
+	@echo "Cleaned."

brandly_cli-0.3.0/PKG-INFO

@@ -0,0 +1,347 @@
+Metadata-Version: 2.5
+Name: brandly-cli
+Version: 0.3.0
+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
+Project-URL: Issues, https://github.com/Dream-Pixels-Forge/brandly-cli/issues
+Author-email: Dream Pixels Forge <contact@dreampixelsforge.com>
+License-Expression: MIT
+Keywords: agent,ai,cli,generation,image,orchestrator,video
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pillow>=10.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 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.
+
+[![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.0 New Features
+
+| Feature | Description |
+|---------|-------------|
+| **Stitch** | Multi-shot video assembly with transitions (fade, dissolve, wipe, slide) 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) |
+| **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 |
+| **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
+# 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:
+
+```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
+# 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
+```
+
+### 3. Generate Media Directly
+
+```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 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
+```
+
+## 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 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
+
+| Command | Description |
+|---------|-------------|
+| `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 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 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 |
+
+### Intelligence
+
+| Command | Description |
+|---------|-------------|
+| `brandly trend <category>` | Research trending video formats |
+| `brandly template list` | List available 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
+
+MIT — Dream Pixels Forge