brando 0.3.0

Systematic brand creation, phonetic euphony scoring, visual geometry analysis, and trademark vetting framework.

Documentation • Quickstart • Python SDK • Architecture • Changelog • PRD Specification

⚡ Installation

Install via pip or uv:

# Using pip
pip install brando

# Using uv (Recommended for ultra-fast performance)
uv add brando

🚀 Quickstart CLI

Initialize your workspace and generate candidate brands in seconds:

# 1. Initialize custom branding configuration wizard
brando init

# 2. Build candidate brand names using Neoclassical & Blend synthesis
brando build --count 50 --output brand_candidates.csv

# 3. Filter candidates by euphony score and visual balance
brando filter --min-score 75 --max-length 7

# 4. Verify USPTO / WIPO trademark URL links and domain clashes
brando verify --input shortlist.csv

# 5. Check social handle availability concurrently across networks
brando check-socials --name mybrand

🐍 Python SDK Usage

Integrate brando programmatically into your Python applications, LLM agents, or naming pipelines:

import brando

# Initialize execution pipeline
pipeline = brando.Pipeline()

# Synthesize and score brand candidates
candidates = pipeline.generate(
    keywords=["cyber", "nexus"], strategies=["neoclassical", "blend"], count=20
)

for brand in candidates:
    print(
        f"Name: {brand.name:<12} Euphony: {brand.euphony_score:.2f} Visual: {brand.visual_score:.2f}"
    )

🔬 Core 5-Module Feature Architecture

1. Visual Geometry & Bouma Silhouette (brando.modules.visual): Calculates uppercase/lowercase ascender/descender visual balance.

2. Sound Symbolism & Euphony Scorer (brando.modules.phonetic): Analyzes IPA phonemes, plosive-fricative balance, and acoustic resonance.

3. Esoteric Numerology & Nakshatra Padas (brando.modules.esoteric): Computes Pythagorean, Chaldean, and 108 Nakshatra astrological alignments.

4. Trademark & WIPO Vetting Engine (brando.modules.trademark): Generates 45 Nice Class search URLs and USPTO clash links.

5. Security & Typosquatting Engine (brando.modules.security): Executes sub-35ms RapidFuzz SIMD and BK-Tree metric space search against top 1,000 brand registries.

📄 License & Attribution

Dual-licensed under the MIT License (for individual developers, non-commercial research, and open-source contributions) and Fair-Source Terms (for enterprise SaaS platforms). See LICENSE for full details.