brandmint

name	brandmint
description	End-to-end brand identity orchestration system. Generates text strategy, visual assets, campaign copy, video deliverables, and publishing outputs using 44 specialized skills across 9 categories. Chains FAL.AI/Nano Banana/Flux visual generation with brand positioning, buyer personas, and campaign workflows via wave-based execution. Includes Remotion-based programmatic video generation.

Brandmint

Orchestrated brand identity system that transforms a brand definition into comprehensive marketing outputs — from strategic text documents through AI-generated visual assets to video deliverables and published documentation sites.

Architecture Overview

brand-config.yaml
       ↓
┌─────────────┐     ┌───────────────────┐
│ Wave Planner│←────│Scenario Recommender│
└──────┬──────┘     └───────────────────┘
       ↓
   Waves 1→6
       ↓
   Skills Registry (44 skills, 9 categories)
       ↓
   Hydrator (feeds outputs → config)
       ↓
   Visual Pipeline (FAL.AI assets)
       ↓
   Publishing Pipeline (Wave 7: theme, NotebookLM, decks, reports, diagrams, video)
       ↓
   Wiki → Astro Site

Prerequisites

• Python 3.10+ with uv package manager
• FAL_KEY in ~/.claude/.env
• Dependencies: python-dotenv, fal-client, requests, pyyaml
• Bun (for Astro wiki publishing)
• Node.js >= 18 (for Remotion video rendering)

uv venv .venv && source .venv/bin/activate
uv pip install python-dotenv fal-client requests pyyaml

CLI Commands

# Main entry points (both work)
brandmint [command]
bm [command]

# Global flags (available on all commands)
bm --verbose launch ...   
bm --debug launch ...     
bm --quiet launch ...     


bm launch --config brand-config.yaml --scenario crowdfunding-lean --waves 1-3
bm launch --config brand-config.yaml --max-cost 5.00     
bm launch --config brand-config.yaml --resume-from 3      


bm visual generate --config brand-config.yaml           
bm visual execute --config brand-config.yaml --batch anchor     
bm visual execute --config brand-config.yaml --batch identity   
bm visual execute --config brand-config.yaml --batch all        
bm visual execute --config brand-config.yaml --force            
bm visual verify --config brand-config.yaml             


bm report --config brand-config.yaml                    
bm report --config brand-config.yaml --format json      
bm report --config brand-config.yaml --format html -o report.html


bm cache stats                                          
bm cache clear                                          
bm cache clear --expired                                


bm plan context --config brand-config.yaml
bm plan recommend --config brand-config.yaml


bm install skills    
bm install check     
bm registry list