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
-
Visual Geometry & Bouma Silhouette (
brando.modules.visual): Calculates uppercase/lowercase ascender/descender visual balance. -
Sound Symbolism & Euphony Scorer (
brando.modules.phonetic): Analyzes IPA phonemes, plosive-fricative balance, and acoustic resonance. -
Esoteric Numerology & Nakshatra Padas (
brando.modules.esoteric): Computes Pythagorean, Chaldean, and 108 Nakshatra astrological alignments. -
Trademark & WIPO Vetting Engine (
brando.modules.trademark): Generates 45 Nice Class search URLs and USPTO clash links. -
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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file brando-0.3.0.tar.gz.
File metadata
- Download URL: brando-0.3.0.tar.gz
- Upload date:
- Size: 243.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d878b1524949255ded15dde8cc259db8f8d4b859826385f5a1dd19f8326fd080
|
|
| MD5 |
497b4b9cb09fbb0813edd213daa06668
|
|
| BLAKE2b-256 |
5932f9fc17b6ff452c9d3c3b9e497ad66773a45ddcc1cd4dc9f6296ebee6871c
|
Provenance
The following attestation bundles were made for brando-0.3.0.tar.gz:
Publisher:
publish.yml on mrxsierra/brando
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
brando-0.3.0.tar.gz -
Subject digest:
d878b1524949255ded15dde8cc259db8f8d4b859826385f5a1dd19f8326fd080 - Sigstore transparency entry: 2410279248
- Sigstore integration time:
-
Permalink:
mrxsierra/brando@1430e7b5dca4685b7ba17a6d2c85ea5d0ab50aec -
Branch / Tag:
refs/tags/v0.3.0b1 - Owner: https://github.com/mrxsierra
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1430e7b5dca4685b7ba17a6d2c85ea5d0ab50aec -
Trigger Event:
push
-
Statement type:
File details
Details for the file brando-0.3.0-py3-none-any.whl.
File metadata
- Download URL: brando-0.3.0-py3-none-any.whl
- Upload date:
- Size: 37.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a7f4bc79db648cd75504748e94242985f4b978ba1eeb8162fdf6eaac337a37a
|
|
| MD5 |
4820e1868ce34d58de6f230ba6bde5b9
|
|
| BLAKE2b-256 |
82701ce782b3b2d474ad158fcd52adaab23ad9919ea9a21f8fcb3d4710a2a1c1
|
Provenance
The following attestation bundles were made for brando-0.3.0-py3-none-any.whl:
Publisher:
publish.yml on mrxsierra/brando
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
brando-0.3.0-py3-none-any.whl -
Subject digest:
3a7f4bc79db648cd75504748e94242985f4b978ba1eeb8162fdf6eaac337a37a - Sigstore transparency entry: 2410279292
- Sigstore integration time:
-
Permalink:
mrxsierra/brando@1430e7b5dca4685b7ba17a6d2c85ea5d0ab50aec -
Branch / Tag:
refs/tags/v0.3.0b1 - Owner: https://github.com/mrxsierra
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1430e7b5dca4685b7ba17a6d2c85ea5d0ab50aec -
Trigger Event:
push
-
Statement type: